Se usó la API de Cloud Translation para traducir esta página.

Configura App Hub

En este documento, se proporcionan instrucciones para configurar App Hub para compilar, operar y administrar aplicaciones en Google Cloud. Es para quienes configuran y administran App Hub.

Si estás configurando App Hub, las tareas principales son las siguientes: sigue:

Decide si quieres crear un nuevo proyecto host de App Hub o usar un proyecto existente como tu proyecto host.
- Si planeas tener más de un proyecto host, te recomendamos enfáticamente de crearlos en la misma carpeta.
- Los proyectos host en App Hub no son lo mismo que Los proyectos host de VPC compartida y no tienen los mismos requisitos. Por ejemplo, no necesitas una red de VPC compartida para usar App Hub. En este documento, todas las referencias a los proyectos host corresponden a App Hub proyectos host.
- Un proyecto host no puede ser un proyecto de servicio más que para sí mismo.
Habilita la API de App Hub en el proyecto host.
Agrega uno o más proyectos de servicio de App Hub al proyecto host.
- Los proyectos de servicio en App Hub no son lo mismo que de servicio de VPC compartida y no tienen los mismos requisitos. En este documento, todas las referencias a proyectos de servicio Proyectos de servicio de App Hub.
Designa usuarios de App Hub como App Hub Administradores, editores de App Hub o App Hub Lectores.
Crear aplicaciones
Registra servicios y cargas de trabajo en la aplicación.

Servicios y cargas de trabajo

Con App Hub, los recursos de proyectos de servicio conectados a el proyecto host están disponibles como servicios y cargas de trabajo. Registrando de tus servicios y cargas de trabajo a una aplicación te permite observar y supervisar los recursos. Puedes designar los siguientes recursos como servicios de App Hub y registrarlos en Aplicaciones de App Hub:

Reglas de reenvío
Mapas de URL
Servicios de backend

Puedes designar grupos de instancias administrados (MIG), pero no VMs individuales, como cargas de trabajo y registrarlas en las aplicaciones de App Hub.

App Hub admite las conexiones internas y externas de L7 Balanceadores de cargas de aplicaciones con tráfico HTTP o HTTPS

Las cargas de trabajo y los servicios que registres deben estar en la misma región que el aplicación; por lo tanto, las siguientes instrucciones y comandos suponen que todos recursos están en la misma región. Para obtener información sobre las regiones para designarlos, consulta Ubicaciones.

Proceso de configuración general

En la siguiente lista, se resumen los pasos para configurar App Hub:

Determina qué recursos existentes incluir en tu y los proyectos a los que pertenecen.
Crea un proyecto host de App Hub y habilita la API de App Hub en el proyecto. De manera opcional, según tu de la estructura organizativa de tu empresa, crea más de un proyecto host. Si creas varios proyectos, te recomendamos que los crees en una carpeta nueva.
Vincula proyectos de servicio. Después de configurar un proyecto host, adjunta proyectos de servicio con recursos subyacentes que tus aplicaciones necesitan, hasta el proyecto host. Ten en cuenta lo siguiente:
1. Los proyectos de servicio deben estar en la misma organización que el proyecto host. Después de conectar un proyecto de servicio a un host no puedes moverlo a otra organización. Para mover el proyecto de servicio a una organización diferente, debes seguir el instrucciones en este documento para separar o quitar el adjunto del proyecto de servicio con el proyecto host. Luego, puedes adjuntar el proyecto de servicio a una organización diferente.
2. Un proyecto de servicio no se puede vincular a más de un proyecto host.
3. Un proyecto host puede ser su propio proyecto de servicio, pero no puede ser proyecto de servicio para cualquier otro proyecto host.
4. Después de conectar proyectos de servicio a un proyecto host, consulta el host proyecto de servicios o cargas de trabajo devuelve automáticamente todos los servicios y cargas de trabajo en todos los proyectos de servicio.
Crea una aplicación para organizar varias cargas de trabajo y servicios. Ten en cuenta lo siguiente:
1. Asegúrate de que la aplicación tenga un nombre que sea único en el proyecto host y la ubicación.
2. Un proyecto de servicio puede vincularse a un proyecto host con varias aplicaciones, pero su pueden registrarse recursos individuales en una sola aplicación.
Consulta servicios y cargas de trabajo, y regístralos en tu aplicación. Después de crear una aplicación, consulta el proyecto host para conocer y cargas de trabajo de Google Cloud. Las consultas se ejecutan en el proyecto host y en todas proyectos de servicio vinculados al proyecto host. También devuelven todos servicios y cargas de trabajo en esos proyectos. Ten en cuenta lo siguiente:
1. Solo puedes registrar un servicio o una carga de trabajo en una sola aplicación.
2. Todas las cargas de trabajo y los servicios que registres deben estar en la misma región que la aplicación.
3. Los servicios y cargas de trabajo registrados no se ven afectados por las actualizaciones del recurso de infraestructura subyacente. En otras palabras, si eliminas recursos subyacentes que actúan como servicios y cargas de trabajo, App Hub no borra las cargas de trabajo asociadas ni servicios desde tu aplicación. Debes cancelar el registro por separado carga de trabajo o servicio.

