Configura App Hub

Console

1. En la consola de Google Cloud, ve a la página del selector de proyectos.

   Ir al selector de proyectos

2. Selecciona o crea un proyecto de Google Cloud que será el proyecto host de App Hub.

3. Enable the required API.

   Enable the API

4. Si eres el creador del proyecto, se te otorga el rol de propietario básico (roles/owner). De forma predeterminada, este rol de IAM incluye los permisos necesarios para obtener acceso completo a la mayoría de los recursos de Google Cloud.

   Si no eres el creador del proyecto, se deben otorgar los permisos necesarios en el proyecto a la principal correspondiente. Por ejemplo, una principal puede ser una Cuenta de Google (para usuarios finales) o una cuenta de servicio (para aplicaciones y cargas de trabajo de procesamiento). Para obtener los permisos que necesitas para completar este instructivo, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

   1. En la consola de Google Cloud, ve a la página IAM.

      Ir a IAM

   2. Haz clic en person_addOtorgar acceso. Se abrirá el panel Otorgar acceso.

   3. En el campo Principales nuevas, ingresa la dirección de correo electrónico de la persona que administrará App Hub, el rol de administrador de App Hub en el proyecto host.

   4. Haz clic en Seleccionar un rol y, en el campo Filtro, ingresa App Hub.

   5. Selecciona el rol de administrador de App Hub y haz clic en Guardar.

   6. En cada uno de los proyectos de servicio de App Hub, otorga el rol de administrador de App Hub al mismo usuario.

5. En la consola de Google Cloud, ve a la página Configuración de App Hub.

   Ir a la configuración

6. En la página Configuración, haz clic en Vincular proyectos.

7. Realiza una de las siguientes acciones:

   • En la lista de proyectos, selecciona las casillas de verificación de los proyectos que deseas agregar como proyectos de servicio.
   • Busca proyectos y, luego, selecciona los que deseas agregar como proyectos de servicio.

8. Haz clic en Seleccionar. En la tabla Proyectos de servicio adjuntos, se muestran los proyectos de servicio seleccionados.

9. Haz clic en Cerrar.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Asegúrate de que esté instalada la versión más reciente de Google Cloud CLI. Ejecuta el siguiente comando desde Cloud Shell:

   gcloud components update

3. Crea o selecciona un proyecto nuevo, HOST_PROJECT_ID, para que sea el proyecto host de App Hub.

   • Crea un proyecto de Google Cloud:

     gcloud projects create HOST_PROJECT_ID

   • Selecciona el proyecto de Google Cloud que creaste:

     gcloud config set project HOST_PROJECT_ID

4. Habilita la API de App Hub en el proyecto host que acabas de crear.

   gcloud services enable apphub.googleapis.com \
       --project=HOST_PROJECT_ID
   

5. Si eres el creador del proyecto, se te otorga el rol de propietario básico (roles/owner). De forma predeterminada, este rol de IAM incluye los permisos necesarios para obtener acceso completo a la mayoría de los recursos de Google Cloud.

   Si no eres el creador del proyecto, se deben otorgar los permisos necesarios en el proyecto a la principal correspondiente. Por ejemplo, una principal puede ser una Cuenta de Google (para usuarios finales) o una cuenta de servicio (para aplicaciones y cargas de trabajo de procesamiento). Para obtener los permisos que necesitas para completar este instructivo, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

   1. De manera opcional, otorga a las personas que administrarán App Hub el rol de administrador de App Hub en el proyecto host. Repite el siguiente comando para cada administrador.

      gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      

      Reemplaza HOST_PROJECT_ADMIN por el usuario que tiene el rol de administrador de App Hub en el proyecto host. Este valor tiene el formato username@yourdomain, por ejemplo, robert.smith@example.com.

   2. Otorga el rol de administrador de App Hub en los proyectos de servicio a las personas que administran App Hub. Debe tener el rol de administrador de App Hub para agregar proyectos de servicio al proyecto host. Necesitas al menos una persona con este rol para cada proyecto de servicio. Una sola persona puede tener el rol en varios proyectos de servicio.

      gcloud projects add-iam-policy-binding SERVICE_PROJECT_1 \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      

      gcloud projects add-iam-policy-binding SERVICE_PROJECT_2 \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      

      gcloud projects add-iam-policy-binding SERVICE_PROJECT_3 \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      

      Reemplaza lo siguiente:

      • SERVICE_PROJECT_1: Es el primero de los tres proyectos de servicio en este ejemplo.
      • SERVICE_PROJECT_2: Es el segundo de los tres proyectos de servicio en este ejemplo.
      • SERVICE_PROJECT_3: Es el tercero de los tres proyectos de servicio en este ejemplo.

