Administra aplicaciones de App Hub

Cuando configuras App Hub, creas un límite administrativo para tus aplicaciones. Este límite es el proyecto de administración o la colección de proyectos host y de servicio que configuraste para la administración de aplicaciones, según tu modelo de configuración. Los servicios y las cargas de trabajo se registran como aplicaciones dentro de este límite administrativo.

Para evitar la desviación de la configuración y mantener una fuente de confianza clara, te recomendamos que administres los recursos 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 en App Hub: Administra la aplicación, sus servicios y 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 la Google Cloud consola o Google Cloud CLI. Para las aplicaciones implementadas desde una plantilla, consulta la documentación de App Design Center.

Antes de comenzar

Antes de poder enumerar, ver, actualizar y borrar aplicaciones en App Hub, completa los siguientes pasos:

  1. Configura App Hub con uno de los modelos de configuración admitidos.
  2. Crea una aplicación y registra los recursos compatibles en la aplicación que deseas administrar.

Roles requeridos

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 límite administrativo de la aplicación de tu modelo de configuración (el proyecto de administración o los proyectos host y de servicio) :

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 administrativo de tu App Hub:

Console

  1. En la página Welcome de la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración o proyecto host:

    Ir a Bienvenida

  2. Navega a la página Aplicaciones de 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 o proyecto host.

  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 host o 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 host o 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 página Welcome de la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración o proyecto host:

    Ir a Bienvenida

  2. Navega a la página Aplicaciones de 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 o proyecto host.

  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 host o 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

Sigue estos pasos para modificar los atributos definidos por el usuario de una aplicación después de que se haya creado:

Console

  1. En la página Welcome de la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración o proyecto host:

    Ir a Bienvenida

  2. Navega a la página Aplicaciones de 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 o proyecto host.

  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: ID de tu proyecto host o 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.

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 asociados. Luego, sigue estos pasos para borrar la aplicación:

Console

  1. En la página Welcome de la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración o proyecto host:

    Ir a Bienvenida

  2. Navega a la página Aplicaciones de 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 recursos asociados 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 o proyecto host.

  2. Asegúrate de haber anulado el registro de todos los recursos asociados a 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 recursos 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 host o 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.

¿Qué sigue?