Administra aplicaciones de App Hub

Cuando eliges tu modelo de configuración de la aplicación, defines un límite de administración de la aplicación para tus aplicaciones de App Hub en un proyecto de administración. Luego, puedes registrar servicios y cargas de trabajo en las aplicaciones dentro de este límite. Para conocer los casos de uso recomendados para introducir prácticas de administración de aplicaciones, consulta Prepárate para la administración del ciclo de vida de las aplicaciones.

Para evitar la desviación de la configuración y mantener una fuente de información clara, te recomendamos que administres los componentes de tu aplicación en el entorno en el que se definieron originalmente:

  • Para las aplicaciones implementadas desde una plantilla de Application Design Center: Usa Application Design Center para administrar y actualizar la aplicación. Puedes revisar la plantilla para realizar cambios en el diseño de la aplicación o crear una revisión de la aplicación para actualizar la configuración, como los detalles de la aplicación y los componentes.

    Ir a Application Design Center

  • Para las aplicaciones creadas registrando recursos existentes en App Hub: Administra las aplicaciones, los servicios y las cargas de trabajo directamente en App Hub.

    Ir a App Hub

En esta página, se describe cómo administrar las aplicaciones que se registraron directamente en App Hub. Puedes realizar estas acciones con laGoogle Cloud consola o Google Cloud CLI. Para las aplicaciones implementadas desde una plantilla, consulta la documentación de App Design Center.

Antes de comenzar

En este documento, se supone que tienes una aplicación con recursos admitidos registrados en ella.

Roles obligatorios

Para obtener los permisos que necesitas para administrar aplicaciones en App Hub, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto de administración que define el límite de administración de tu aplicación:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para obtener más información sobre los roles de App Hub, consulta Roles y permisos de IAM de App Hub.

Enumera aplicaciones

Sigue estos pasos para enumerar y filtrar todas las aplicaciones dentro del límite de administración de tu aplicación:

Console

  1. En la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración.

  2. Navega a la página Aplicaciones desde App Hub:

    Ir a Aplicaciones

    En la página, se muestra una lista de tus aplicaciones.

  3. Para filtrar la lista, usa el campo Filtro. Puedes filtrar por atributos como Criticidad o Entorno.

gcloud

  1. Encuentra el ID del proyecto de tu proyecto de administración.

  2. Para mostrar una lista de tus aplicaciones, usa una de las siguientes opciones:

    • Enumera todas las aplicaciones:

      gcloud apphub applications list \
    --project=PROJECT_ID \
    --location=LOCATION

      Reemplaza lo siguiente:

      • PROJECT_ID: Es el ID de tu proyecto de administración.
      • LOCATION: Es la ubicación de tus aplicaciones. Usa global para aplicaciones globales o una región específica, como us-east1, para aplicaciones regionales.

    • Filtra la lista de aplicaciones según los atributos con la marca --filter:

      gcloud apphub applications list \
    --project=PROJECT_ID \
    --location=LOCATION \
    --filter=FILTER_EXPRESSION \

      Reemplaza lo siguiente:

      • PROJECT_ID: Es el ID de tu proyecto de administración.
      • LOCATION: Es la ubicación de tus aplicaciones. Usa global para aplicaciones globales o una región específica, como us-east1, para aplicaciones regionales.
      • FILTER_EXPRESSION: Es la expresión de filtro para especificar atributos. Por ejemplo, para enumerar todas las aplicaciones con un tipo de entorno PRODUCTION, usa attributes.environment.type=PRODUCTION.

Ver detalles de la solicitud

Sigue estos pasos para ver la información detallada de una aplicación específica, incluidos sus atributos y metadatos:

Console

  1. En la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración.

  2. Navega a la página Aplicaciones desde App Hub:

    Ir a Aplicaciones

    En la página, se muestra una lista de tus aplicaciones.

  3. Haz clic en el nombre de la aplicación que deseas ver.

    Se muestra la pestaña Detalles de la aplicación.

gcloud

  1. Encuentra el ID del proyecto de tu proyecto de administración.

  2. Describe una aplicación:

    gcloud apphub applications describe APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION

    Reemplaza lo siguiente:

    • APPLICATION_NAME: El nombre de tu aplicación. Especificas este valor cuando creas una aplicación.
    • PROJECT_ID: Es el ID de tu proyecto de administración.
    • LOCATION: Es la ubicación de tu aplicación. Usa global para aplicaciones globales o una región específica, como us-east1, para aplicaciones regionales.

Actualiza los atributos de la aplicación

Para modificar los atributos de una aplicación después de que se haya creado, sigue estos pasos:

