Crea una aplicación de App Hub con un solo proyecto

Console

Para obtener los permisos que necesitas para completar este instructivo, pídele a tu administrador que te otorgue los roles de IAM necesarios en tu proyecto:

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

   Ir a IAM

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

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

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

5. Selecciona el rol Administrador de App Hub.

6. Haz clic en Agregar otra función y, en la lista Selecciona una función, selecciona Visualizador de supervisión.

7. Haz clic en Guardar.

gcloud

1. Para otorgar los roles a las personas que usarán App Hub, repite el siguiente comando y reemplaza los roles de IAM según sea necesario. Para obtener más información, consulta Roles y permisos de App Hub.

   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, 222larabrown@gmail.com.

2. Otorga el rol de administrador de App Hub en el proyecto de servicio a las personas que administran App Hub. Debe tener el rol de administrador de App Hub para agregar proyectos de servicio al proyecto host. Necesitas al menos una persona con este rol para cada proyecto de servicio. En este ejemplo, el proyecto host actúa como el proyecto de servicio.

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

   Reemplaza SERVICE_PROJECT_ID por el nombre del HOST_PROJECT_ID.

3. Otorga el rol de Visualizador de supervisión en el proyecto host a las personas que administran App Hub. Para ver las métricas, debe tener el rol de Visualizador de supervisión en el proyecto host.

   gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \
      --member='user:HOST_PROJECT_ADMIN' \
      --role='roles/monitoring.viewer'

Console

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

   Ir a la configuración

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

3. En el panel que se abre, busca proyectos en la lista que se muestra y selecciona las casillas de verificación de los proyectos de servicios de App Hub.

4. Haz clic en Seleccionar. En la tabla Proyectos de servicio adjuntos, se muestra el proyecto host seleccionado como el proyecto de servicio.

5. Haz clic en Cerrar.

gcloud

Agrega tu proyecto host como el proyecto de servicio al proyecto host de App Hub.

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

Console

1. Asegúrate de que estás en el proyecto host de App Hub.

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

   Ir a Aplicaciones

3. Haz clic en Crear aplicación.

4. En la página Crear aplicación, en el panel Elige el nombre y la región de la aplicación, selecciona Regional.

5. En la lista Región, selecciona us-west1.

6. En el campo Nombre de la aplicación, ingresa tutorial-application. Este nombre es un identificador único y es inmutable después de crear la aplicación.

7. Ingresa un Nombre visible, Tutorial, y haz clic en Continuar. Es un nombre fácil de usar que puedes actualizar. Para obtener más información, consulta Actualiza una aplicación existente.

8. En el panel Agregar atributos, en la lista Criticidad, selecciona Alta. La importancia indica qué tan importante es una aplicación, un servicio o una carga de trabajo para las operaciones de tu empresa.

9. En el campo Entorno, para indicar la etapa del ciclo de vida del software, selecciona Producción.

10. Haga clic en Continuar.

11. En el panel Agregar propietarios, agrega los siguientes detalles 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.

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

13. Haz clic en Crear.

Se creará la nueva aplicación y aparecerá en la página Aplicaciones.

gcloud

1. Selecciona el proyecto host de App Hub que creaste:

   gcloud config set project HOST_PROJECT_ID

2. Crea una aplicación nueva llamada tutorial-application en la región us-west1 y asígnale un nombre visible, Tutorial. Este nombre de aplicación, tutorial-application, es un identificador único y es inmutable después de crear la aplicación. El nombre visible,Tutorial, es un nombre fácil de usar que puedes actualizar. Para obtener más información, consulta Actualiza una aplicación existente.

   gcloud apphub applications create tutorial-application \
       --display-name='Tutorial' \
       --scope-type=REGIONAL \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

3. Enumera las aplicaciones de tu proyecto host de App Hub:

   gcloud apphub applications list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Verás un resultado similar al siguiente:

   ID                    DISPLAY_NAME  CREATE_TIME
   tutorial-application  Tutorial      2023-10-31T18:33:48
   

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

   gcloud apphub applications update tutorial-application \
     --criticality-type='HIGH' \
     --environment-type='PRODUCTION' \
     --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=us-west1
   

   Reemplaza lo siguiente:

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

   Notas:

   • criticality-type: Indica qué tan importante es una aplicación, un servicio o una carga de trabajo para las operaciones de tu empresa.
   • environment-type: Indica las etapas del ciclo de vida del software.

5. Obtén detalles de la aplicación que creaste:

   gcloud apphub applications describe tutorial-application \
     --project=HOST_PROJECT_ID \
     --location=us-west1
   

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

   attributes:
   businessOwners:
   – displayName: [DISPLAY-NAME-BUSINESS]
     email: [EMAIL-BUSINESS]
   criticality:
     type: HIGH
   developerOwners:
   – displayName: [DISPLAY-NAME-DEVELOPER]
     email: [EMAIL-DEVELOPER]
   environment:
     type: PRODUCTION
   operatorOwners:
   – displayName: [DISPLAY-NAME-OPERATOR]
     email: [EMAIL-OPERATOR]
   createTime: '2023-10-31T18:33:48.199394108Z'
   displayName: Tutorial
   name: projects/HOST_PROJECT_ID/locations/us-west1/applications/tutorial-application
   scope:
     type: REGIONAL
   state: ACTIVE
   uid: 9d991a9d-5d8a-4c0d-b5fd-85e39fb58c73
   updateTime: '2023-10-31T18:33:48.343303819Z'
   

Console

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

   Ir a Aplicaciones

2. Haz clic en el nombre de tu aplicación, Instructivo. 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 App Hub.