6. Agrega tus proyectos de servicio al proyecto host de App Hub.

   gcloud apphub service-projects add SERVICE_PROJECT_1 \
       --project=HOST_PROJECT_ID
   

   gcloud apphub service-projects add SERVICE_PROJECT_2 \
       --project=HOST_PROJECT_ID
   

   gcloud apphub service-projects add SERVICE_PROJECT_3 \
       --project=HOST_PROJECT_ID
   

Console

1. En la consola de Google Cloud, ve a la páginasettings Configuración:

   Ir a Configuración

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. Selecciona Alcance de la métrica.

   En la pestaña Alcance de métricas, se enumeran los recursos supervisados por el proyecto de Google Cloud actual. También se muestra una lista de los proyectos de Google Cloud cuyos permisos incluyen el proyecto actual de Google Cloud.

3. Para agregar proyectos de Google Cloud al permiso de las métricas, haz lo siguiente:

   1. En el panel Google Cloud Projects, haz clic en Add Projects.
   2. En el diálogo Agregar proyectos de Google Cloud, haz clic en Seleccionar proyectos y, luego, selecciona las casillas de verificación de los proyectos de servicio obligatorios que deseas supervisar.

   3. Para guardar los cambios, haz clic en Agregar proyectos.

      Se mostrará la página Configuración con la tabla de esa página actualizada para mostrar tus selecciones.

Después de agregar proyectos a un permiso de métricas, los cambios demoran unos 60 segundos en propagarse a través de todos los sistemas de Monitoring.

Para obtener más información sobre cómo configurar los permisos de las métricas con la consola de Google Cloud, consulta Configura un permiso de métricas.

gcloud

Para agregar tus proyectos de servicio como un contenedor de recurso supervisado al proyecto host de App Hub, haz lo siguiente:

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_1 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_2 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_3 \
    --project=HOST_PROJECT_ID

Para obtener más información sobre cómo configurar los permisos de las métricas con Google Cloud CLI, consulta Configura un permiso de las métricas con la API.

Console

1. Asegúrate de estar en el proyecto host.

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

   Ir a Aplicaciones

3. Haz clic en Crear aplicación.

4. En la página Crear aplicación, en el panel Elige la región y el nombre de la aplicación, según el alcance de los servicios y las cargas de trabajo que deseas registrar en la aplicación, haz una de las siguientes acciones:

   • Para crear una aplicación que te permita registrar servicios y cargas de trabajo desde una ubicación global, selecciona Global (Versión preliminar).

   • Para crear una aplicación que te permita registrar servicios y cargas de trabajo desde una sola ubicación, haz lo siguiente:

     1. Selecciona Regional.
     2. Selecciona una Región.

5. Ingresa el Nombre de la aplicación y haz clic en Continuar.

6. De manera opcional, agrega más detalles de la aplicación en los campos que aparecen a continuación. Para obtener más información, consulta Cómo actualizar una aplicación existente de App Hub en este documento.

7. Haz clic en Crear.

gcloud

1. Crea una nueva aplicación llamada APPLICATION_NAME y asígnale un nombre visible, APPLICATION_DISPLAY_NAME.

   gcloud apphub applications create APPLICATION_NAME \
     --scope-type=SCOPE_TYPE \
     --project=HOST_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.
   • SCOPE_TYPE: Es el alcance de tu aplicación que define qué servicios y cargas de trabajo están disponibles para que te registres en la aplicación. Usa uno de los siguientes valores:
     • REGIONAL
     • GLOBAL (vista previa)
   • REGION: Es la región de la aplicación. Según el --scope-type, asígnale el valor us-east1 o global (vista previa).

