Configurar App Hub

En este documento, se proporcionan instrucciones para configurar App Hub para compilar, operar y administrar aplicaciones en Google Cloud. Está destinado a personas que configuran y administran App Hub.

Si configuras App Hub, las tareas principales son las siguientes:

  1. Decide si quieres crear un nuevo proyecto host de App Hub o usar uno existente.
    • Si planeas tener más de un proyecto host, te recomendamos que los crees en la misma carpeta.
    • Los proyectos host en App Hub no son los mismos 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 proyectos host son proyectos host de App Hub.
    • Un proyecto host no puede ser un proyecto de servicio distinto de 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 los mismos que los proyectos 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 a los usuarios de App Hub como administradores, editores de App Hub o visualizadores de App Hub.
  5. Crea aplicaciones.
  6. Registrar servicios y cargas de trabajo en la aplicación

Servicios y cargas de trabajo

Con App Hub, los recursos de los proyectos de servicio vinculados al proyecto host están disponibles como servicios y cargas de trabajo. Registrar tus servicios y cargas de trabajo en una aplicación te permite observar y supervisar los recursos. Puedes designar los siguientes recursos como servicios de App Hub y registrarlos en sus aplicaciones:

  • 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 registrarlos en aplicaciones de App Hub.

App Hub admite los balanceadores de cargas de aplicaciones internos y externos de L7 regionales con tráfico HTTP o HTTPS.

Las cargas de trabajo y los servicios que registras deben estar en la misma región que la aplicación; por lo tanto, en las instrucciones y los comandos que siguen, se supone que todos los recursos están en la misma región. Para obtener información sobre las regiones que puedes designar, 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 manera opcional, según la estructura organizativa de tu empresa, crea más de un proyecto host. Si creas varios proyectos, te recomendamos que lo hagas en una carpeta nueva.
  3. Vincula proyectos de servicio. Después de configurar un proyecto host, vincula los proyectos de servicio con recursos subyacentes que las aplicaciones necesiten al 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 vincular un proyecto de servicio a un proyecto host, no podrás moverlo a otra organización. Si deseas mover el proyecto de servicio a una organización diferente, debes seguir las instrucciones de este documento para quitar o desconectar el adjunto del proyecto de servicio del proyecto host. Luego, puedes conectar el proyecto de servicio a otra organización.
    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 un proyecto de servicio para ningún otro proyecto host.
    4. Después de conectar los proyectos de servicio a un proyecto host, consultar el proyecto host en busca de servicios o cargas de trabajo muestra 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 en la ubicación.
    2. Un proyecto de servicio se puede vincular a un proyecto host con varias aplicaciones, pero sus recursos individuales se pueden registrar en una sola aplicación.
  5. Consulta servicios y cargas de trabajo, y regístralos en tu aplicación. Después de crear una aplicación, debes consultar el proyecto host para conocer los servicios y las cargas de trabajo disponibles. Las consultas se ejecutan en el proyecto host y en todos los proyectos de servicio vinculados a él. También muestran todos los servicios y cargas de trabajo de esos proyectos. Ten en cuenta lo siguiente:
    1. Solo puedes registrar un servicio o una carga de trabajo en una sola aplicación.
    2. Cualquier carga de trabajo y servicio 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 borras los recursos subyacentes que actúan como servicios y cargas de trabajo, App Hub no borra las cargas de trabajo y servicios asociados de tu aplicación. Debes cancelar el registro de la carga de trabajo o el servicio por separado.

Requisitos previos

Antes de configurar App Hub, completa las siguientes tareas.

  1. Decide qué proyecto existente es el proyecto host o crea uno nuevo para que sea el proyecto host. Te recomendamos que crees un proyecto nuevo.
  2. Asegúrate de haber decidido qué personas poseen los roles de Identity and Access Management (IAM) para App Hub: administrador de App Hub, editor de App Hub y 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 conecta un proyecto de servicio a un proyecto host debe tener la función de IAM de administrador de App Hub en el proyecto de servicio y el proyecto host. Para obtener más información, consulta Roles y permisos de App Hub.

Configurar 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: el servicio 1 y el servicio 2.
  • El Proyecto de servicio 2 tiene tres recursos de infraestructura: Servicio 3, Carga de trabajo 1 y Carga de trabajo 2.
  • El Proyecto de servicio 3 tiene tres recursos de infraestructura: Servicio 4, Carga de trabajo 3 y Carga de trabajo 4.

Asegúrate de que los proyectos que elijas para crear el ejemplo contengan los recursos descritos en esta sección o prepárate para ajustar el ejemplo a medida que avanzas en las instrucciones.

Las siguientes secciones contienen las instrucciones para crear un ejemplo de App Hub. Crea un proyecto host y agrega proyectos de servicio a este. Luego, crea una aplicación y vincula servicios y cargas de trabajo a la aplicación. Este 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 contienen servicios y cargas de trabajo que agregas a tu aplicación. Antes de crear el ejemplo, determina qué proyectos de servicio contienen los servicios y las cargas de trabajo que deseas incluir en la aplicación.

Habilitar App Hub

En esta sección, seleccionarás o crearás un proyecto host nuevo, habilitarás la API de App Hub y otorgarás roles y permisos adecuados a las personas de tu organización. También puedes vincular 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 para que sea tu proyecto host de App Hub.

  3. Habilita la API necesaria.

    Habilita la API

  4. Si eres el creador del proyecto, se te otorga el rol básico de propietario (roles/owner). De forma predeterminada, esta función de Identity and Access Management (IAM) incluye los permisos necesarios para tener 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). A fin de 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, es decir, 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 página Configuración de App Hub.

    Ir a la configuración

  6. En la página Configuración, haz clic en Adjuntar 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 selecciona los que deseas agregar como proyectos de servicio.

  8. Haz clic en Seleccionar. En la tabla Connected Service Project(s), se muestran los proyectos de servicio seleccionados.

  9. Haz clic en Cerrar.

