Modifica los recursos de App Hub en las carpetas habilitadas para apps

Puedes enumerar, ver, actualizar y borrar recursos de App Hub en una carpeta habilitada para apps con la consola de Google Cloud o Google Cloud CLI en la terminal o en Cloud Shell.

Requisitos previos

Antes de modificar los recursos de App Hub, completa las siguientes tareas:

  1. Sigue los requisitos previos para configurar App Hub.
  2. Según el tipo de recurso que deseas modificar, asegúrate de haber ejecutado los pasos para configurar App Hub. Para obtener más información, consulta Cómo configurar App Hub.

Roles obligatorios

Para obtener los permisos que necesitas para modificar los recursos de App Hub, pídele a tu administrador que te otorgue los siguientes roles de IAM en la carpeta habilitada para apps:

  • Para crear y actualizar aplicaciones, registrar y cancelar el registro de servicios y cargas de trabajo, y actualizar los atributos asociados, haz lo siguiente:
  • Para ver las aplicaciones, los servicios y las cargas de trabajo, y sus atributos, usa el Visualizador de App Hub (roles/apphub.viewer).
  • Para ver las aplicaciones, los servicios y las cargas de trabajo, y sus atributos en Google Cloud servicios que admiten la administración de aplicaciones: Visualizador de administración de App Hub (roles/apphub.appManagementViewer)

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 mediante roles personalizados o cualquier otro rol predefinido.

Cómo enumerar aplicaciones

Puedes enumerar y filtrar aplicaciones en una carpeta habilitada para apps.

Console

  1. Para ver las aplicaciones en una carpeta habilitada para apps, en la consola de Google Cloud, ve a la página Aplicaciones de App Hub.

    Ir a Aplicaciones

    Verás una lista de aplicaciones.

  2. Para filtrar aplicaciones, haz lo siguiente:

    1. En el campo Filtro, selecciona un filtro, como Gravedad.
    2. Especifica un valor para el filtro. Por ejemplo, para mostrar aplicaciones con alta criticidad, selecciona Alta como valor.
      Aparecerá una lista de aplicaciones que coincidan con el filtro especificado.

gcloud

  1. Para ver las aplicaciones en una carpeta habilitada para apps, haz lo siguiente:

    gcloud apphub applications list \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Reemplaza lo siguiente:

    • MANAGEMENT_PROJECT_ID: Es el ID de tu proyecto de administración. Puedes encontrar el ID de tu proyecto de administración en la página Configuración de Identity and Access Management (IAM) y administración de la consola de Google Cloud. Si no encuentras el ID del proyecto de administración, es posible que no estés en una carpeta habilitada para la app. En el selector de alcance (o selector de proyectos), selecciona tu carpeta habilitada para apps. Para obtener más información sobre cómo habilitar una carpeta para la administración de aplicaciones, consulta Habilita la administración de aplicaciones.
    • REGION: Es la región de la aplicación. Según el --scope-type de la aplicación, asígnale el valor global o la región de la aplicación, por ejemplo, us-east1. Para obtener más información sobre cómo configurar el --scope-type de la aplicación, consulta Cómo crear una aplicación.
  2. Para filtrar las aplicaciones según los atributos de las variables, usa la marca --filter. Por ejemplo, para enumerar todas las aplicaciones en las que el atributo environment-type está configurado como PRODUCTION, haz lo siguiente:

    gcloud apphub applications list \
        --filter='attributes.environment.type=PRODUCTION' \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Cómo ver una solicitud

Puedes describir una aplicación en una carpeta habilitada para apps.

Console

  1. En la consola de Google Cloud, ve a la página Aplicaciones de App Hub.

    Ir a Aplicaciones

  2. En la lista de aplicaciones, haz clic en la aplicación cuyos detalles deseas conocer.

  3. Haz clic en la pestaña Detalles para mostrar los detalles de la solicitud.

gcloud

gcloud apphub applications describe APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

Reemplaza APPLICATION_NAME por el nombre de la aplicación. El nombre solo debe incluir caracteres alfanuméricos en minúscula sin espacios.

Cómo actualizar una aplicación de App Hub

Puedes actualizar los atributos de tu aplicación después de crearla.

