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

Modificar recursos de App Hub

Puedes enumerar, ver, actualizar y borrar recursos de App Hub en una carpeta habilitada para aplicaciones con la Google Cloud consola o Google Cloud CLI en tu terminal o Cloud Shell.

Requisitos previos

Antes de modificar los recursos de App Hub, completa las siguientes tareas:

Sigue los requisitos previos para configurar App Hub.
Según el tipo de recurso que desees modificar, asegúrate de haber ejecutado los pasos para configurar App Hub. Para obtener más información, consulta Cómo configurar App Hub.

Roles requeridos

Para obtener los permisos que necesitas para modificar recursos de App Hub, pídele a tu administrador que te otorgue los siguientes roles de IAM en la carpeta habilitada para la app:

Para crear y actualizar aplicaciones, registrar y cancelar el registro de servicios y cargas de trabajo, y actualizar los atributos asociados, haz lo siguiente:
- Administrador de App Hub (roles/apphub.admin)
- Editor de App Hub (roles/apphub.editor)
Para ver las aplicaciones, los servicios y las cargas de trabajo, y sus atributos: Visualizador de App Hub (roles/apphub.viewer)
Para ver los datos a nivel de la aplicación y del proyecto en Cloud Hub, operador de Cloud Hub (roles/cloudhub.operator)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Enumera aplicaciones

Puedes enumerar y filtrar aplicaciones en una carpeta habilitada para apps.

Console

Para ver las aplicaciones en una carpeta habilitada para aplicaciones, en la consola deGoogle Cloud , ve a la página Aplicaciones de App Hub.

Ir a Aplicaciones
Verás una lista de aplicaciones.
Para filtrar aplicaciones, sigue estos pasos:
1. En el campo Filtro, selecciona un filtro, como Criticidad.
2. Especifica un valor para el filtro. Por ejemplo, para mostrar las aplicaciones con un nivel de criticidad alto, selecciona Alto como el valor.
  Aparecerá una lista de aplicaciones que coinciden con el filtro especificado.

gcloud

Sigue estos pasos para ver las aplicaciones en una carpeta habilitada para apps:
```
gcloud apphub applications list \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION
```
Reemplaza lo siguiente:
- MANAGEMENT_PROJECT_ID: Es el ID de tu proyecto de administración. Puedes encontrar el ID de tu proyecto de administración en la página Configuración de Identity and Access Management (IAM) 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 alcance (o selector de proyectos), selecciona tu carpeta habilitada para apps. Para obtener más información sobre cómo habilitar una carpeta para la administración de aplicaciones, consulta Habilita la administración de aplicaciones.
- REGION: Es la región de la aplicación. Según el --scope-type de la aplicación, asigna a este campo el valor global o la región de la aplicación, por ejemplo, us-east1. Para obtener más información sobre cómo configurar --scope-type para la aplicación, consulta Crea una aplicación.
Para filtrar las aplicaciones según los atributos de variables, usa la marca --filter. Por ejemplo, para enumerar todas las aplicaciones en las que el atributo environment-type está establecido en PRODUCTION, haz lo siguiente:
```
gcloud apphub applications list \
    --filter='attributes.environment.type=PRODUCTION' \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION
```

Cómo ver una solicitud

Puedes describir una aplicación en una carpeta habilitada para apps.

Console

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

Ir a Aplicaciones
En la lista de aplicaciones, haz clic en la aplicación cuyos detalles deseas conocer.
Haz clic en la pestaña Detalles para ver los detalles de la aplicación.

gcloud

gcloud apphub applications describe APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

Reemplaza APPLICATION_NAME por el nombre de la aplicación. El nombre debe incluir solo caracteres alfanuméricos en minúscula sin espacios.

Actualiza una aplicación de App Hub

Puedes actualizar los atributos de tu aplicación después de que se cree.

Console

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

Ir a Aplicaciones
En la lista de aplicaciones, haz clic en Editar en la aplicación que deseas actualizar.
Edita los campos según sea necesario.
Haz clic en Guardar.