Requisitos previos

Antes de configurar App Hub, completa las siguientes tareas.

Decide cuál proyecto existente es el proyecto host o crea uno nuevo para el proyecto host. Te recomendamos que crees un proyecto nuevo.
Asegúrate de haber decidido qué personas llevan a cabo Identity and Access Management (IAM) roles para App Hub: Administrador de App Hub, el editor y el visualizador de App Hub.

Ten en cuenta lo siguiente:

Los proyectos host pueden tener uno o más proyectos de servicio vinculados.
Un proyecto de servicio no se puede vincular a más de un proyecto host.
La persona que adjunta un proyecto de servicio a un proyecto host debe tener las rol de IAM Administrador de App Hub en la y el proyecto host. Para obtener más información, consulta Funciones y permisos de App Hub

Configura App Hub

En esta sección, crearás una arquitectura de App Hub de ejemplo.

En el ejemplo, una organización tiene tres proyectos de servicio, con sus recursos de infraestructura implementados en los proyectos de la siguiente manera:

El proyecto de servicio 1 tiene dos recursos de infraestructura: Servicio 1 y Servicio 2.
El proyecto de servicio 2 tiene tres recursos de infraestructura: servicio 3, carga de trabajo 1, y Workload 2.
El proyecto de servicio 3 tiene tres recursos de infraestructura: servicio 4, carga de trabajo 3, y Workload 4.

Asegúrate de que los proyectos que elijas para crear el ejemplo contengan la recursos descritos en esta sección, o prepárate para ajustar el ejemplo como sigas las instrucciones.

Las siguientes secciones contienen las instrucciones para crear un Ejemplo de App Hub. Creas un proyecto host y agregas servicios proyectos al proyecto host y, luego, crear una aplicación, vincular servicios y cargas de trabajo a la aplicación. El ejemplo tiene tres proyectos de servicio, pero puedes agregar menos o más.

En el ejemplo, se supone que los proyectos de servicio que agregas ya existen y que contienen servicios y cargas de trabajo que agregas a tu aplicación. Antes de ti crear el ejemplo, determinar qué proyectos de servicio contienen los servicios y cargas de trabajo que quieres incluir en la aplicación.

Habilitar App Hub

En esta sección, seleccionarás o crearás un nuevo proyecto host, habilita el la API de App Hub y otorgar los roles y permisos adecuados a las personas de tu organización. También debes adjuntar proyectos de servicio al host en un proyecto final.

Console

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

Ir al selector de proyectos
Selecciona o crea un proyecto de Google Cloud. para que sea tu proyecto host de App Hub.
Habilita la API necesaria.
Habilita la API