Console

  1. En la consola de Google Cloud, ve a la página Aplicaciones de App Hub.

    Ir a Aplicaciones

  2. En la lista de aplicaciones, haz clic en Editar para la aplicación que quieres actualizar.

  3. Edita los campos según sea necesario.

  4. Haz clic en Guardar.

gcloud

  1. Actualiza tu aplicación con los atributos criticality-type, environment-type y tipo de propietario:

    gcloud apphub applications update APPLICATION_NAME \
        --display-name='APPLICATION_DISPLAY_NAME' \
        --criticality-type='CRITICALITY_LEVEL' \
        --environment-type='ENVIRONMENT' \
        --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
        --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
        --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Reemplaza lo siguiente:

    • APPLICATION_NAME: El nombre de tu aplicación. El nombre solo debe incluir caracteres alfanuméricos en minúsculas sin espacios.
    • REGION: Es la región de la aplicación.

    Puedes actualizar cualquiera de las siguientes opciones:

    • APPLICATION_DISPLAY_NAME: Indica el nombre visible de la aplicación.
    • CRITICALITY_LEVEL: Indica qué tan importante es una aplicación, un servicio o una carga de trabajo para las operaciones de tu empresa. Proporciona uno de los siguientes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: Indica las etapas del ciclo de vida del software. Proporciona uno de los siguientes valores:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR y DISPLAY-NAME-BUSINESS: Son los nombres visibles del desarrollador, el operador y los propietarios de la empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR y EMAIL-NAME-BUSINESS: direcciones de correo electrónico del desarrollador, el operador y los propietarios de la empresa, respectivamente. Estos valores deben tener el formato username@yourdomain, por ejemplo, 222larabrown@gmail.com.

    Por ejemplo:

    gcloud apphub applications update my-application \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --project=google-mpf-FOLDER-ID \
        --location=us-east1
    

Cómo ver servicios y cargas de trabajo

Puedes ver, enumerar y filtrar servicios y cargas de trabajo en una aplicación.

Console

  1. Para enumerar los servicios y las cargas de trabajo, haz lo siguiente:

    1. En la consola de Google Cloud, ve a la página Servicios y cargas de trabajo de App Hub.

      Ir a Servicios y cargas de trabajo

    2. En la lista Región, selecciona las regiones desde las que deseas ver los servicios y las cargas de trabajo. Por ejemplo, selecciona us-east1.
      En la página Servicios y cargas de trabajo, se muestran todos los servicios y las cargas de trabajo de los proyectos de servicio adjuntos asociados con us-east1.

  2. Para filtrar los servicios o las cargas de trabajo, haz lo siguiente:

    1. En el campo Filtro, selecciona un filtro, como Entorno.
    2. Especifica un valor para el filtro. Por ejemplo, para ver los servicios y las cargas de trabajo en producción, selecciona Producción como valor.
      Aparecerá una lista de servicios y cargas de trabajo que coinciden con el filtro especificado.

gcloud

Cómo enumerar los servicios descubiertos