gcloud

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

  2. Asegúrate de tener 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 básico de propietario (roles/owner). De forma predeterminada, esta función de Identity and Access Management (IAM) incluye los permisos necesarios para tener 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). A fin de 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, la función 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 la función de administrador de App Hub en los proyectos de servicio a las personas que administran App Hub. Deben tener la función de administrador de App Hub para agregar proyectos de servicio al proyecto host. Necesitas al menos una persona con esta función 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 de 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

Crea una aplicación

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

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. Se mostrará el panel Create application.

  4. Selecciona una Región.

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

  6. En la sección Agregar atributos, ingresa el Nombre visible.

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

  8. Haz clic en Crear.

gcloud

  1. Crea una aplicación nueva 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 se pueden registrar servicios y cargas de trabajo de la misma región que la 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 caracteres alfanuméricos en minúscula sin espacios.
    • APPLICATION_DISPLAY_NAME: Es el nombre visible de tu aplicación.
    • REGION: Es la región de la aplicación. Asigna el valor us-east1.

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

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

  3. Obtén detalles sobre 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'

Actualiza una aplicación de App Hub existente

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 Editar en la aplicación que quieras actualizar.

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

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

    • Misión esencial
    • Alta
    • Versión mediana
    • Baja

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

  6. Opcional: Agrega los siguientes detalles requeridos para los propietarios desarrolladores, propietarios de operadores y 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, robert.smith@example.com.

  7. Repite estos pasos para cada desarrollador, operador y propietario de 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 \
  --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 una aplicación, un servicio o una carga de trabajo para las operaciones comerciales. 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, robert.smith@example.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 al siguiente:

    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, los servicios y las cargas de trabajo se registran como recursos de App Hub. Si usas 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: Servicio 3, Carga de trabajo 1 y Carga de trabajo 2.

  • El Proyecto de servicio 3 tiene tres recursos de infraestructura: Servicio 4, Carga de trabajo 3 y Carga de trabajo 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. Se mostrará la pestaña Servicios y cargas de trabajo con una lista de servicios y cargas de trabajo registrados que se encuentran en tus proyectos de servicio.

  3. Para cada servicio o carga de trabajo que desees registrar, haz lo siguiente:

    1. En la pestaña Servicios y cargas de trabajo, haz clic en Registrar servicio/carga de trabajo.
    2. En el panel Registrar servicio o carga de trabajo, en la sección Elegir servicio o 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 o la carga de trabajo.
    4. De manera 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 Cómo actualizar una aplicación existente de App Hub. Ten en cuenta que debes proporcionar uno de los valores especificados para los campos Importancia y Entorno, pero el valor puede ser diferente de los valores que estableciste cuando creaste la aplicación.
    5. Haz clic en Register.
    6. Actualiza la página para ver el Estado de registro del servicio o la carga de trabajo actualizado a Registered. Para obtener más información sobre los estados de registro, consulta las 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 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 en el proyecto de servicio 2, que está vinculado 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 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 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 deseas 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 estableces cuando creas 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 al siguiente:

    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 denotan 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 atributos de App Hub.

  7. Enumera los servicios detectados con reglas de reenvío en el proyecto de servicio 1 vinculado al proyecto host. Este comando muestra servicios que están 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 al siguiente:

    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 el proyecto de servicio 1 como un 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 del servicio del resultado del paso anterior.

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

  10. Actualiza un servicio con los atributos criticality-type y 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 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 para cada servicio es similar al siguiente:

    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

    Están registrados, pero los servicios separados se indican con un valor vacío en el campo SERVICE_REFERENCE.

  12. Filtra los servicios de la aplicación APPLICATION_NAME y del proyecto host de HOST_PROJECT_ID por aquellos en los que el atributo environment-type se estableció en 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.

Agrega o quita proyectos de servicio

Puedes modificar los adjuntos de proyectos de servicio para poner a disposición diferentes recursos de infraestructura y agruparlos 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 o, en la lista que se muestra, 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 vinculados, se muestran los proyectos seleccionados como los proyectos de servicio para el 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 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 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 ver las aplicaciones de un proyecto y enumerar los servicios y las cargas de trabajo de una aplicación.

Console

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

    Ir a Aplicaciones

  • Para enumerar servicios y 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 servicios y cargas de trabajo registrados en tu 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 Alta como el valor.
        Aparecerá una lista de servicios y cargas de trabajo de alta importancia que está 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 las cargas de trabajo de los proyectos de servicio vinculados que están asociados con 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.
        Aparecerá 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 mostrar una lista de los servicios registrados en una aplicación, haz lo siguiente:

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 del 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, en la sección Servicios y cargas de trabajo registrados, haz clic en el nombre del servicio o la carga de trabajo para los que deseas cancelar el registro.
    2. En la página que se abre para el servicio o la carga de trabajo registrados, haz clic en Cancelar registro para actualizar el servicio o la carga de trabajo como un recurso Descubre.
      En la pestaña Servicios y cargas de trabajo, una alerta notifica que la carga de trabajo no está registrada.
    3. Repite estas instrucciones para cada servicio y carga de trabajo.

  4. Ve a la página Aplicaciones de App Hub.

    Ir a Aplicaciones

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

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

  7. En este documento, usa las instrucciones que se indican en Agrega o quita proyectos de servicio para quitar los proyectos de servicio de tu proyecto host.

gcloud

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

  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 restantes de la aplicación.

  4. Genera 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 de la aplicación:

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

    Ahora el servicio es detectado y se puede registrar en la aplicación.

  6. Repite el comando anterior para cancelar el registro de los servicios registrados restantes 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?