Cuando configuras App Hub, creas un límite administrativo para tus aplicaciones. Este límite es el proyecto de administración o la colección de proyectos host y de servicio que configuraste para la administración de aplicaciones, según tu modelo de configuración. Los servicios y las cargas de trabajo se registran como aplicaciones dentro de este límite administrativo.
Para evitar la desviación de la configuración y mantener una fuente de confianza clara, te recomendamos que administres los recursos de tu aplicación en el entorno en el que se definieron originalmente:
Para las aplicaciones implementadas desde una plantilla de Application Design Center: Usa Application Design Center para administrar y actualizar la aplicación. Puedes revisar la plantilla para realizar cambios en el diseño de la aplicación o crear una revisión de la aplicación para actualizar la configuración, como los detalles de la aplicación y los componentes.
Para las aplicaciones creadas registrando recursos en App Hub: Administra la aplicación, sus servicios y cargas de trabajo directamente en App Hub.
En esta página, se describe cómo administrar las aplicaciones que se registraron directamente en App Hub. Puedes realizar estas acciones con la Google Cloud consola o Google Cloud CLI. Para las aplicaciones implementadas desde una plantilla, consulta la documentación de App Design Center.
Antes de comenzar
Antes de poder enumerar, ver, actualizar y borrar aplicaciones en App Hub, completa los siguientes pasos:
- Configura App Hub con uno de los modelos de configuración admitidos.
- Crea una aplicación y registra los recursos compatibles en la aplicación que deseas administrar.
Roles requeridos
Para obtener los permisos que necesitas para administrar aplicaciones en App Hub, pídele a tu administrador que te otorgue los siguientes roles de IAM en el límite administrativo de la aplicación de tu modelo de configuración (el proyecto de administración o los proyectos host y de servicio) :
-
Actualizar y borrar aplicaciones:
Editor de App Hub (
roles/apphub.editor
) -
Ver aplicaciones:
Visualizador de App Hub (
roles/apphub.viewer
)
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.
Para obtener más información sobre los roles de App Hub, consulta Roles y permisos de IAM de App Hub.
Enumera aplicaciones
Sigue estos pasos para enumerar y filtrar todas las aplicaciones dentro del límite administrativo de tu App Hub:
Console
En la página Welcome de la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración o proyecto host:
Navega a la página Aplicaciones de App Hub:
En la página, se muestra una lista de tus aplicaciones.
Para filtrar la lista, usa el campo Filtro. Puedes filtrar por atributos como Criticidad o Entorno.
gcloud
Encuentra el ID del proyecto de tu proyecto de administración o proyecto host.
Muestra una lista de tus aplicaciones con una de las siguientes opciones:
Enumera todas las aplicaciones:
gcloud apphub applications list \ --project=PROJECT_ID \ --location=LOCATION
Reemplaza lo siguiente:
PROJECT_ID
: Es el ID de tu proyecto host o proyecto de administración.LOCATION
: Es la ubicación de tus aplicaciones. Usaglobal
para aplicaciones globales o una región específica, comous-east1
, para aplicaciones regionales.
Filtra la lista de aplicaciones según los atributos con la marca
--filter
:gcloud apphub applications list \ --project=PROJECT_ID \ --location=LOCATION \ --filter=FILTER_EXPRESSION \
Reemplaza lo siguiente:
PROJECT_ID
: Es el ID de tu proyecto host o proyecto de administración.LOCATION
: Es la ubicación de tus aplicaciones. Usaglobal
para aplicaciones globales o una región específica, comous-east1
, para aplicaciones regionales.FILTER_EXPRESSION
: Es la expresión de filtro para especificar atributos. Por ejemplo, para enumerar todas las aplicaciones con un tipo de entornoPRODUCTION
, usaattributes.environment.type=PRODUCTION
.
Ver detalles de la solicitud
Sigue estos pasos para ver la información detallada de una aplicación específica, incluidos sus atributos y metadatos:
Console
En la página Welcome de la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración o proyecto host:
Navega a la página Aplicaciones de App Hub:
En la página, se muestra una lista de tus aplicaciones.
Haz clic en el nombre de la aplicación que deseas ver.
Se muestra la pestaña Detalles de la aplicación.
gcloud
Encuentra el ID del proyecto de tu proyecto de administración o proyecto host.
Describe una aplicación:
gcloud apphub applications describe APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION
Reemplaza lo siguiente:
APPLICATION_NAME
: El nombre de tu aplicación. Especificas este valor cuando creas una aplicación.PROJECT_ID
: Es el ID de tu proyecto host o proyecto de administración.LOCATION
: Es la ubicación de tu aplicación. Usaglobal
para aplicaciones globales o una región específica, comous-east1
, para aplicaciones regionales.
Actualiza los atributos de la aplicación
Sigue estos pasos para modificar los atributos definidos por el usuario de una aplicación después de que se haya creado:
Console
En la página Welcome de la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración o proyecto host:
Navega a la página Aplicaciones de App Hub:
En la página, se muestra una lista de tus aplicaciones.
En la aplicación que quieras actualizar, haz clic en
Editar.En el panel Editar aplicación, modifica los campos según sea necesario.
Haz clic en Guardar.
gcloud
Encuentra el ID del proyecto de tu proyecto de administración o proyecto host.
Actualiza los atributos de la aplicación. Puedes actualizar cualquiera de los atributos mutables, como
display-name
,criticality-type
,environment-type
y los propietarios:gcloud apphub applications update APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION \ --display-name=DISPLAY_NAME \ --criticality-type=CRITICALITY_LEVEL \ --environment-type=ENVIRONMENT \ --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \ --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \ --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
Reemplaza lo siguiente:
- Obligatorio:
APPLICATION_NAME
: El nombre de tu aplicación. Especificas este valor cuando creas una aplicación. - Obligatorio:
PROJECT_ID
: ID de tu proyecto host o proyecto de administración. - Obligatorio:
LOCATION
: Es la ubicación de tu aplicación. Usaglobal
para aplicaciones globales o una región específica, comous-east1
, para aplicaciones regionales. - Opcional:
DISPLAY_NAME
: Es el nombre visible de tu aplicación. Opcional:
CRITICALITY_LEVEL
: Es el nivel de importancia de la aplicación. Usa uno de los siguientes valores:MISSION_CRITICAL
HIGH
MEDIUM
LOW
Opcional:
ENVIRONMENT
es la etapa del ciclo de vida del software. Usa uno de los siguientes valores:PRODUCTION
STAGING
DEVELOPMENT
TEST
Opcional:
DEV_NAME
yDEV_EMAIL
: El nombre visible y la dirección de correo electrónico del propietario desarrollador, respectivamente.Opcional:
OPERATOR_NAME
yOPERATOR_EMAIL
: El nombre visible y la dirección de correo electrónico del propietario del operador, respectivamente.Opcional:
BUSINESS_NAME
yBUSINESS_EMAIL
: El nombre visible y la dirección de correo electrónico del propietario de la empresa, respectivamente.
- Obligatorio:
Cómo borrar una aplicación
Antes de borrar una aplicación, primero debes cancelar el registro de todos sus servicios y cargas de trabajo asociados. Luego, sigue estos pasos para borrar la aplicación:
Console
En la página Welcome de la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración o proyecto host:
Navega a la página Aplicaciones de App Hub:
En la página, se muestra una lista de tus aplicaciones.
Haz clic en el nombre de la aplicación que deseas borrar.
Ve a la pestaña Servicios y cargas de trabajo y asegúrate de haber anulado el registro de todos los recursos asociados de la aplicación. Para obtener más información, consulta Cómo anular el registro de servicios y cargas de trabajo.
Después de anular el registro de todos los servicios y cargas de trabajo, vuelve a los detalles de la aplicación y haz clic en Borrar.
gcloud
Encuentra el ID del proyecto de tu proyecto de administración o proyecto host.
Asegúrate de haber anulado el registro de todos los recursos asociados a la aplicación. Para obtener más información, consulta Cómo anular el registro de servicios y cargas de trabajo.
Después de que la aplicación no tenga recursos registrados, bórrala:
gcloud apphub applications delete APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION
Reemplaza lo siguiente:
APPLICATION_NAME
: El nombre de tu aplicación. Especificas este valor cuando creas una aplicación.PROJECT_ID
: Es el ID de tu proyecto host o proyecto de administración.LOCATION
: Es la ubicación de tu aplicación. Usaglobal
para aplicaciones globales o una región específica, comous-east1
, para aplicaciones regionales.
¿Qué sigue?
- Administra servicios y cargas de trabajo
- Cómo optimizar una aplicación con recomendaciones de diseño
- Supervisa tus aplicaciones