Administra aplicaciones de App Hub

App Hub te permite ver tus aplicaciones registradas, actualizar sus atributos y borrar aplicaciones para que puedas mantener tu inventario de aplicaciones preciso. Para evitar el desvío de la configuración, usa App Hub solo para actualizar o borrar las aplicaciones que registraste directamente y administra las aplicaciones basadas en plantillas en Application Design Center.

Descripción general

Cuando eliges el modelo de configuración de la 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 el desvío de configuración y mantener una fuente de información clara, te recomendamos que administres los componentes de la 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 parámetros de configuración, como los detalles de la aplicación y de los componentes.

    Ir a Application Design Center

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

    Ir a App Hub

En App Hub, puedes realizar estas acciones con la consola deGoogle Cloud 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 el Concentrador de aplicaciones, 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 aplicaciones :

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 las aplicaciones

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

Console

  1. En la consola de Google Cloud , usa el selector de proyectos para elegir 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 Nivel de importancia o Entorno.

gcloud

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

  2. Muestra una lista de tus aplicaciones con 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, una multirregión (us o eu) para aplicaciones multirregionales 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, una multirregión (us o eu) para aplicaciones multirregionales 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 elegir 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 quieres ver.

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

gcloud

  1. Busca 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 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, una multirregión (us o eu) para aplicaciones multirregionales 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 crearla, 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 consola de Google Cloud , usa el selector de proyectos para elegir 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 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. Busca el ID del proyecto de tu proyecto de administración.

  2. Actualizar 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 creas una aplicación.
    • Obligatorio: PROJECT_ID: el ID de tu proyecto de administración.
    • Obligatorio: LOCATION es la ubicación de tu aplicación. Usa global para aplicaciones globales, una multirregión (us o eu) para aplicaciones multirregionales 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 del 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 configuración nueva.

En el siguiente ejemplo, se actualizan los atributos de importancia 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
    }
}

Borra 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 elegir 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 quieres borrar.

  4. Ve a la pestaña Servicios y cargas de trabajo y asegúrate de haber cancelado 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. Después de cancelar 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. Busca el ID del proyecto de tu proyecto de administración.

  2. Asegúrate de haber cancelado 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 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, una multirregión (us o eu) para aplicaciones multirregionales o una región específica, como us-east1, para aplicaciones regionales.

Terraform

Para borrar una aplicación que administra Terraform, tienes las siguientes opciones:

  • Quita el recurso de tu configuración: Borra el bloque de recursos 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?