Administrar servicios y cargas de trabajo

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.

  Ir a Application Design Center

• Para las aplicaciones creadas registrando recursos en App Hub: Administra la aplicación, sus servicios y cargas de trabajo directamente en App Hub.

  Ir a App Hub

En esta página, se describe cómo administrar los servicios y las cargas de trabajo que se descubren o registran directamente en App Hub como aplicaciones. Puedes realizar estas acciones con la consola de Google Cloud o Google Cloud CLI. Para las aplicaciones implementadas a partir de una plantilla, consulta la documentación de Application Design Center.

Antes de comenzar

Antes de ver, actualizar y anular el registro de servicios y cargas de trabajo en App Hub, completa los siguientes pasos:

1. Configura App Hub con uno de los modelos de configuración admitidos.
2. Registra recursos admitidos en una aplicación.

Roles requeridos

Para obtener los permisos que necesitas para administrar servicios y cargas de trabajo 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 de host y servicio):

• Actualiza y anula el registro de servicios y cargas de trabajo: Editor de App Hub (roles/apphub.editor)
• Para ver servicios y cargas de trabajo: 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.

Consulta los detalles de los servicios y las cargas de trabajo

Sigue estos pasos para ver los detalles de los servicios y las cargas de trabajo, incluida su ubicación y el estado de registro en una aplicación, dentro del límite administrativo de App Hub:

Console

Consulta los detalles de los servicios y las cargas de trabajo registrados o desvinculados de una aplicación:

1. En la página Welcome de la consola de Google Cloud , usa el selector de proyectos para elegir tu proyecto de administración o proyecto host:

   Ir a Bienvenida

2. Navega a la página Aplicaciones de App Hub:

   Ir a Aplicaciones

   En la página, se muestra una lista de tus aplicaciones.

3. Haz clic en el nombre de la aplicación desde la que deseas ver los servicios o las cargas de trabajo.

4. En la pestaña Servicios y cargas de trabajo, haz clic en el nombre del servicio o la carga de trabajo que deseas ver.

5. En la página Detalles del recurso, puedes consultar detalles como el nombre visible, la ubicación, el estado de registro y los atributos.

También puedes ver una lista de todos los servicios y cargas de trabajo con un valor de estado de registro de discovered o registered:

1. Navega a la página Servicios y cargas de trabajo de App Hub:

   Ir a Servicios y cargas de trabajo

   En la página, se muestra una lista de todos los servicios y las cargas de trabajo descubiertos y registrados.

2. Usa el campo Filtro para restringir los resultados por atributos como Entorno o Estado de registro.

gcloud

Consulta los detalles de los servicios y las cargas de trabajo registrados o desvinculados de una aplicación:

1. Encuentra el ID del proyecto de tu proyecto de administración o proyecto host.

2. Describe un servicio o una carga de trabajo de una aplicación para revisar sus detalles:

   • Describe un servicio:

     gcloud apphub applications services describe SERVICE \
         --project=PROJECT_ID \
         --application=APPLICATION \
         --location=LOCATION
     

     Reemplaza lo siguiente:

     • SERVICE: Es el ID del servicio.
     • PROJECT_ID: Es el ID de tu proyecto host o proyecto de administración.
     • APPLICATION: Es el ID de la aplicación en la que se registró el servicio.
     • LOCATION: Es la ubicación del servicio. Usa global para los recursos globales o una región específica, como us-east1, para los recursos regionales.

   • Describe una carga de trabajo:

     gcloud apphub applications workloads describe WORKLOAD \
         --project=PROJECT_ID \
         --application=APPLICATION \
         --location=LOCATION
     

     Reemplaza lo siguiente:

     • WORKLOAD: Es el ID de la carga de trabajo.
     • PROJECT_ID: Es el ID de tu proyecto host o proyecto de administración.
     • APPLICATION: Es el ID de la aplicación en la que se registró la carga de trabajo.
     • LOCATION: Es la ubicación de la carga de trabajo. Usa global para los recursos globales o una región específica, como us-east1, para los recursos regionales.

El resultado muestra detalles del recurso, como el nombre visible, la ubicación, el estado de registro y los atributos.