3. Registra un servicio:

   1. En la pestaña Servicios y cargas de trabajo, haz clic en Registrar servicio o carga de trabajo.
   2. En la página Registrar servicio o carga de trabajo, en el panel Seleccionar recurso, haz clic en Explorar para seleccionar el servicio o la carga de trabajo como Recurso.
   3. En el panel Seleccionar recurso, elige el Nombre del servicio, l7-xlb-backend-service, y haz clic en Seleccionar.
   4. En el panel Seleccionar recurso, ingresa el Nombre del recurso, tutorial-service-backend.
   5. Ingresa un Nombre visible, Backend service, y haz clic en Continuar.
   6. En el panel Agregar atributos, en la lista Criticidad, para indicar la importancia de la aplicación, selecciona Alta.
   7. En el campo Entorno, para indicar la etapa del ciclo de vida del software, selecciona Producción.
   8. Haga clic en Continuar.
   9. En el panel Agregar propietarios, 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.
   10. Repite estos pasos para cada desarrollador, operador y propietario de la empresa.
   11. Haz clic en Register.

   En la pestaña Servicios y cargas de trabajo, en la sección Servicios y cargas de trabajo registrados, puedes ver el servicio nuevo que agregaste.

4. Repite los pasos anteriores para registrar los otros servicios como tutorial-service-forwarding-rule y tutorial-service-url-map, respectivamente.

5. Para registrar una carga de trabajo, repite los pasos anteriores para registrar un servicio con las siguientes excepciones:

   1. En el panel Register service or workload, en la sección Choose service or workload, selecciona el Nombre de la carga de trabajo, l7-xlb-backend-example, y haz clic en Continue.
   2. En el panel Seleccionar recurso, ingresa el Nombre del recurso, tutorial-workload-mig.
   3. Ingresa un Nombre visible, Workload instance group, y haz clic en Continuar. En la pestaña Servicios y cargas de trabajo, en la sección Servicios y cargas de trabajo registrados, puedes ver la carga de trabajo nueva que se agregó.

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 de App Hub. Este valor tiene el formato username@yourdomain, por ejemplo, 222larabrown@gmail.com.

2. Muestra una lista de todos los servicios descubiertos en el proyecto host de App Hub. Este comando muestra los servicios disponibles para registrarse en una aplicación.

   gcloud apphub discovered-services list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Verás un resultado similar al siguiente:

   ID                             SERVICE_REFERENCE                                                                                                              SERVICE_PROPERTIES
   BACKEND_SERVICE_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   FORWARDING_RULE_SERVICE_ID" {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   URL_MAP_SERVICE_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}             {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
   

   Copia los ID del servicio, por ejemplo, BACKEND_SERVICE_SP2_ID, del resultado para usarlos en el siguiente paso.

3. Registra los servicios del paso anterior en tu aplicación. Copia los IDs de servicio del campo de salida del paso anterior.

   gcloud apphub applications services create tutorial-service-backend \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/BACKEND_SERVICE_ID' \
       --display-name='Backend service' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   gcloud apphub applications services create tutorial-service-forwarding-rule \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/FORWARDING_RULE_SERVICE_ID' \
       --display-name='Forwarding rule' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   gcloud apphub applications services create tutorial-service-url-map \
       --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/URL_MAP_SERVICE_ID' \
       --display-name='URL map' \
       --criticality-type='HIGH' \
       --environment-type='PRODUCTION' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Reemplaza lo siguiente:

   • BACKEND_SERVICE_ID: El servicio ID del servicio de backend que deseas registrar.
   • FORWARDING_RULE_SERVICE_ID: El servicio ID de la regla de reenvío que deseas registrar.
   • URL_MAP_SERVICE_ID: Es el servicio ID del mapa de URL que deseas registrar.

4. Enumera todos los servicios registrados en la aplicación.

   gcloud apphub applications services list \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Verás un resultado similar al siguiente:

   ID                               DISPLAY_NAME      SERVICE_REFERENCE                                                                                                              CREATE_TIME
   tutorial-service-backend         Backend service   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}  2024-02-13T00:31:45
   tutorial-service-forwarding-rule Forwarding rule   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}  2024-02-13T00:31:45
   tutorial-service-url-map         URL map           {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}             2024-02-13T00:31:45
   

   Los servicios registrados, pero separados, se indican con un valor vacío en el campo SERVICE_REFERENCE. Para obtener más información sobre los estados de registro, consulta las propiedades y los atributos de App Hub.

5. Enumera todas las cargas de trabajo descubiertas en el proyecto host de App Hub. Este comando muestra las cargas de trabajo disponibles para registrarse en una aplicación.

   gcloud apphub discovered-workloads list \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Verás un resultado similar al siguiente:

   ID                            WORKLOAD_REFERENCE                                                                                                            WORKLOAD_PROPERTIES
   INSTANCE_GROUP_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1', 'zone': 'us-west1-a'}
   

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

6. Registra la carga de trabajo del paso anterior en tu aplicación como tutorial-workload-mig. Copia el ID de la carga de trabajo del campo de salida del paso anterior.

   gcloud apphub applications workloads create tutorial-workload-mig \
       --discovered-workload='projects/HOST_PROJECT_ID/locations/us-west1/discoveredWorkloads/WORKLOAD_ID' \
       --display-name='Workload instance group' \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Reemplaza WORKLOAD_ID por el ID de la carga de trabajo que deseas registrar.

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

   gcloud apphub applications workloads list \
       --application=tutorial-application \
       --project=HOST_PROJECT_ID \
       --location=us-west1
   

   Verás un resultado similar al siguiente:

   ID                        DISPLAY_NAME              WORKLOAD_REFERENCE                                                                                                            CREATE_TIME
   tutorial-workload-mig     Workload instance group   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}  2024-02-13T00:31:45
   

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