Si eres el creador del proyecto, se te otorga la rol básico de propietario (roles/owner). De forma predeterminada, esta función de Identity and Access Management (IAM) incluye los permisos necesarios para el acceso completo a la mayoría recursos de Google Cloud.

Si no eres el creador del proyecto, debes otorgar los permisos necesarios en el proyecto al principal correspondiente. Por ejemplo, un el 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 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 Otorgar acceso. Se abrirá el panel Otorgar acceso.
3. En el campo Principales nuevas, ingresa la dirección de correo electrónico de la 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 Administrador de App Hub y haz clic en Guardar.
6. En cada uno de los proyectos de servicio de App Hub, otorga el Administrador de App Hub al mismo usuario.
En la consola de Google Cloud, ve a la Configuración de App Hub. .

Ir a la configuración
En la página Configuración, haz clic en Adjuntar proyectos.
Realiza una de las siguientes acciones:
- En la lista de proyectos, selecciona las casillas de verificación de los proyectos que agregar como proyectos de servicio.
- Busca proyectos y, luego, selecciona los que quieres agregar como servicio proyectos.
Haz clic en Seleccionar. En la tabla Attached Service Project(s), se muestra el servicio seleccionado proyectos.
Haz clic en Cerrar.

gcloud

En la consola de Google Cloud, activa Cloud Shell.

Activar Cloud Shell

En la parte inferior de la consola de Google Cloud, se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.
Asegúrate de que esté instalada la versión más reciente de Google Cloud CLI. Ejecutar el siguiente comando desde Cloud Shell:
```
gcloud components update
```
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
```

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

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

Si eres el creador del proyecto, se te otorga la rol básico de propietario (roles/owner). De forma predeterminada, esta función de Identity and Access Management (IAM) incluye los permisos necesarios para el acceso completo a la mayoría recursos de Google Cloud.

Si no eres el creador del proyecto, debes otorgar los permisos necesarios en el proyecto al principal correspondiente. Por ejemplo, un el 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 te otorgue los siguientes roles de IAM en tu proyecto:
1. De forma opcional, otorga a las personas que administrarán App Hub, el App Hub administrador 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. Esta tiene el formato username@yourdomain, por ejemplo, robert.smith@example.com
2. Otórgale al administrador de App Hub el rol de administrador de App Hub en los proyectos de servicio las personas que administran App Hub. Deben contar con el Rol de administrador de App Hub para agregar proyectos de servicio al host en un proyecto final. Necesitas al menos una persona con este rol para cada servicio. en un proyecto final. 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: el primero de tres proyectos de servicio en este ejemplo.
  - SERVICE_PROJECT_2: el segundo de tres proyectos de servicio en este ejemplo.
  - SERVICE_PROJECT_3: el tercero de tres proyectos de servicio en este ejemplo.

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

Crea una aplicación

Si aún no tienes una, crea una aplicación para que sea el contenedor de tu y cargas de trabajo de Google Cloud.

Console

Asegúrate de estar en el proyecto host.
En la consola de Google Cloud, ve a la página Aplicaciones de App Hub.

Ir a Aplicaciones
Haz clic en Crear aplicación. El panel Crear aplicación que se muestra.
Selecciona una Región.
Ingresa el Nombre de la aplicación y haz clic en Continuar.
En la sección Agregar atributos, ingresa el Nombre visible.
También puedes agregar más detalles de la aplicación en los campos correspondientes. siguientes. Para obtener más información, en este documento, consulta Actualiza una aplicación existente de App Hub.
Haz clic en Crear.

gcloud

Crea una nueva aplicación llamada APPLICATION_NAME y le daremos un nombre visible, APPLICATION_DISPLAY_NAME La marca --scope-type define qué servicios y las cargas de trabajo se pueden registrar en una aplicación. Solo se admite REGIONAL, lo que significa que solo los servicios y las cargas de trabajo de la misma región que registrar una aplicación.
```
gcloud apphub applications create APPLICATION_NAME \
  --display-name='APPLICATION_DISPLAY_NAME' \
  --scope-type=REGIONAL \
  --project=HOST_PROJECT_ID \
  --location=REGION