También puedes ver una lista de todos los servicios y cargas de trabajo con un valor de estado de registro de discovered o registered:

Recursos descubiertos

Los recursos descubiertos están disponibles para registrarse en una aplicación. Sigue estos pasos para enumerar los recursos descubiertos:

1. Enumera los servicios detectados:

   gcloud apphub discovered-services 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 en la que deseas descubrir recursos. Usa global para los recursos globales o una región específica, como us-east1, para los recursos regionales.

2. Enumera las cargas de trabajo descubiertas:

   gcloud apphub discovered-workloads list \
       --project=PROJECT_ID \
       --location=LOCATION
   

Recursos registrados

Los recursos registrados forman parte de una aplicación. Sigue estos pasos para enumerar los recursos registrados de una aplicación en particular. Puedes filtrar la lista según los atributos con la marca --filter:

1. Enumera los servicios registrados en una aplicación:

   gcloud apphub applications services list \
       --application=APPLICATION_NAME \
       --project=PROJECT_ID \
       --location=LOCATION \
       --filter=FILTER_EXPRESSION
   

   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 del recurso. Usa global para los recursos globales o una región específica, como global, para los recursos regionales.us-east1
   • Opcional: FILTER_EXPRESSION: Es la expresión de filtro para especificar atributos. Por ejemplo, para enumerar recursos con un tipo de entorno PRODUCTION, usa attributes.environment.type=PRODUCTION.

2. Enumera las cargas de trabajo registradas en una aplicación:

   gcloud apphub applications workloads list \
       --application=APPLICATION_NAME \
       --project=PROJECT_ID \
       --location=LOCATION \
       --filter=FILTER_EXPRESSION
   

El estado de registro de los servicios y las cargas de trabajo de una aplicación puede cambiar a desvinculado si modificas la estructura organizativa de tus recursos de Google Cloudo borras el recurso subyacente. Los servicios y las cargas de trabajo desconectados permanecen en la aplicación hasta que los anulas, pero App Hub ya no puede administrarlos ni supervisarlos. Para obtener más información, consulta Estado de registro de servicios y cargas de trabajo.

Para volver a adjuntar servicios o cargas de trabajo a una aplicación, debes registrarlos de nuevo según la jerarquía de recursos de tu modelo de configuración.

Actualiza los atributos de servicio y de carga de trabajo

Sigue estos pasos para modificar los atributos definidos por el usuario de los servicios y las cargas de trabajo registrados en una aplicación:

Console

1. En la página Welcome de la consola de Google Cloud , usa el selector de proyectos para elegir tu proyecto de administración o proyecto host:

   Ir a Bienvenida

2. Navega a la página Aplicaciones de App Hub:

   Ir a Aplicaciones

   En la página, se muestra una lista de tus aplicaciones.

3. Haz clic en el nombre de la aplicación para la que deseas actualizar los atributos del servicio o la carga de trabajo.

4. En la pestaña Servicios y cargas de trabajo, busca el nombre del servicio o la carga de trabajo que deseas actualizar.

5. Haz clic en more_vert Más y, luego, en Editar servicio o Editar carga de trabajo.

6. En el panel que se abre, edita los campos según sea necesario y haz clic en Guardar.

gcloud

1. Encuentra el ID del proyecto de tu proyecto de administración o proyecto host.

2. Actualiza los atributos del servicio o la carga de trabajo:

   • Actualiza los atributos del servicio:

     gcloud apphub applications services update SERVICE_NAME \
         --application=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 SERVICE_NAME por el nombre del servicio que deseas actualizar.

   • Actualiza los atributos de la carga de trabajo:

     gcloud apphub applications workloads update WORKLOAD_NAME \
         --application=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 WORKLOAD_NAME por el nombre de la carga de trabajo que deseas actualizar.

     Reemplaza las siguientes marcas obligatorias y opcionales:

     • Obligatorio: APPLICATION_NAME: El nombre de tu aplicación. Especificas este valor cuando creas una aplicación.
     • Obligatorio: PROJECT_ID: Es el ID de tu proyecto host o proyecto de administración.
     • Obligatorio: LOCATION: ubicación del recurso. Usa global para recursos globales o una región específica, como us-east1, para recursos regionales.
     • Opcional: DISPLAY_NAME es el nombre visible de tu recurso.

     • Opcional: CRITICALITY_LEVEL es el nivel de importancia del recurso. 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 y DEV_EMAIL: El nombre visible y la dirección de correo electrónico del propietario desarrollador, respectivamente.

     • Opcional: OPERATOR_NAME y OPERATOR_EMAIL: El nombre visible y la dirección de correo electrónico del propietario del operador, respectivamente.

     • Opcional: BUSINESS_NAME y BUSINESS_EMAIL: El nombre visible y la dirección de correo electrónico del propietario de la empresa, respectivamente.

     Nota: Las direcciones de correo electrónico deben tener el formato username@yourdomain, por ejemplo, [e-mail].