gcloud

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=MANAGEMENT_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 espacios.
- REGION: Es la región de la aplicación.
Puedes actualizar cualquiera de las siguientes opciones:
- APPLICATION_DISPLAY_NAME: Indica el nombre visible de la aplicación.
- CRITICALITY_LEVEL: Indica qué tan importante es una aplicación, un servicio o una carga de trabajo para tus 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, 222larabrown@gmail.com.
Por ejemplo:
```
gcloud apphub applications update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1
```

Cómo ver servicios y cargas de trabajo

Puedes ver, enumerar y filtrar servicios y cargas de trabajo en una aplicación.

Console

Para enumerar los servicios y las cargas de trabajo, haz lo siguiente:
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 adjuntos asociados con us-east1.
Para filtrar los servicios o las cargas de trabajo, haz lo siguiente:
1. En el campo Filtro, selecciona un filtro, como Entorno.
2. Especifica un valor para el filtro. Por ejemplo, para ver los servicios y las cargas de trabajo en producción, selecciona Producción como el valor.
  Aparecerá una lista de servicios y cargas de trabajo que coinciden con el filtro especificado.

gcloud

Enumera los servicios detectados

Los servicios detectados están disponibles para registrarse en una aplicación.

Para enumerar los servicios detectados, haz lo siguiente:

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

Verás un resultado similar al siguiente:

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

Opcional: Filtra la lista de servicios detectados. Por ejemplo, para filtrar los servicios descubiertos con reglas de reenvío en la carpeta habilitada para la app, haz lo siguiente:
```
gcloud apphub discovered-services list \
    --filter='service_reference.uri~"forwardingRules"' \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION
```

Enumera los servicios registrados

Enumera y filtra los servicios registrados de App Hub desde una aplicación.

Para enumerar los servicios registrados en una aplicación, haz lo siguiente:

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

Verás un resultado similar al siguiente:

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

Los servicios registrados, pero separados, se indican con un valor vacío en el campo SERVICE_REFERENCE.

Opcional: Filtra la lista de servicios registrados. Por ejemplo, para filtrar los servicios registrados en una aplicación en la que el atributo environment-type está establecido en PRODUCTION, haz lo siguiente:
```
gcloud apphub applications services list \
    --filter='attributes.environment.type=PRODUCTION' \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION
```

Enumera las cargas de trabajo descubiertas

Las cargas de trabajo descubiertas están disponibles para registrarse en una aplicación.

Para enumerar las cargas de trabajo descubiertas, haz lo siguiente:

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

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

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

Opcional: Filtra la lista de cargas de trabajo detectadas. Por ejemplo, para filtrar la lista de cargas de trabajo descubiertas con recursos de procesamiento en una carpeta habilitada para aplicaciones, haz lo siguiente:
```
gcloud apphub discovered-workloads list \
    --filter='workload_reference.uri~"compute"'
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION
```

Enumera las cargas de trabajo registradas

Enumera y filtra las cargas de trabajo registradas de App Hub desde una aplicación.

Para enumerar las cargas de trabajo registradas en una aplicación, haz lo siguiente:

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

Verás un resultado similar al siguiente:

ID               DISPLAY_NAME               WORKLOAD_REFERENCE                                                                                                     CREATE_TIME
WORKLOAD_NAME    mywebserver-deployment1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    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 los estados de registro, consulta las propiedades y los atributos de App Hub.

Opcional: Filtra la lista de cargas de trabajo registradas. Por ejemplo, para filtrar las cargas de trabajo en una aplicación en la que el atributo environment-type está establecido en PRODUCTION, haz lo siguiente:
```
gcloud apphub applications workloads list \
    --filter='attributes.environment.type=PRODUCTION' \
    --application=APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION
```

Actualiza los servicios y las cargas de trabajo

Puedes actualizar los servicios y las cargas de trabajo que están registrados en una aplicación.

Console

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