```
Reemplaza lo siguiente:
- APPLICATION_NAME: El nombre de tu aplicación. El nombre debe incluir solo caracteres alfanuméricos en minúscula, sin y espacios.
- APPLICATION_DISPLAY_NAME: El nombre visible de tu aplicación.
- REGION: Es la región de la aplicación. Dar esto el valor us-east1

Obtén una lista de las aplicaciones de tu proyecto host.

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

El resultado es similar a este:

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

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 al siguiente.

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

Actualizar una aplicación existente de App Hub

También puedes actualizar los atributos de tu aplicación luego de que esta se crear.

Console

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

Ir a Aplicaciones
En la lista de aplicaciones, haz clic en . Edita la aplicación que deseas actualizar.
Cambia los campos según sea necesario y haz clic en Guardar.
Opcional: En la lista Importancia, para indicar la importancia de la selecciona una de las siguientes opciones:
- Es esencial
- Alta
- Media
- Baja
Opcional: En el campo Entorno, para indicar la etapa del ciclo de vida del software, selecciona una de las siguientes opciones:
- Producción
- Etapa de pruebas
- Desarrollo
- Prueba
Opcional: Agrega los siguientes detalles según sea necesario para los propietarios desarrolladores: Propietarios operadores y Propietarios de empresa. 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.
Repite estos pasos para cada desarrollador, operador y propietario de la empresa.
Haz clic en Guardar.

gcloud

Actualiza tu aplicación con criticality-type, environment-type y atributos de tipo de propietario:
```
gcloud apphub applications update 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
```
Reemplaza lo siguiente:
- CRITICALITY_LEVEL: Indica qué tan importante es aplicación, servicio o carga de trabajo es a tus operaciones comerciales. Proporciona uno de los siguientes valores:
  - MISSION_CRITICAL
  - HIGH
  - MEDIUM
  - LOW
- ENVIRONMENT: Indica las etapas de la 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 de las desarrollador, operador y propietario de la empresa, respectivamente.
- EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR y EMAIL-NAME-BUSINESS: direcciones de correo electrónico del desarrollador, operador y propietario de la empresa, respectivamente. Estos valores debe tener el formato username@yourdomain, por ejemplo, 222larabrown@gmail.com

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

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

El resultado es similar a este:

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

Registra servicios y cargas de trabajo

Cuando registras servicios de infraestructura y cargas de trabajo en una aplicación, el servicios y cargas de trabajo se registran como recursos de App Hub. Si estás usando los marcadores de posición para crear la aplicación con gcloud CLI, los servicios y las cargas de trabajo en los tres proyectos de servicio son los siguientes:

El proyecto de servicio 1 tiene dos recursos de infraestructura: Servicio 1 y Servicio 2.
El proyecto de servicio 2 tiene tres recursos de infraestructura: servicio 3, carga de trabajo 1, y Workload 2.
El proyecto de servicio 3 tiene tres recursos de infraestructura: servicio 4, carga de trabajo 3, y Workload 4.

Console

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

Ir a Aplicaciones
Haz clic en el nombre de tu aplicación. Se mostrará la pestaña Servicios y cargas de trabajo con una lista de registros servicios y cargas de trabajo de tus proyectos de servicio.
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 Registra servicio o carga de trabajo.
2. En el panel Registrar servicio o carga de trabajo, en la En la sección Elige un servicio o una carga de trabajo, selecciona el servicio o la carga de trabajo y haz clic en Continuar.
3. En la sección Agregar atributos, ingresa un Nombre para el servicio. carga de trabajo.
4. De forma opcional, agrega más detalles para el servicio o la carga de trabajo en los campos siguientes. Para obtener más información, en este documento, consulta Actualiza una aplicación existente de App Hub. Ten en cuenta que debes proporcionar uno de los valores especificados para Importancia y Entorno, pero el valor puede es diferente de los valores que se configuran cuando se crea la aplicación.
5. Haz clic en Register. En la pestaña Servicios y cargas de trabajo, se muestra el servicio registrado carga de trabajo. Para obtener más información sobre los estados de registro, consulta la propiedades y atributos de App Hub.

gcloud

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 Editor de App Hub en el proyecto host. Este valor tiene el valor formato username@yourdomain, por ejemplo, robert.smith@example.com.

Enumerar las cargas de trabajo descubiertas del proyecto de servicio 2, que está conectado a el proyecto host. Este comando muestra cargas de trabajo que están disponibles para registrados 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 los MIG no registrados:

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

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

Copia el ID de la carga de trabajo del resultado para usarlo en el próximo paso.

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 como
DISCOVERED_WORKLOAD_ID_2: El ID de la carga de trabajo de el resultado del paso anterior.

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

Opcional: Puedes actualizar las cargas de trabajo con criticality-type. environment-type y atributos de 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 es diferente de los valores que se configuran cuando se crea la aplicación.

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

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

Enumerar los servicios detectados con reglas de reenvío en el Proyecto de servicio 1 conectado al proyecto host. Este comando muestra 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: [DISCOVERED_SERVICE_ID_1]
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}

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

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

Registra la regla de reenvío, testing-forwarding-rule-2 en servicio el proyecto 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 la servicio como
DISCOVERED_SERVICE_ID_2: El ID del servicio de el resultado del paso anterior.

Repite los pasos anteriores que enumeran y filtran los servicios. registrar los servicios en los proyectos de servicio 1, 2 y 3.

Actualiza un servicio con el atributo criticality-type y el 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

Enumera los servicios registrados en el APPLICATION_NAME de la aplicación y HOST_PROJECT_ID proyecto host.

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

El resultado es similar al siguiente para cada servicio:

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

Los servicios registrados, pero los desvinculados se indican con un valor vacío en la SERVICE_REFERENCE.

Filtra los servicios de la sección APPLICATION_NAME aplicación y HOST_PROJECT_ID proyecto host 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

Finalizó el proceso de configuración de App Hub.

Agregar o quitar proyectos de servicio

Puedes modificar los adjuntos del proyecto de servicio para crear diferentes recursos disponibles para agrupar en una aplicación.

Console

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

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

Ir a la configuración
En la página Configuración, haz clic en Adjuntar proyectos.
En el panel que aparece, busca proyectos en la lista que se muestra. selecciona las casillas de verificación de los proyectos que quieres agregar como servicio proyectos.
Haz clic en Seleccionar. En la tabla Proyectos de servicios vinculados, se muestran los proyectos seleccionados. que los proyectos de servicio para el proyecto host.
Haz clic en Cerrar.

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

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

Ir a la configuración
En la página Configuración, selecciona las casillas de verificación de los proyectos que deseas. quitar como proyectos de servicio.
Haz clic en Desconectar proyectos. La tabla Attached Service Project(s) se actualiza para mostrar solo los proyectos que permanecen vinculados 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

Reemplaza SERVICE_PROJECT_ID por el nombre del proyecto de servicio que quieres agregar al proyecto host. Para quitar un proyecto de servicio del proyecto host, haz lo siguiente:

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

Consulta las aplicaciones, los servicios y las cargas de trabajo existentes

Puedes ver aplicaciones en un proyecto y enumerar los servicios y las cargas de trabajo en un y mantener la integridad de su aplicación.

Console

Para ver las aplicaciones de un proyecto, en la consola de Google Cloud, ve a Página Aplicaciones de App Hub

Ir a Aplicaciones
Para enumerar los servicios y las cargas de trabajo, sigue estos pasos:
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. Una página con una lista de servicios y cargas de trabajo registrados en tu de la aplicación.
3. Opcional: Para filtrar los servicios o las cargas de trabajo, sigue estos pasos:
  1. En el campo Filtro, selecciona un filtro como Importancia.
  2. Selecciona el valor Alto.
    Una lista de servicios y cargas de trabajo de alta importancia que registrada en la aplicación.
Servicios y cargas de trabajo
1. En la consola de Google Cloud, ve a App Hub Servicios y cargas de trabajo.
  Ir a Servicios y cargas de trabajo
2. En la lista Región, selecciona las regiones en las que deseas y visualizar 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 cargas de trabajo de los proyectos de servicio vinculados us-east1:
3. Opcional: Para filtrar los servicios o las cargas de trabajo, sigue estos pasos:
  1. En el campo Filtro, selecciona un filtro, como Entorno.
  2. Selecciona Producción como el valor.
    Una lista de servicios y cargas de trabajo en el entorno de producción que está registrado en una aplicación.

gcloud

Para ver las aplicaciones de un proyecto, sigue estos pasos:

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

Limpia

Limpia una aplicación existente y quita un adjunto de proyecto de servicio de el proyecto host para quitar los recursos asociados con el proyecto. Esto detiene el el descubrimiento automático de recursos en el proyecto de servicio.

Para hacerlo, primero debes borrar las cargas de trabajo y los servicios registrados en el y mantener la integridad de su aplicación.

Console

En la consola de Google Cloud, ve a Página Aplicaciones de App Hub

Ir a Aplicaciones
Haz clic en el nombre de una aplicación. Aparecerá una lista de servicios y cargas de trabajo registrados en la aplicación.
Cancela el registro de un servicio o una carga de trabajo.
1. En la pestaña Servicios y cargas de trabajo, selecciona la En la sección Servicios y cargas de trabajo registrados, haz clic en el nombre de servicio o carga de trabajo que quieras cancelar.
2. En la pestaña Detalles, haz clic en Cancelar registro para actualizar el servicio. como un recurso Descubierto.
  En la pestaña Services and Workloads, una alerta notifica que el carga de trabajo no está registrada.
3. Repite estas instrucciones para cada servicio y carga de trabajo.
Ve a la página Aplicaciones de App Hub.

Ir a Aplicaciones
Haz clic en el nombre de una aplicación.
En la página con los detalles de la aplicación, haz clic en Borrar.
En este documento, sigue las instrucciones Agrega o quita proyectos de servicio para quitar los proyectos de servicio de tu proyecto host.

gcloud

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

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

Cancela el registro de la carga de trabajo en la aplicación:
```
gcloud apphub applications workloads delete WORKLOAD_NAME \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION
```
Ahora es una carga de trabajo descubierta que se puede registrar y mantener la integridad de su aplicación.
Repite el comando anterior para borrar las cargas de trabajo registradas restantes desde la aplicación.

Obtén una lista de los servicios registrados en la aplicación:

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

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 es ahora detectado que se puede registrar en el y mantener la integridad de su aplicación.
Repite el comando anterior para cancelar el registro de los registros restantes servicios de la aplicación.

Borra la aplicación:

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

Quita un proyecto de servicio del proyecto host:

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

Repite el comando anterior para quitar todos los proyectos de servicio del host en un proyecto final.

Configura App Hub

Servicios y cargas de trabajo

Proceso de configuración general

Requisitos previos

Configura App Hub

Habilitar App Hub

Console

gcloud

Crea una aplicación

Console

gcloud

Actualizar una aplicación existente de App Hub

Console

gcloud

Registra servicios y cargas de trabajo

Console

gcloud

Agregar o quitar proyectos de servicio

Console

gcloud

Consulta las aplicaciones, los servicios y las cargas de trabajo existentes

Console

Aplicaciones

Servicios y cargas de trabajo

gcloud

Limpia

Console

gcloud

¿Qué sigue?