Terraform

Para actualizar los atributos del servicio o la carga de trabajo con Terraform, modifica los argumentos dentro del bloque de recursos google_apphub_service o google_apphub_workload correspondiente en tu archivo de configuración. Cuando aplicas los cambios, Terraform actualiza el recurso para que coincida con la nueva configuración.

En los siguientes ejemplos, se actualizan los atributos de importancia y entorno de los servicios y las cargas de trabajo de una aplicación regional:

• Actualiza los atributos del servicio:

  resource "google_apphub_service" "example" {
      # ... other arguments
      attributes {
          criticality {
              type = "HIGH" # Updated criticality
          }
          environment {
              type = "PRODUCTION"
          }
          # ... other attributes
      }
  }
  

• Actualiza los atributos de la carga de trabajo:

  resource "google_apphub_workload" "example" {
      # ... other arguments
      attributes {
          criticality {
              type = "HIGH" # Updated criticality
          }
          environment {
              type = "PRODUCTION"
          }
          # ... other attributes
      }
  }
  

Cancelar el registro de servicios y cargas de trabajo

Cancelar el registro de un servicio o una carga de trabajo los quita de una aplicación. El recurso subyacente no se borra y vuelve a ser un recurso descubierto, disponible para registrarse en otra aplicación.

Sigue estos pasos para cancelar el registro de los servicios y las cargas de trabajo:

Console

1. En la página Welcome de la consola de Google Cloud , usa el selector de proyectos para elegir tu proyecto de administración o proyecto host:

   Ir a Bienvenida

2. Navega a la página Aplicaciones de App Hub:

   Ir a Aplicaciones

   En la página, se muestra una lista de tus aplicaciones.

3. Haz clic en el nombre de la aplicación de la que deseas anular el registro de servicios o cargas de trabajo.

4. En la pestaña Servicios y cargas de trabajo, haz clic en el nombre del servicio o la carga de trabajo que deseas anular el registro.

5. En la página de detalles del recurso, haz clic en Cancelar registro.

gcloud

1. Encuentra el ID del proyecto de tu proyecto de administración o proyecto host.

2. Para cancelar el registro de un servicio o una carga de trabajo, haz lo siguiente:

   • Para cancelar el registro de un servicio, sigue estos pasos:

     gcloud apphub applications services delete SERVICE_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION
     

     Reemplaza lo siguiente:

     • SERVICE_NAME: Es el nombre del servicio que deseas anular el registro.
     • 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 del recurso. Usa global para los recursos globales o una región específica, como us-east1, para los recursos regionales.

   • Para cancelar el registro de una carga de trabajo, haz lo siguiente:

     gcloud apphub applications workloads delete WORKLOAD_NAME \
         --application=APPLICATION_NAME \
         --project=PROJECT_ID \
         --location=LOCATION
     

     Reemplaza WORKLOAD_NAME por el nombre de la carga de trabajo que deseas anular el registro.

Terraform

Para anular el registro de un servicio o una carga de trabajo administrados por Terraform, quita el bloque de recursos google_apphub_service o google_apphub_workload correspondiente de tu archivo de configuración y ejecuta terraform apply. Cuando aplicas los cambios, Terraform quita el registro de App Hub.

Después de cancelar el registro de todos los servicios y cargas de trabajo, puedes borrar la aplicación.

¿Qué sigue?

• Administra tus aplicaciones
• Cómo optimizar una aplicación con recomendaciones de diseño
• Supervisa tus aplicaciones