Los servicios descubiertos están disponibles para registrarse en una aplicación.

  1. Para enumerar los servicios descubiertos, haz lo siguiente:

    gcloud apphub discovered-services list \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION

    Verás un resultado similar al siguiente:

    ID                      SERVICE_REFERENCE                                                                                                                   SERVICE_PROPERTIES
    [DISCOVERED_SERVICE_ID] {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
    
  2. Opcional: Filtra la lista de servicios descubiertos. Por ejemplo, parafiltrar los servicios descubiertos con reglas de reenvío en lacarpeta habilitada para la app, haz lo siguiente:

    gcloud apphub discovered-services list \
        --filter='service_reference.uri~"forwardingRules"' \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION

Enumera los servicios registrados

Muestra una lista de los servicios registrados de App Hub y fíltralos desde una aplicación.

  1. Para enumerar los servicios registrados en una aplicación, sigue estos pasos:

    gcloud apphub applications services list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Verás un resultado similar al siguiente:

    ID             DISPLAY_NAME            SERVICE_REFERENCE                                                                                                                CREATE_TIME
    SERVICE_NAME   mywebserver-service1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule'}   2023-11-01T21:38:08
    

    Los servicios registrados, pero separados, se indican con un valor vacío en el campo SERVICE_REFERENCE.

  2. Opcional: Filtra la lista de servicios registrados. Por ejemplo, para filtrar los servicios registrados en una aplicación en la que el atributo environment-type se establece en PRODUCTION, haz lo siguiente:

    gcloud apphub applications services list \
        --filter='attributes.environment.type=PRODUCTION' \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Cómo enumerar las cargas de trabajo descubiertas

Las cargas de trabajo descubiertas están disponibles para registrarse en una aplicación.

  1. Para enumerar las cargas de trabajo descubiertas, sigue estos pasos:

    gcloud apphub discovered-workloads list \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Verás un resultado similar al siguiente, que incluye MIG no registradas:

    ID                        WORKLOAD_REFERENCE                                                                                                   WORKLOAD_PROPERTIES
    [DISCOVERED_WORKLOAD_ID]  {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
    
  2. Opcional: Filtra la lista de cargas de trabajo descubiertas. Por ejemplo, para filtrar la lista de cargas de trabajo descubiertas con recursos de procesamiento en una carpeta habilitada para apps, haz lo siguiente:

    gcloud apphub discovered-workloads list \
        --filter='workload_reference.uri~"compute"'
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Cómo enumerar las cargas de trabajo registradas

Enumera y filtra las cargas de trabajo registradas de App Hub desde una aplicación.

  1. Para enumerar las cargas de trabajo registradas en una aplicación, sigue estos pasos:

    gcloud apphub applications workloads list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Verás un resultado similar al siguiente:

    ID               DISPLAY_NAME               WORKLOAD_REFERENCE                                                                                                     CREATE_TIME
    WORKLOAD_NAME    mywebserver-deployment1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    2023-10-31T18:34:23
    

    Las cargas de trabajo registradas, pero separadas, se indican con un valor vacío en el campo WORKLOAD_REFERENCE. Para obtener más información sobre los estados de registro, consulta las propiedades y los atributos de App Hub.

  2. Opcional: Filtra la lista de cargas de trabajo registradas. Por ejemplo, para filtrar las cargas de trabajo en una aplicación en la que el atributo environment-type se establece en PRODUCTION, haz lo siguiente:

    gcloud apphub applications workloads list \
        --filter='attributes.environment.type=PRODUCTION' \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Actualiza los servicios y las cargas de trabajo

Puedes actualizar los servicios y las cargas de trabajo que están registrados en una aplicación.

Console

  1. En la consola de Google Cloud, ve a la página Aplicaciones de App Hub.

    Ir a Aplicaciones

  2. Haz clic en el nombre de tu aplicación.
    En la pestaña Servicios y cargas de trabajo, se muestra una lista de los servicios y las cargas de trabajo registrados que se encuentran en tus proyectos de servicio.

  3. Para cada servicio o carga de trabajo que quieras actualizar, haz lo siguiente:

    1. En la pestaña Servicios y cargas de trabajo, haz clic en more_vert para el servicio o la carga de trabajo que deseas actualizar y, luego, en Editar servicio o Editar carga de trabajo.
    2. En el panel Editar servicio o Editar carga de trabajo, edita los campos según sea necesario y haz clic en Guardar.

gcloud

  1. Actualiza tu servicio con los atributos criticality-type, environment-type y tipo de propietario:

    gcloud apphub applications services update SERVICE_NAME \
        --application=APPLICATION_NAME \
        --display-name='SERVICE_DISPLAY_NAME' \
        --criticality-type='CRITICALITY_LEVEL' \
        --environment-type='ENVIRONMENT' \
        --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
        --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
        --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Reemplaza SERVICE_NAME por un nombre del servicio de App Hub.

    Puedes actualizar cualquiera de las siguientes opciones:

    • SERVICE_DISPLAY_NAME: Indica un nombre visible para el servicio.
    • CRITICALITY_LEVEL: Indica qué tan importante es una aplicación, un servicio o una carga de trabajo para las operaciones de tu empresa. Proporciona uno de los siguientes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: Indica las etapas del ciclo de vida del software. Proporciona uno de los siguientes valores:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR y DISPLAY-NAME-BUSINESS: Son los nombres visibles del desarrollador, el operador y los propietarios de la empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR y EMAIL-NAME-BUSINESS: direcciones de correo electrónico del desarrollador, el operador y los propietarios de la empresa, respectivamente. Estos valores deben tener el formato username@yourdomain, por ejemplo, 222larabrown@gmail.com.

    Por ejemplo:

    gcloud apphub applications workloads update my-application \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --project=google-mpf-FOLDER-ID \
        --location=us-east1
    
  2. Actualiza tu carga de trabajo con los atributos criticality-type, environment-type y tipo de propietario:

    gcloud apphub applications workloads update WORKLOAD_NAME \
        --application=APPLICATION_NAME \
        --display-name='WORKLOAD_DISPLAY_NAME' \
        --criticality-type='CRITICALITY_LEVEL' \
        --environment-type='ENVIRONMENT' \
        --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
        --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
        --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Reemplaza WORKLOAD_NAME por el nombre de la carga de trabajo de App Hub.

    Puedes actualizar cualquiera de las siguientes opciones:

    • WORKLOAD_DISPLAY_NAME: Indica un nombre visible para el servicio.
    • CRITICALITY_LEVEL: Indica qué tan importante es una aplicación, un servicio o una carga de trabajo para las operaciones de tu empresa. Proporciona uno de los siguientes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: Indica las etapas del ciclo de vida del software. Proporciona uno de los siguientes valores:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR y DISPLAY-NAME-BUSINESS: Son los nombres visibles del desarrollador, el operador y los propietarios de la empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR y EMAIL-NAME-BUSINESS: direcciones de correo electrónico del desarrollador, el operador y los propietarios de la empresa, respectivamente. Estos valores deben tener el formato username@yourdomain, por ejemplo, 222larabrown@gmail.com.

    Por ejemplo:

    gcloud apphub applications workloads update my-application \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --project=google-mpf-FOLDER-ID \
        --location=us-east1
    

Borra aplicaciones, servicios y cargas de trabajo

Borra una aplicación existente para quitar los recursos registrados asociados con la carpeta habilitada para la app. Para ello, primero debes cancelar el registro de las cargas de trabajo y los servicios registrados en la aplicación.

Console

  1. En la consola de Google Cloud, ve a la página Aplicaciones de App Hub.

    Ir a Aplicaciones

  2. Haz clic en el nombre de una aplicación. Aparecerá una lista de los servicios y las cargas de trabajo registrados en la aplicación.

  3. Cancelar el registro de un servicio o una carga de trabajo

    1. En la pestaña Servicios y cargas de trabajo, en la sección Servicios y cargas de trabajo registrados, haz clic en el nombre del servicio o la carga de trabajo que deseas anular el registro.
    2. En la página del servicio o la carga de trabajo registrada que se abre, haz clic en Desregistrar para actualizar el servicio o la carga de trabajo como un recurso Desconocido. En la pestaña Servicios y cargas de trabajo, una alerta notifica que la carga de trabajo no está registrada.
    3. Repite estas instrucciones para cada servicio y carga de trabajo.
  4. Ve a la página Aplicaciones de App Hub.

    Ir a Aplicaciones

  5. Haz clic en el nombre de una aplicación.

  6. En la página con los detalles de la solicitud, haz clic en Borrar.

gcloud

  1. Muestra una lista de los servicios registrados en la aplicación:

    gcloud apphub applications services list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    
  2. Cancela el registro del servicio de la aplicación:

    gcloud apphub applications services delete SERVICE_NAME \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    El servicio ahora es un servicio descubierto que se puede registrar en la aplicación.

  3. Repite el comando anterior para anular el registro de los servicios registrados que queden en la aplicación.

  4. Enumera las cargas de trabajo registradas en la aplicación:

    gcloud apphub applications workloads list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    
  5. Cancela el registro de la carga de trabajo de la aplicación:

    gcloud apphub applications workloads delete WORKLOAD_NAME \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    La carga de trabajo ahora es una carga de trabajo descubierta que se puede registrar en la aplicación.

  6. Repite el comando anterior para borrar las cargas de trabajo registradas que queden de la aplicación.

  7. Borra la aplicación:

    gcloud apphub applications delete APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

¿Qué sigue?