Configura App Hub para las carpetas habilitadas para apps

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Console

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

   Ir a IAM

2. Asegúrate de que el selector de proyectos en la barra de navegación superior muestre la carpeta habilitada para apps. El selector de alcance te permite saber en qué organización, carpeta o proyecto estás trabajando. Si no estás en la carpeta habilitada para la app, sigue estos pasos para seleccionar una:

   1. En el selector de alcance, haz clic en la opción seleccionada.
   2. En el cuadro de diálogo Seleccionar un recurso, realiza una de las siguientes acciones:
      • En la lista de carpetas, selecciona la carpeta FOLDER_DISPLAY_NAME.
      • Busca la carpeta FOLDER_DISPLAY_NAME y selecciónala.

3. En la página IAM, haz clic en person_addOtorgar acceso. Se abrirá el panel Otorgar acceso.

4. En el campo Principales nuevas, ingresa la dirección de correo electrónico de la persona responsable de administrar App Hub, el rol de administrador de App Hub en la carpeta habilitada para aplicaciones.

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

6. Selecciona el rol Administrador de App Hub y haz clic en Guardar.

7. Repite los pasos para otorgar el rol de Visualizador de administración de apps a las personas para que vean los datos de la aplicación y sus atributos en todos losGoogle Cloud servicios que admiten la administración de aplicaciones. Este rol se otorga a la persona en todos los proyectos y subcarpetas de la carpeta habilitada para la app.

8. Haz clic en Guardar.

gcloud

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

   Activate Cloud Shell

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

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

   gcloud components update

3. Otórgales a las personas que administrarán App Hub el rol de administrador de App Hub en la carpeta habilitada para apps. Repite el siguiente comando para cada administrador. Debe tener el rol de administrador de App Hub para crear aplicaciones.

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

   Reemplaza lo siguiente:

   • MANAGEMENT_PROJECT_ID: Es el ID del proyecto de administración en el formato google-mpf-FOLDER_ID. Puedes encontrar el ID de tu proyecto de administración en la página Configuración de Identity and Access Management (IAM) y administración de la consola de Google Cloud. Si no encuentras el ID del proyecto de administración, es posible que no estés en una carpeta habilitada para la app. En el selector de proyectos, selecciona tu carpeta habilitada para apps.
   • MANAGEMENT_PROJECT_ADMIN: El usuario que tiene el rol de administrador de App Hub en el proyecto. Este valor tiene el formato username@yourdomain, por ejemplo, robert.smith@example.com.

4. Otorga el rol de visor de administración de apps en la carpeta habilitada para apps a las personas para que vean los datos de la aplicación y sus atributos en los Google Cloud servicios que admiten la administración de aplicaciones. Este rol se otorga a la persona en todos los proyectos y subcarpetas de la carpeta habilitada para la app.

   gcloud resource-manager folders add-iam-policy-binding FOLDER_ID \
       --member='user:MANAGEMENT_PROJECT_ADMIN' \
       --role='roles/apphub.appManagementViewer'
   

   Reemplaza FOLDER_ID por el ID del proyecto. Puedes encontrar el ID de la carpeta habilitada por la app en la página Configuración de IAM y administración de la consola de Google Cloud. Para asegurarte de que la carpeta esté habilitada para la app, la página Configuración debería mostrar el ID del proyecto de Management. Si no encuentras el ID del proyecto de administración, es posible que no estés en una carpeta habilitada para la app. En el selector de proyectos, selecciona tu carpeta habilitada para apps.

Console

1. Asegúrate de estar en una carpeta habilitada para apps.

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 Create application, en el panel Choose application region and name, según el alcance de los servicios y las cargas de trabajo que deseas registrar en la aplicación, haz una de las siguientes acciones:

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

   • Para crear una aplicación que te permita registrar servicios y cargas de trabajo desde una sola ubicación, sigue estos pasos:

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

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

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

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

   • Fundamental
   • Alta
   • Mediano
   • Baja

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

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

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

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

11. Haz clic en Crear.

gcloud

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

   gcloud apphub applications create APPLICATION_NAME \
       --display-name='APPLICATION_DISPLAY_NAME' \
       --scope-type=SCOPE_TYPE \
       --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=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Reemplaza lo siguiente:

   • APPLICATION_NAME: El nombre de tu aplicación. El nombre solo debe incluir caracteres alfanuméricos en minúsculas sin espacios.
   • APPLICATION_DISPLAY_NAME: Es el nombre visible de tu aplicación.
   • SCOPE_TYPE: Es el alcance de tu aplicación que define qué servicios y cargas de trabajo están disponibles para que te registres en la aplicación. Usa uno de los siguientes valores:
     • REGIONAL
     • GLOBAL
   • CRITICALITY_LEVEL: (Opcional) Indica qué tan importante es una aplicación, un servicio o una carga de trabajo para las operaciones de tu empresa. Proporciona uno de los siguientes valores:
     • MISSION_CRITICAL
     • HIGH
     • MEDIUM
     • LOW
   • ENVIRONMENT: (Opcional) 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 (opcionales) 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 (opcionales) del desarrollador, el operador y los propietarios de la empresa, respectivamente. Estos valores deben tener el formato username@yourdomain, por ejemplo, 222larabrown@gmail.com.
   • MANAGEMENT_PROJECT_ID: Es el ID del proyecto de administración en el formato google-mpf-FOLDER_ID.
   • REGION: Es la región de la aplicación. Según el --scope-type, asígnale el valor us-east1 o global.

   Por ejemplo:

   gcloud apphub applications create my-application \
       --display-name='application-display-name' \
       --scope-type=REGIONAL \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --project=host-project \
       --location=us-east1
   