2. Enumera las aplicaciones de tu proyecto host.

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

   El resultado es similar a este:

   ID                DISPLAY_NAME              CREATE_TIME
   APPLICATION_NAME  APPLICATION_DISPLAY_NAME  2023-10-31T18:33:48
   

3. Obtén detalles de la aplicación que creaste.

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

   El comando muestra información en formato YAML, similar a la siguiente.

   createTime: '2023-10-31T18:33:48.199394108Z'
   displayName: APPLICATION_DISPLAY_NAME
   name: projects/HOST_PROJECT_ID/locations/REGION/applications/APPLICATION_NAME
   scope:
     type: SCOPE_TYPE
   state: ACTIVE
   uid: [APPLICATION_UID]
   updateTime: '2023-10-31T18:33:48.343303819Z'
   
   

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 edit Editar para la aplicación que quieres actualizar.

3. Cambia los campos según sea necesario y haz clic en Guardar.

4. Opcional: En la lista Criticality, para indicar la importancia de la aplicación, selecciona una de las siguientes opciones:

   • Fundamental
   • Alta
   • Mediano
   • Baja

5. Opcional: En la lista Environment, para indicar la etapa del ciclo de vida del software, selecciona una de las siguientes opciones:

   • Producción
   • Etapa de pruebas
   • Desarrollo
   • Prueba

6. Opcional: Agrega los siguientes detalles según sea necesario para los propietarios desarrolladores, los propietarios operadores y los propietarios de empresas. Ten en cuenta que debes ingresar la dirección de correo electrónico del propietario si agregas un nombre visible.

   1. Ingresa el nombre visible de un propietario.
   2. Ingresa la dirección de correo electrónico del propietario. Este valor debe tener el formato username@yourdomain, por ejemplo, 222larabrown@gmail.com.

7. Repite estos pasos para cada desarrollador, operador y propietario de la empresa.

8. 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=HOST_PROJECT_ID \
     --location=REGION
   

   Reemplaza lo siguiente:

   • APPLICATION_DISPLAY_NAME: Es el nombre visible de tu 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.

2. Enumera las aplicaciones en las que el atributo environment-type tiene el valor PRODUCTION.

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

   El resultado es similar a este:

   ID                DISPLAY_NAME              CREATE_TIME
   APPLICATION_NAME  APPLICATION_DISPLAY_NAME  2023-10-31T18:33:48
   

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. La pestaña Servicios y cargas de trabajo se muestra con 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 registrar, haz lo siguiente:

   1. En la pestaña Servicios y cargas de trabajo, haz clic en Registrar servicio o carga de trabajo.
   2. En la página Registrar servicio o carga de trabajo, en el panel Seleccionar recurso, haz clic en Explorar para seleccionar el servicio o la carga de trabajo como Recurso.
   3. En el panel Seleccionar recurso, elige un servicio o una carga de trabajo y haz clic en Seleccionar.
   4. En el panel Seleccionar recurso, ingresa un Nombre para el servicio o la carga de trabajo y haz clic en Continuar.
   5. De manera opcional, en el panel Agregar atributos, agrega más detalles del servicio o la carga de trabajo en los campos que aparecen a continuación. Para obtener más información, consulta Cómo actualizar una aplicación existente de App Hub en este documento. Ten en cuenta que puedes seleccionar valores para los campos Criticality y Environment que sean diferentes de los valores que estableciste cuando creaste la aplicación.
   6. Haga clic en Continuar.
   7. De forma opcional, en la sección Agregar propietarios, agrega más detalles sobre los propietarios del servicio o la carga de trabajo en los campos que aparecen a continuación. Para obtener más información, consulta Cómo actualizar una aplicación existente de App Hub en este documento.
   8. Haz clic en Register.

En la pestaña Servicios y cargas de trabajo, se muestra el servicio o la carga de trabajo registrados. Para obtener más información sobre los estados de registro, consulta las propiedades y los atributos de App Hub.

gcloud

1. Agrega a una persona con permisos de editor de App Hub.

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
     --member='user:APP_HUB_EDITOR' \
     --role='roles/apphub.editor'
   

   Reemplaza APP_HUB_EDITOR por el usuario que tiene el rol de editor de App Hub en el proyecto host. Este valor tiene el formato username@yourdomain, por ejemplo, robert.smith@example.com.