Console

  1. En la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración.

  2. Navega a la página Aplicaciones desde App Hub:

    Ir a Aplicaciones

    En la página, se muestra una lista de tus aplicaciones.

  3. En la aplicación que quieras actualizar, haz clic en Editar.

  4. En el panel Editar aplicación, modifica los campos según sea necesario.

  5. Haz clic en Guardar.

gcloud

  1. Encuentra el ID del proyecto de tu proyecto de administración.

  2. Actualiza los atributos de la aplicación. Puedes actualizar cualquiera de los atributos mutables, como display-name, criticality-type, environment-type y los propietarios:

    gcloud apphub applications update APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --display-name=DISPLAY_NAME \
    --criticality-type=CRITICALITY_LEVEL \
    --environment-type=ENVIRONMENT \
    --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
    --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
    --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL

    Reemplaza lo siguiente:

    • Obligatorio: APPLICATION_NAME: El nombre de tu aplicación. Especificas este valor cuando creas una aplicación.
    • Obligatorio: PROJECT_ID es el ID de tu proyecto de administración.
    • Obligatorio: LOCATION: Es la ubicación de tu aplicación. Usa global para aplicaciones globales o una región específica, como us-east1, para aplicaciones regionales.
    • Opcional: DISPLAY_NAME: Es el nombre visible de tu aplicación.

    • Opcional: CRITICALITY_LEVEL: Es el nivel de importancia de la aplicación. Usa uno de los siguientes valores:

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW

    • Opcional: ENVIRONMENT es la etapa del ciclo de vida del software. Usa uno de los siguientes valores:

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST

    • Opcional: DEV_NAME y DEV_EMAIL: El nombre visible y la dirección de correo electrónico del propietario desarrollador, respectivamente.

    • Opcional: OPERATOR_NAME y OPERATOR_EMAIL: El nombre visible y la dirección de correo electrónico del propietario del operador, respectivamente.

    • Opcional: BUSINESS_NAME y BUSINESS_EMAIL: El nombre visible y la dirección de correo electrónico del propietario de la empresa, respectivamente.

Terraform

Para actualizar los atributos de la aplicación con Terraform, modifica los argumentos dentro del bloque del recurso google_apphub_application en tu archivo de configuración. Cuando aplicas los cambios, Terraform actualiza la aplicación para que coincida con la nueva configuración.

En el siguiente ejemplo, se actualizan los atributos de criticidad y entorno de una aplicación regional en us-central1:

resource "google_apphub_application" "example" {
    project        = "my-project-id"
    location       = "us-central1"
    application_id = "my-application"
    display_name   = "My Application"
    description    = "This application represents our platform."
    attributes {
        criticality {
            type = "HIGH" # Updated criticality
        }
        environment {
            type = "PRODUCTION"
        }
        # ... other attributes
    }
}

Cómo borrar una aplicación

Antes de borrar una aplicación, primero debes cancelar el registro de todos sus servicios y cargas de trabajo. Luego, sigue estos pasos para borrar la aplicación:

Console

  1. En la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración.

  2. Navega a la página Aplicaciones desde App Hub:

    Ir a Aplicaciones

    En la página, se muestra una lista de tus aplicaciones.

  3. Haz clic en el nombre de la aplicación que deseas borrar.

  4. Ve a la pestaña Servicios y cargas de trabajo y asegúrate de haber anulado el registro de todos los componentes de la aplicación. Para obtener más información, consulta Cómo anular el registro de servicios y cargas de trabajo.

  5. Después de anular el registro de todos los servicios y cargas de trabajo, vuelve a los detalles de la aplicación y haz clic en Borrar.

gcloud

  1. Encuentra el ID del proyecto de tu proyecto de administración.

  2. Asegúrate de haber anulado el registro de todos los componentes de la aplicación. Para obtener más información, consulta Cómo anular el registro de servicios y cargas de trabajo.

  3. Después de que la aplicación no tenga componentes registrados, bórrala:

    gcloud apphub applications delete APPLICATION_NAME \
    --project=PROJECT_ID \
    --location=LOCATION

    Reemplaza lo siguiente:

    • APPLICATION_NAME: El nombre de tu aplicación. Especificas este valor cuando creas una aplicación.
    • PROJECT_ID: Es el ID de tu proyecto de administración.
    • LOCATION: Es la ubicación de tu aplicación. Usa global para aplicaciones globales o una región específica, como us-east1, para aplicaciones regionales.

Terraform

Para borrar una aplicación administrada por Terraform, tienes las siguientes opciones:

  • Quita el recurso de tu configuración: Borra el bloque del recurso google_apphub_application de tu archivo de Terraform y, luego, ejecuta terraform apply. Terraform reconoce que el recurso ya no está en la configuración y lo borra de tu proyecto.
  • Finaliza todos los recursos: Ejecuta el comando terraform destroy para finalizar todos los recursos que administra tu configuración de Terraform, incluida la aplicación.

¿Qué sigue?