2. Genera una lista de las aplicaciones de tu carpeta habilitada para apps.

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

   El resultado es similar a este:

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

Console

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

   Ir a Aplicaciones

2. Haz clic en el nombre de tu aplicación. La pestaña Servicios y cargas de trabajo se muestra con una lista de los servicios y las cargas de trabajo registrados que se encuentran en la carpeta habilitada para tu app.

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

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

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

gcloud

1. Muestra una lista de los servicios descubiertos desde una carpeta habilitada para la app. En el siguiente comando, puedes especificar de manera opcional la marca filter para mostrar los servicios del proyecto especificado que están disponibles para registrarse en una aplicación.

   gcloud apphub discovered-services list \
       --filter='FILTER_RESOURCES' \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Reemplaza FILTER_RESOURCES por filtros como los siguientes:

   • service_properties.gcp_project=projects/PROJECT_ID
   • service_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules" El resultado es similar al siguiente:

   ID                           SERVICE_REFERENCE                                                                                                                    SERVICE_PROPERTIES
   [DISCOVERED_SERVICE_ID]    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/forwarding-rule'}     {'gcpProject': 'projects/PROJECT_1', 'location': 'REGION'}
   

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

2. Registra la regla de reenvío, forwarding-rule-name, en un proyecto como un servicio para tu aplicación.

   gcloud apphub applications services create SERVICE_NAME \
       --discovered-service='projects/MANAGEMENT_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE' \
       --display-name='SERVICE_DISPLAY_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=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Reemplaza lo siguiente:

   • SERVICE_NAME: Es un nombre para registrar el servicio.
   • DISCOVERED_SERVICE_ID: Es el ID de servicio del resultado del paso anterior.
   • SERVICE_DISPLAY_NAME: Es el nombre visible de tu aplicación.

   Notas:

   • criticality-type y environment-type: (opcional) Debes proporcionar uno de los valores especificados, pero estos pueden ser diferentes de los valores que estableciste cuando creaste la aplicación. Para obtener más información, consulta Crea una aplicación en este documento.
   • developer-owners,operator-owners y business-owners: (opcional). Para obtener más información, consulta Crea una aplicación en este documento.

   Por ejemplo:

   gcloud apphub applications services create my-service \
       --display-name='mywebserver-service' \
       --application=my-application \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --folder=folder-ID \
       --location=us-east1
   

3. Muestra una lista de las cargas de trabajo descubiertas desde una carpeta habilitada para apps. En el siguiente comando, puedes especificar de manera opcional la marca filter para mostrar las cargas de trabajo del proyecto especificado que están disponibles para registrarse en una aplicación.

   gcloud apphub discovered-workloads list \
       --filter='FILTER_RESOURCES' \
       --project=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Reemplaza FILTER_RESOURCES por un filtro, como workload_properties.gcp_project=projects/PROJECT_ID.

   Verás un resultado similar al siguiente, que incluye un MIG no registrado:

   ID                           WORKLOAD_REFERENCE                                                                                                      WORKLOAD_PROPERTIES
   [DISCOVERED_WORKLOAD]   {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/mig-name'}     {'gcpProject': 'projects/PROJECT', 'location': 'REGION'}
   

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

4. Registra la MIG, mig-name, del proyecto como una carga de trabajo en tu aplicación.

   gcloud apphub applications workloads create WORKLOAD_NAME \
       --discovered-workload='projects/MANAGEMENT_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID' \
       --display-name=WORKLOAD_DISPLAY_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=MANAGEMENT_PROJECT_ID \
       --location=REGION
   

   Reemplaza lo siguiente:

   • WORKLOAD_NAME: Es un nombre para registrar la carga de trabajo.
   • DISCOVERED_WORKLOAD_ID: Es el ID de la carga de trabajo del resultado del paso anterior.
   • WORKLOAD_DISPLAY_NAME: Es el nombre visible de tu aplicación.

   Notas:

   • criticality-type y environment-type: (opcional) Debes proporcionar uno de los valores especificados, pero estos pueden ser diferentes de los valores que estableciste cuando creaste la aplicación. Para obtener más información, consulta Crea una aplicación en este documento.
   • developer-owners,operator-owners y business-owners: (opcional). Para obtener más información, consulta Crea una aplicación en este documento.

   Por ejemplo:

   gcloud apphub applications workloads create my-workload \
       --display-name='mywebserver-deployment1' \
       --application=my-application \
       --criticality-type='MEDIUM' \
       --environment-type='STAGING' \
       --developer-owners=display-name=developer-name,email=username@yourdomain \
       --folder=folder-ID \
       --location=us-east1
   

Console

Agrega un proyecto a una carpeta habilitada para apps

1. In the Google Cloud console, go to the project selector page.

   Go to project selector

2. Click Create project.

3. Name your project. Make a note of your generated project ID.

4. Edit the other fields as needed.

5. Click Create.

Quita un proyecto de una carpeta habilitada para apps

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

gcloud

Agrega un proyecto a una carpeta habilitada para apps

gcloud projects create PROJECT_ID \
    --folder FOLDER_ID

Quita un proyecto de una carpeta habilitada para apps

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID