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:

  1. 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 los mismos que los proyectos de 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 proyectos host son a proyectos de App Hub.
    • Un proyecto host no puede ser un proyecto de servicio más que para sí mismo.
  2. Habilita la API de App Hub en el proyecto host.
  3. 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 son a proyectos de servicio de App Hub.
  4. Designa usuarios de App Hub como App Hub Administradores, editores de App Hub o App Hub Lectores.
  5. Crear aplicaciones
  6. Registra servicios y cargas de trabajo en la aplicación.

Servicios y cargas de trabajo

Con App Hub, los recursos de los proyectos de servicio conectados al proyecto host están disponibles para ti 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 la aplicación. Por lo tanto, en las instrucciones y los comandos que se indican a continuación, se supone que todos los recursos están en la misma región. Para obtener información sobre las regiones en las que puedes para designarlos, consulta Ubicaciones.

Proceso de configuración general

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

  1. Determina qué recursos existentes incluir en tu aplicación y a qué proyectos pertenecen.
  2. Crea un proyecto host de App Hub y habilita la API de App Hub en el proyecto. De forma opcional, crea más de un proyecto de host según la estructura organizativa de tu negocio. Si creas varios proyectos, te recomendamos que los crees en una carpeta nueva.
  3. Adjunta proyectos de servicio. Después de configurar un proyecto host, adjúntalo a proyectos de servicio con recursos subyacentes que necesiten tus aplicaciones. 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 proyecto host, no puedes moverlo a otra organización. Para mover el proyecto de servicio a una organización diferente, debes seguir las instrucciones de este documento para quitar o desvincular el archivo adjunto del proyecto de servicio al 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.
  4. 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 los recursos individuales se pueden registrar en una sola aplicación.
  5. Consulta servicios y cargas de trabajo, y regístralas 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 todos los proyectos de servicio que están conectados a él. 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 las 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.

  1. Decide cuál proyecto existente es el proyecto host o crea uno nuevo para el proyecto host. Te recomendamos que crees un proyecto nuevo.
  2. Asegúrate de haber decidido qué personas tienen los roles de administración de identidades y accesos (IAM) de App Hub: administrador, editor y visor.

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 vincula un proyecto de servicio a un proyecto host debe tener el rol de administrador de App Hub de IAM en el proyecto de servicio y en 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 ejemplo de App Hub.

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: el servicio 3, la carga de trabajo 1 y la carga de trabajo 2.
  • El proyecto de servicio 3 tiene tres recursos de infraestructura, el servicio 4, la carga de trabajo 3 y la carga de trabajo 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 agregues ya existen y que contienen los servicios y las 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, seleccionas o creas un proyecto host nuevo, habilitas la API de App Hub y otorgas los roles y permisos adecuados a las personas de tu organización. También puedes conectar proyectos de servicio al proyecto host.

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 Identity and Access Management (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 Otorgar 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 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 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 Attached Service Project(s), se muestra el servicio seleccionado proyectos.

  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. Ejecutar 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 la rol básico de propietario (roles/owner). De forma predeterminada, esta Identity and Access Managements (IAM) incluye los permisos necesarios para el acceso completo a la mayoría 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 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. 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 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 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: el primero de 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: el tercero de 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

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

  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 Elige la región de aplicación and name selecciona una Region.

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

  6. También puedes agregar más detalles de la aplicación en los campos correspondientes. siguientes. 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. La marca --scope-type define qué servicios y 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 \
  --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.
    • REGION: Es la región de la aplicación. Dar esto el valor us-east1

  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: APPLICATION_NAME
DISPLAY_NAME: APPLICATION_DISPLAY_NAME
CREATE_TIME: 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: REGIONAL
state: ACTIVE
uid: [APPLICATION_UID]
updateTime: '2023-10-31T18:33:48.343303819Z'

Cómo actualizar una aplicación existente de App Hub

También 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 . Edita la aplicación que deseas 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
    • Media
    • Baja

  5. Opcional: En la lista Entorno, 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 la 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.

  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: El nombre visible de tu aplicación.
    • 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 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: APPLICATION_NAME
DISPLAY_NAME: APPLICATION_DISPLAY_NAME
CREATE_TIME: 2023-10-31T18:33:48

Registra servicios y cargas de trabajo

Cuando registras servicios y cargas de trabajo de infraestructura en una aplicación, estos 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: el servicio 1 y el servicio 2.
  • El proyecto de servicio 2 tiene tres recursos de infraestructura: el servicio 3, la carga de trabajo 1 y la carga de trabajo 2.

  • El proyecto de servicio 3 tiene tres recursos de infraestructura: servicio 4, carga de trabajo 3, y Workload 4.

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 Select resource, haz clic en Browse para seleccionar el servicio o carga de trabajo como un 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, en este documento, consulta Actualiza una aplicación existente de App Hub. 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 manera opcional, en la sección Agregar propietarios, puedes agregar más detalles sobre el propietarios del servicio o la carga de trabajo en los campos que siguen. 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 registrado carga de trabajo. Para obtener más información sobre los estados de registro, consulta la propiedades y 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 Editor de App Hub en el proyecto host. Este valor tiene el valor formato username@yourdomain, por ejemplo, robert.smith@example.com.

  2. 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.

  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 como
    • DISCOVERED_WORKLOAD_ID_2: El ID de la carga de trabajo de el 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 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 diferente de los valores que estableciste cuando creaste la aplicación.

  6. 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 separadas, se indican con un valor vacío en el campo WORKLOAD_REFERENCE. Para obtener más información sobre el estados de registro, consulta la propiedades y atributos de App Hub.

  7. 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 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 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 el servicio.
    • DISCOVERED_SERVICE_ID_2: El ID del servicio de el 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. 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 separados, se indican con un valor vacío en el campo SERVICE_REFERENCE.

  12. 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

Se completó el proceso de configuración de App Hub.

Agregar o quitar proyectos de servicio

Puedes modificar los archivos adjuntos del proyecto de servicio para que diferentes recursos de infraestructura estén disponibles para agruparse en una aplicación.

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 Adjuntar 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 deseas 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
Reemplaza SERVICE_PROJECT_ID por el nombre del proyecto de servicio que deseas 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 visualizar aplicaciones en un proyecto y enumerar servicios y 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 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 cargas de trabajo de los proyectos de servicio vinculados 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

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 descubrimiento automático de recursos en el proyecto de servicio.

Para ello, primero debes borrar 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 servicios y cargas de trabajo registrados en la aplicación.

  3. 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 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 aplicación, haz clic en Borrar.

  7. En este documento, sigue las instrucciones Agrega o quita proyectos de servicio para quitar los proyectos de servicio de tu proyecto host.

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

  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 registros restantes servicios de 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.

¿Qué sigue?