2. Enumera las cargas de trabajo descubiertas del proyecto de servicio 2, que está adjunto al proyecto host. Este comando muestra las cargas de trabajo que están disponibles para registrarse en una aplicación.

   gcloud apphub discovered-workloads list \
     --filter='workload_properties.gcp_project=projects/SERVICE_PROJECT_2' \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   El resultado es similar al siguiente, que incluye MIG no registradas:

   ID                           WORKLOAD_REFERENCE                                                                                                      WORKLOAD_PROPERTIES
   [DISCOVERED_WORKLOAD_ID_1]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
   [DISCOVERED_WORKLOAD_ID_2]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}     {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
   

   Copia el ID de la carga de trabajo del resultado para usarlo en el siguiente paso.

3. Registra una carga de trabajo del paso anterior en tu aplicación.

   gcloud apphub applications workloads create WORKLOAD_NAME \
     --discovered-workload='projects/HOST_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID_2' \
     --display-name='mywebserver-deployment1' \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   Reemplaza lo siguiente:

   • WORKLOAD_NAME: Es un nombre para registrar la carga de trabajo.
   • DISCOVERED_WORKLOAD_ID_2: Es el ID de la carga de trabajo del resultado del paso anterior.

4. Repite los dos pasos anteriores para filtrar y registrar las cargas de trabajo que desees del proyecto de servicio 3.

5. Opcional: Puedes actualizar las cargas de trabajo con los atributos criticality-type, environment-type y propietario.

   gcloud apphub applications workloads update WORKLOAD_NAME \
     --application=APPLICATION_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=HOST_PROJECT_ID \
     --location=REGION
   

   Ten en cuenta que debes proporcionar uno de los valores especificados para criticality-type y environment-type, pero el valor puede ser diferente de los valores que estableciste cuando creaste la aplicación.

6. Muestra una lista de las cargas de trabajo registradas en la aplicación.

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

   El resultado es similar a este:

   ID                DISPLAY_NAME                 WORKLOAD_REFERENCE                                                                                                    CREATE_TIME
   WORKLOAD_NAME     mywebserver-deployment1      {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}   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.

7. Enumera los servicios descubiertos con reglas de reenvío en el proyecto de servicio 1 que está adjunto al proyecto host. Este comando muestra los servicios disponibles para registrarse en una aplicación.

   gcloud apphub discovered-services list \
     --filter='service_properties.gcp_project=projects/SERVICE_PROJECT_1 AND service_reference.uri~"forwardingRules"' \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   El resultado es similar a este:

   ID                           SERVICE_REFERENCE                                                                                                                    SERVICE_PROPERTIES
   [DISCOVERED_SERVICE_ID_1]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
   [DISCOVERED_SERVICE_ID_2]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}     {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
   

   Copia el ID de servicio, DISCOVERED_SERVICE_ID_2, del resultado para usarlo en el siguiente paso.

8. Registra la regla de reenvío, testing-forwarding-rule-2, en el proyecto de servicio 1 como servicio.

   gcloud apphub applications services create SERVICE_NAME \
     --discovered-service='projects/HOST_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE_ID_2' \
     --display-name='mywebserver-service1' \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   Reemplaza lo siguiente:

   • SERVICE_NAME: Es un nombre para registrar el servicio.
   • DISCOVERED_SERVICE_ID_2: Es el ID de servicio del resultado del paso anterior.

9. Repite los pasos anteriores que muestran los servicios, filtran esos servicios y los registran en los proyectos de servicios 1, 2 y 3.

10. Actualiza un servicio con el atributo criticality-type y el atributo environment-type.

    gcloud apphub applications services update SERVICE_NAME \
      --criticality-type='CRITICALITY_LEVEL' \
      --environment-type='ENVIRONMENT' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID  \
      --location=REGION
    

11. Muestra una lista de los servicios registrados en la aplicación APPLICATION_NAME y el proyecto host HOST_PROJECT_ID.

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

    El resultado es similar al siguiente para cada servicio:

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

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

12. Filtra los servicios en la aplicación APPLICATION_NAME y el proyecto host HOST_PROJECT_ID a aquellos en los que el atributo environment-type esté configurado como PRODUCTION.

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

Console

Para agregar un proyecto de servicio a un proyecto host, haz lo siguiente:

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

   Ir a la configuración

2. En la página Configuración, haz clic en Vincular proyectos.

3. En el panel que se abre, busca proyectos en la lista que se muestra y selecciona las casillas de verificación de los proyectos que deseas agregar como proyectos de servicio.

4. Haz clic en Seleccionar. En la tabla Proyectos de servicio adjuntos, se muestran los proyectos seleccionados como los proyectos de servicio del proyecto host.

5. Haz clic en Cerrar.

Para quitar un proyecto de servicio de un proyecto host, haz lo siguiente:

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

   Ir a la configuración

2. En la página Configuración, selecciona las casillas de verificación de los proyectos que desees quitar como proyectos de servicio.

3. Haz clic en Detach projects. La tabla Proyectos de servicio adjuntos se actualiza para mostrar solo los proyectos que permanecen adjuntos al proyecto host.

gcloud

Para agregar un proyecto de servicio a un proyecto host, haz lo siguiente:

gcloud apphub service-projects add SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

gcloud apphub service-projects remove SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Console

• Para ver las aplicaciones de un proyecto, haz lo siguiente:

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

     Ir a Aplicaciones

  2. Opcional: Para filtrar la aplicación, sigue estos pasos:

     1. En el campo Filtro, selecciona un filtro, como Gravedad.
     2. Selecciona Alto como valor.
        Aparecerá una lista de aplicaciones de alta criticidad que se crean en el proyecto host.

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

  Aplicaciones

  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 página con una lista de los servicios y las cargas de trabajo registrados en tu aplicación.

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

     1. En el campo Filtro, selecciona un filtro, como Gravedad.
     2. Selecciona Alto como valor.
        Aparecerá una lista de servicios y cargas de trabajo de alta criticidad que están registrados en la aplicación.

  Servicios y cargas de trabajo

  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.

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

     1. En el campo Filtro, selecciona un filtro, como Entorno.
     2. Selecciona Producción como valor.
        Aparecerá una lista de los servicios y las cargas de trabajo del entorno de producción que están registrados en una aplicación.

gcloud

• Para ver las aplicaciones de un proyecto, haz lo siguiente:

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

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

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

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

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

• Opcional: Para filtrar los recursos en función de atributos variables, agrega una marca de comando filter a los comandos anteriores. Por ejemplo, para enumerar todas las cargas de trabajo registradas en las que el atributo criticality-type se establece en HIGH, haz lo siguiente:

  gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --filter='attributes.criticality.type=HIGH' \
    --project=HOST_PROJECT_ID \
    --location=REGION
  

  Para obtener más información sobre los atributos con los que puedes filtrar, consulta Cómo actualizar una aplicación existente de App Hub en esta página.

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 pestaña Detalles, haz clic en Cancelar registro 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 está sin registrar.
   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.

7. Para quitar los proyectos de servicio de tu proyecto host, consulta la sección Cómo agregar o quitar proyectos de servicio de este documento.

8. Para quitar los proyectos de servicio del permiso de métricas del proyecto host, haz lo siguiente:

   1. En la consola de Google Cloud, ve a la páginasettings Configuración:

      Ir a Configuración

      Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

   2. Selecciona Alcance de la métrica.
   3. En el panel Proyectos de Google Cloud, haz clic en Quitar proyecto y, luego, completa el diálogo de confirmación.

gcloud

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

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

2. Cancela el registro de la carga de trabajo de la aplicación:

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

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

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

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

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

5. Cancela el registro del servicio en la aplicación:

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

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

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

7. Borra la aplicación:

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

8. Quita un proyecto de servicio del proyecto host:

   gcloud apphub service-projects remove SERVICE_PROJECT_ID \
     --project=HOST_PROJECT_ID
   

9. Repite el comando anterior para quitar todos los proyectos de servicio del proyecto host.

10. Quita los proyectos de servicio del permiso de métricas del proyecto host (versión preliminar):

    gcloud beta monitoring metrics-scopes delete projects/SERVICE_PROJECT_ID \
      --project=HOST_PROJECT_ID
    

11. Repite el comando anterior para quitar todos los proyectos de servicio del proyecto host del alcance de las métricas.