Ir a Aplicaciones
Haz clic en el nombre de tu aplicación.
Se muestra la pestaña Servicios y cargas de trabajo con una lista de los servicios y las cargas de trabajo registrados que se encuentran en tus proyectos de servicio.
Para cada servicio o carga de trabajo que quieras actualizar, haz lo siguiente:
1. En la pestaña Servicios y cargas de trabajo, haz clic en more_vert y, luego, en Editar servicio o Editar carga de trabajo para el servicio o la carga de trabajo que deseas actualizar.
2. En el panel Editar servicio o Editar carga de trabajo, edita los campos según sea necesario y haz clic en Guardar.

gcloud

Actualiza tu servicio con los atributos criticality-type, environment-type y tipo de propietario:
```
gcloud apphub applications services update SERVICE_NAME \
    --application=APPLICATION_NAME \
    --display-name='SERVICE_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=MANAGEMENT_PROJECT_ID \
    --location=REGION
```
Reemplaza SERVICE_NAME por el nombre del servicio de App Hub.

Puedes actualizar cualquiera de las siguientes opciones:
- SERVICE_DISPLAY_NAME: Indica un nombre visible para el servicio.
- CRITICALITY_LEVEL: Indica qué tan importante es una aplicación, un servicio o una carga de trabajo para tus 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, 222larabrown@gmail.com.
Por ejemplo:
```
gcloud apphub applications workloads update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1
```
Actualiza tu carga de trabajo con los atributos criticality-type, environment-type y tipo de propietario:
```
gcloud apphub applications workloads update WORKLOAD_NAME \
    --application=APPLICATION_NAME \
    --display-name='WORKLOAD_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=MANAGEMENT_PROJECT_ID \
    --location=REGION
```
Reemplaza WORKLOAD_NAME por el nombre de la carga de trabajo de App Hub.

Puedes actualizar cualquiera de las siguientes opciones:
- WORKLOAD_DISPLAY_NAME: Indica un nombre visible para el servicio.
- CRITICALITY_LEVEL: Indica qué tan importante es una aplicación, un servicio o una carga de trabajo para tus 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, 222larabrown@gmail.com.
Por ejemplo:
```
gcloud apphub applications workloads update my-application \
    --criticality-type='MEDIUM' \
    --environment-type='STAGING' \
    --developer-owners=display-name=developer-name,email=username@yourdomain \
    --project=google-mpf-FOLDER-ID \
    --location=us-east1
```

Borra aplicaciones, servicios y cargas de trabajo

Borra una aplicación existente para quitar los recursos registrados asociados con la carpeta habilitada para la app. Para ello, primero debes cancelar el registro de los servicios y las cargas de trabajo registrados en la aplicación.

Console

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

Ir a Aplicaciones
Haz clic en el nombre de una aplicación. Aparecerá una lista de los servicios y las cargas de trabajo registrados en la aplicación.
Cancelar 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 que deseas anular.
2. En la página del servicio o la carga de trabajo registrados que se abre, haz clic en Anular registro para actualizar el servicio o la carga de trabajo como un recurso Descubierto. 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.
Ve a la página Applications de App Hub.

Ir a Aplicaciones
Haz clic en el nombre de una aplicación.
En la página con los detalles de la aplicación, haz clic en Borrar.

gcloud

Enumera los servicios registrados en la aplicación:

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

Cancela el registro del servicio en la aplicación:

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

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

Repite el comando anterior para cancelar el registro de los servicios registrados restantes en la aplicación.

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

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

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

Borra la aplicación:

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

Modificar recursos de App Hub Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Requisitos previos

Roles requeridos

Enumera aplicaciones

Console

gcloud

Cómo ver una solicitud

Console

gcloud

Actualiza una aplicación de App Hub

Console

gcloud

Cómo ver servicios y cargas de trabajo

Console

gcloud

Enumera los servicios detectados

Enumera los servicios registrados

Enumera las cargas de trabajo descubiertas

Enumera las cargas de trabajo registradas

Actualiza los servicios y las cargas de trabajo

Console

gcloud

Borra aplicaciones, servicios y cargas de trabajo

Console

gcloud

¿Qué sigue?

Modificar recursos de App Hub