Administra aplicaciones de App Hub

Cuando eliges el modelo de configuración de tu aplicación, defines un límite de administración de aplicaciones para tus aplicaciones de App Hub en un proyecto de administración. Luego, puedes registrar servicios y cargas de trabajo en 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 de aplicaciones. Para crear una aplicación y registrar recursos, consulta Registra recursos existentes en una aplicación.

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:

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

Antes de comenzar

En este documento, se supone que tienes una aplicación con recursos compatibles 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.

Enumerar 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 Google Cloud consola de, 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. Muestra una lista de tus aplicaciones con una de las siguientes opciones:

    • Obtenga una lista de 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 las aplicaciones globales o una región específica, como us-east1, para las aplicaciones regionales.

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

      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 las aplicaciones globales o una región específica, como us-east1, para las 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 aplicación

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

Console

  1. En la Google Cloud consola de, 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: Es el nombre de tu aplicación. Especificas este valor cuando lo crees.
    • PROJECT_ID: Es el ID de tu proyecto de administración.
    • LOCATION: Es la ubicación de tu aplicación. Usa global para las aplicaciones globales o una región específica, como us-east1, para las aplicaciones regionales.

Actualizar atributos de la aplicación

Para modificar los atributos de una aplicación después de que se creó, sigue estos pasos. Los servicios y las cargas de trabajo también pueden usar los mismos atributos de la aplicación durante el registro.

Console

  1. En la Google Cloud consola de, 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 la aplicación que deseas 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: Es el nombre de tu aplicación. Especificas este valor cuando lo crees.
    • 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 las aplicaciones globales o una región específica, como us-east1, para las 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: Son el nombre visible y la dirección de correo electrónico del propietario desarrollador, respectivamente.

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

    • Opcional: BUSINESS_NAME y BUSINESS_EMAIL: Son 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 google_apphub_application bloque de recursos en tu archivo de configuración. Cuando aplicas los cambios, Terraform actualiza la aplicación para que coincida con la configuración nueva.

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
    }
}

Borrar una aplicación

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

Console

  1. En la Google Cloud consola de, 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 Anula el registro de servicios y cargas de trabajo.

  5. Una vez que se anule el registro de todos los servicios y las 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 Anula el registro de servicios y cargas de trabajo.

  3. Una vez 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: Es el nombre de tu aplicación. Especificas este valor cuando lo crees.
    • PROJECT_ID: Es el ID de tu proyecto de administración.
    • LOCATION: Es la ubicación de tu aplicación. Usa global para las aplicaciones globales o una región específica, como us-east1, para las aplicaciones regionales.

Terraform

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

  • Quita el recurso de tu configuración: Borra el recurso bloque de tu archivo de Terraform y, luego, ejecuta terraform apply.google_apphub_application 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 administrados por tu configuración de Terraform, incluida la aplicación.

¿Qué sigue?