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 deseas 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 obligatorios
Para obtener los permisos que necesitas para modificar los recursos de App Hub, pídele a tu administrador que te otorgue los siguientes roles de IAM en la carpeta habilitada para apps:
-
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
)
-
Administrador de App Hub (
-
Para ver las aplicaciones, los servicios y las cargas de trabajo, y sus atributos, usa el Visualizador de App Hub (
roles/apphub.viewer
). -
Para ver las aplicaciones, los servicios y las cargas de trabajo, y sus atributos en Google Cloud servicios que admiten la administración de aplicaciones:
Visualizador de administración de App Hub (
roles/apphub.appManagementViewer
)
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 mediante roles personalizados o cualquier otro rol predefinido.
Cómo enumerar aplicaciones
Puedes enumerar y filtrar aplicaciones en una carpeta habilitada para apps.
Console
Para ver las aplicaciones en una carpeta habilitada para apps, en la consola de Google Cloud, ve a la página Aplicaciones de App Hub.
Para filtrar aplicaciones, haz lo siguiente:
- En el campo Filtro, selecciona un filtro, como Gravedad.
- Especifica un valor para el filtro. Por ejemplo, para mostrar aplicaciones con alta criticidad, selecciona Alta como valor.
Aparecerá una lista de aplicaciones que coincidan con el filtro especificado.
gcloud
Para ver las aplicaciones en una carpeta habilitada para apps, haz lo siguiente:
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) 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 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, asígnale el valorglobal
o la región de la aplicación, por ejemplo,us-east1
. Para obtener más información sobre cómo configurar el--scope-type
de la aplicación, consulta Cómo crear una aplicación.
Para filtrar las aplicaciones según los atributos de las variables, usa la marca
--filter
. Por ejemplo, para enumerar todas las aplicaciones en las que el atributoenvironment-type
está configurado comoPRODUCTION
, 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.
En la lista de aplicaciones, haz clic en la aplicación cuyos detalles deseas conocer.
Haz clic en la pestaña Detalles para mostrar los detalles de la solicitud.
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 solo debe incluir caracteres alfanuméricos en minúscula sin espacios.
Cómo actualizar una aplicación de App Hub
Puedes actualizar los atributos de tu aplicación después de crearla.
Console
En la consola de Google Cloud, ve a la página Aplicaciones de App Hub.
En la lista de aplicaciones, haz clic en
Editar para la aplicación que quieres 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 solo debe incluir caracteres alfanuméricos en minúsculas 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 las operaciones de tu empresa. 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
yDISPLAY-NAME-BUSINESS
: Son los nombres visibles del desarrollador, el operador y los propietarios de la empresa, respectivamente.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
yEMAIL-NAME-BUSINESS
: direcciones de correo electrónico del desarrollador, el operador y los propietarios de la empresa, respectivamente. Estos valores deben tener el formatousername@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:
En la consola de Google Cloud, ve a la página Servicios y cargas de trabajo de App Hub.
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:
- En el campo Filtro, selecciona un filtro, como Entorno.
- Especifica un valor para el filtro. Por ejemplo, para ver los servicios y las cargas de trabajo en producción, selecciona Producción como valor.
Aparecerá una lista de servicios y cargas de trabajo que coinciden con el filtro especificado.
gcloud
Cómo enumerar los servicios descubiertos
Los servicios descubiertos están disponibles para registrarse en una aplicación.
Para enumerar los servicios descubiertos, 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 descubiertos. Por ejemplo, parafiltrar los servicios descubiertos con reglas de reenvío en lacarpeta 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
Muestra una lista de los servicios registrados de App Hub y fíltralos desde una aplicación.
Para enumerar los servicios registrados en una aplicación, sigue estos pasos:
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
se establece enPRODUCTION
, haz lo siguiente:gcloud apphub applications services list \ --filter='attributes.environment.type=PRODUCTION' \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Cómo enumerar 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, sigue estos pasos:
gcloud apphub discovered-workloads list \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Verás un resultado similar al siguiente, que incluye MIG no registradas:
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 descubiertas. Por ejemplo, para filtrar la lista de cargas de trabajo descubiertas con recursos de procesamiento en una carpeta habilitada para apps, haz lo siguiente:
gcloud apphub discovered-workloads list \ --filter='workload_reference.uri~"compute"' --project=MANAGEMENT_PROJECT_ID \ --location=REGION
Cómo enumerar 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, sigue estos pasos:
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
se establece enPRODUCTION
, 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.
Haz clic en el nombre de tu aplicación.
En la pestaña Servicios y cargas de trabajo, se muestra 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:
- En la pestaña Servicios y cargas de trabajo, haz clic en more_vert para el servicio o la carga de trabajo que deseas actualizar y, luego, en Editar servicio o Editar carga de trabajo.
- 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 un 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 las operaciones de tu empresa. 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
yDISPLAY-NAME-BUSINESS
: Son los nombres visibles del desarrollador, el operador y los propietarios de la empresa, respectivamente.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
yEMAIL-NAME-BUSINESS
: direcciones de correo electrónico del desarrollador, el operador y los propietarios de la empresa, respectivamente. Estos valores deben tener el formatousername@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 las operaciones de tu empresa. 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
yDISPLAY-NAME-BUSINESS
: Son los nombres visibles del desarrollador, el operador y los propietarios de la empresa, respectivamente.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
yEMAIL-NAME-BUSINESS
: direcciones de correo electrónico del desarrollador, el operador y los propietarios de la empresa, respectivamente. Estos valores deben tener el formatousername@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 las cargas de trabajo y los servicios registrados en la aplicación.
Console
En la consola de Google Cloud, ve a la página Aplicaciones de App Hub.
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
- 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 el registro.
- En la página del servicio o la carga de trabajo registrada que se abre, haz clic en Desregistrar para actualizar el servicio o la carga de trabajo como un recurso Desconocido. En la pestaña Servicios y cargas de trabajo, una alerta notifica que la carga de trabajo no está registrada.
- Repite estas instrucciones para cada servicio y carga de trabajo.
Ve a la página Aplicaciones de App Hub.
Haz clic en el nombre de una aplicación.
En la página con los detalles de la solicitud, haz clic en Borrar.
gcloud
Muestra una lista de 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 de la aplicación:
gcloud apphub applications services delete SERVICE_NAME \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
El servicio ahora es un servicio descubierto que se puede registrar en la aplicación.
Repite el comando anterior para anular el registro de los servicios registrados que queden 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 de 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 que queden de la aplicación.
Borra la aplicación:
gcloud apphub applications delete APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
¿Qué sigue?
- Configura la supervisión de aplicaciones
- Funciones y permisos de IAM de App Hub
- Descripción general de App Hub
- Soluciona problemas