Administrar servicios y cargas de trabajo

Cuando eliges tu modelo de configuración de la aplicación, defines un límite de administración de la aplicación para tus aplicaciones de App Hub en un proyecto de administración. Luego, puedes registrar servicios y cargas de trabajo en las aplicaciones dentro de este límite. Para conocer los casos de uso recomendados para introducir prácticas de administración de aplicaciones, consulta Prepárate para la administración del ciclo de vida de las aplicaciones.

Para evitar la desviación de la configuración y mantener una fuente de información clara, te recomendamos que administres los componentes 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 existentes en App Hub: Administra las aplicaciones, los servicios y las 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. Puedes realizar estas acciones con la consola de Google Cloud o Google Cloud CLI. Para las aplicaciones implementadas desde una plantilla, consulta la documentación de App Design Center.

Antes de comenzar

En este documento, se supone que tienes una aplicación con recursos admitidos registrados en ella.

Roles obligatorios

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 proyecto de administración que define el límite de administración de tu aplicación :

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

Visualiza 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, incluidos su ubicación, el estado de registro en una aplicación, los atributos y las propiedades, dentro del límite de administración de tu aplicación. Para obtener más información sobre estos detalles, consulta Conceptos y modelo de datos de App Hub.

Console

Consulta los detalles de los servicios y las cargas de trabajo de una aplicación con un valor de estado de registro de registered o detached:

  1. En la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración.

  2. Navega a la página Aplicaciones desde 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 ver los detalles del servicio o la carga 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 componente, puedes consultar información como el nombre visible, la ubicación, el estado de registro, las propiedades 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 desde 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 limitar los resultados por propiedades, atributos o estado, con valores como Entorno, Propietarios o Estado de registro.

gcloud

Consulta los detalles de los servicios y las cargas de trabajo de una aplicación con un valor de estado de registro de registered o detached:

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

  2. Describe un servicio o una carga de trabajo de una aplicación para revisar sus detalles, incluidas las propiedades y los atributos:

    • 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 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 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 componente, como el nombre visible, la ubicación y el estado de registro. También incluye propiedades y atributos, si están presentes en el recurso.

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:

Descubierto

Los recursos Google Cloud descubiertos dentro del límite de administración de tu aplicación están disponibles para registrarse como servicios o cargas de trabajo en una aplicación. Sigue estos pasos para enumerar los recursos descubiertos:

  1. Enumera los servicios descubiertos:

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

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID de tu 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

Registrado

Los servicios y las cargas de trabajo registrados forman parte de una aplicación. Sigue estos pasos para enumerar los componentes 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 de administración.
    • LOCATION: Es la ubicación del componente. Usa global para los componentes globales o una región específica, como us-east1, para los componentes regionales.
    • Opcional: FILTER_EXPRESSION: Es la expresión de filtro para especificar atributos. Por ejemplo, para enumerar componentes 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 en una aplicación puede cambiar a desvinculado si mueves un proyecto o una carpeta fuera del límite de administración de tu aplicación o si borras el recurso subyacente. Los servicios y las cargas de trabajo desconectados permanecen en la aplicación hasta que los anules, 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.

Actualiza los atributos de servicio y carga de trabajo

Para modificar los atributos de los servicios y las cargas de trabajo registrados en una aplicación, sigue estos pasos:

Console

  1. En la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración.

  2. Navega a la página Aplicaciones desde 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.

  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 de administración.
      • Obligatorio: LOCATION: la ubicación del componente. Usa global para los componentes globales o una región específica, como us-east1, para los componentes regionales.
      • Opcional: DISPLAY_NAME: Es el nombre visible de tu componente.

      • Opcional: CRITICALITY_LEVEL es el nivel de importancia del componente. 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.

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 criticidad 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. No se borra el recurso subyacente. Si aún se encuentra dentro del límite de administración de tu aplicación, se convierte en un recurso con un valor de estado de registro de descubierto, disponible para el registro en otra aplicación.

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

Console

  1. En la consola de Google Cloud , usa el selector de proyectos para seleccionar tu proyecto de administración.

  2. Navega a la página Aplicaciones desde 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 componente, haz clic en Cancelar registro.

gcloud

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

  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 de administración.
      • LOCATION: Es la ubicación del componente. Usa global para los componentes globales o una región específica, como us-east1, para los componentes 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?