Gestionar servicios y cargas de trabajo

Cuando elijas el modelo de configuración de tu aplicación, definirás un límite de gestión de aplicaciones para tus aplicaciones de App Hub en un proyecto de gestión. A continuación, puedes registrar servicios y cargas de trabajo en aplicaciones dentro de este límite. Para ver los casos prácticos recomendados para introducir las prácticas de gestión de aplicaciones, consulta el artículo Prepararse para la gestión del ciclo de vida de las aplicaciones.

Para evitar que la configuración cambie y mantener una fuente de información clara, te recomendamos que gestiones los componentes de tu aplicación en el entorno en el que se definieron originalmente:

  • En el caso de las aplicaciones implementadas a partir de una plantilla de Application Design Center: Utiliza Application Design Center para gestionar y actualizar la aplicación. Puedes revisar la plantilla para cambiar el diseño de la aplicación o crear una revisión de la aplicación para actualizar ajustes como los detalles de la aplicación y los componentes.

    Ir a Application Design Center

  • En el caso de las aplicaciones creadas mediante el registro de recursos en App Hub: gestiona 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 gestionar los servicios y las cargas de trabajo que se descubren o se registran directamente en App Hub. Puedes realizar estas acciones con la Google Cloud consola o con la CLI de Google Cloud. Si las aplicaciones se han implementado a partir de una plantilla, consulta la documentación de Application Design Center.

Antes de empezar

En este documento se da por supuesto que tienes una aplicación con recursos admitidos registrados.

Roles obligatorios

Para obtener los permisos que necesitas para gestionar servicios y cargas de trabajo en App Hub, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto de gestión que define el límite de gestión de tu aplicación:

  • Actualiza y anula el registro de servicios y cargas de trabajo: Editor de App Hub (roles/apphub.editor)
  • Ver servicios, cargas de trabajo y sus detalles: Visor de App Hub (roles/apphub.viewer)

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Para obtener más información sobre los roles de App Hub, consulta el artículo sobre roles y permisos de gestión de identidades y accesos de App Hub.

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

Consola

Para ver los detalles de los servicios y las cargas de trabajo de una aplicación con el valor registered o detached en el campo de estado de registro, sigue estos pasos:

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

  2. Ve a la página Aplicaciones desde App Hub:

    Ve a Aplicaciones.

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

  3. Haga clic en el nombre de la aplicación de la que quiera ver los detalles del servicio o de la carga de trabajo.

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

  5. En la página Detalles del componente, puede 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 el valor discovered o registered en el campo de estado de registro:

  1. Para ir a la página Servicios y cargas de trabajo desde App Hub, sigue estos pasos:

    Ir a Servicios y cargas de trabajo

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

  2. Use el campo Filtrar para acotar los resultados por propiedades, atributos o estado. Para ello, utilice valores como Entorno, Propietarios o Estado de registro.

gcloud

Para ver los detalles de los servicios y las cargas de trabajo de una aplicación con el valor registered o detached en el campo de estado de registro, sigue estos pasos:

  1. Busca el ID del proyecto de gestión.

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

    • Describe un servicio:

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

      Haz los cambios siguientes:

      • SERVICE: el ID del servicio.
      • PROJECT_ID: el ID de tu proyecto de gestión.
      • APPLICATION: el ID de la aplicación en la que se ha registrado el servicio.
      • LOCATION: 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

      Haz los cambios siguientes:

      • WORKLOAD: el ID de la carga de trabajo.
      • PROJECT_ID: el ID de tu proyecto de gestión.
      • APPLICATION: el ID de la aplicación en la que se ha registrado la carga de trabajo.
      • LOCATION: 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.

En el resultado se muestran 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 el valor discovered o registered en el campo de estado de registro:

¿Habéis visto

Los recursos detectados Google Cloud dentro del límite de gestión de tu aplicación se pueden registrar como servicios o cargas de trabajo en una aplicación. Sigue estos pasos para enumerar los recursos detectados:

  1. Lista de servicios detectados:

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

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de tu proyecto de gestión.
    • LOCATION: la ubicación en la que quieres descubrir recursos. Usa global para los recursos globales o una región específica, como us-east1, para los recursos regionales.

  2. Lista de 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 ver los componentes registrados de una aplicación concreta. Puede filtrar la lista por atributos mediante la marca --filter:

  1. Lista de servicios registrados en una aplicación:

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

    Haz los cambios siguientes:

    • APPLICATION_NAME: el nombre de tu aplicación. Este valor se especifica al crear una aplicación.
    • PROJECT_ID: el ID de tu proyecto de gestión.
    • 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: FILTER_EXPRESSION: la expresión de filtro para especificar atributos. Por ejemplo, para enumerar los componentes con el tipo de entorno PRODUCTION, usa attributes.environment.type=PRODUCTION.

  2. Para ver las cargas de trabajo registradas en una aplicación, sigue estos pasos:

    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 desasociado si mueves un proyecto o una carpeta fuera del límite de gestión de la aplicación o si eliminas el recurso subyacente. Los servicios y las cargas de trabajo independientes permanecen en la aplicación hasta que los anulas, pero App Hub ya no puede gestionarlos ni monitorizarlos. Para obtener más información, consulte Estado de registro de servicios y cargas de trabajo.

Para volver a asociar servicios o cargas de trabajo a una aplicación, debes registrarlos de nuevo.

Actualizar atributos de servicios y cargas de trabajo

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

Consola

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

  2. Ve a la página Aplicaciones desde App Hub:

    Ve a Aplicaciones.

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

  3. Haga clic en el nombre de la aplicación cuyos atributos de servicio o de carga de trabajo quiera actualizar.

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

  5. Haz clic en more_vert Más y, a continuación, 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. Busca el ID del proyecto de gestión.

  2. Actualiza los atributos del servicio o de 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

      Sustituye SERVICE_NAME por el nombre del servicio que quieras 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

      Sustituye WORKLOAD_NAME por el nombre de la carga de trabajo que quieras actualizar.

      Sustituye las siguientes marcas obligatorias y opcionales:

      • Obligatorio: APPLICATION_NAME, el nombre de tu aplicación. Este valor se especifica al crear una aplicación.
      • Obligatorio: PROJECT_ID, el ID de tu proyecto de gestión.
      • Obligatorio: LOCATION: la ubicación de tu componente. Usa global para los componentes globales o una región específica, como us-east1, para los componentes regionales.
      • Opcional: DISPLAY_NAME: el nombre visible de tu componente.

      • Opcional: CRITICALITY_LEVEL: el nivel de importancia del componente. Usa uno de los siguientes valores:

        • MISSION_CRITICAL
        • HIGH
        • MEDIUM
        • LOW

      • Opcional: ENVIRONMENT: la fase del ciclo de vida del software. Se debe utilizar uno de los valores indicados a continuación.

        • PRODUCTION
        • STAGING
        • DEVELOPMENT
        • TEST

      • Opcional: DEV_NAME y DEV_EMAIL: el nombre visible y la dirección de correo del propietario del desarrollador, respectivamente.

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

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

Terraform

Para actualizar los atributos de un servicio o una carga de trabajo con Terraform, modifica los argumentos del bloque de recursos google_apphub_service o google_apphub_workload correspondiente en tu archivo de configuración. Cuando apliques los cambios, Terraform actualizará 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
    }
}

Anular el registro de servicios y cargas de trabajo

Si anulas el registro de un servicio o una carga de trabajo, se eliminará de una aplicación. El recurso subyacente no se elimina. Si sigue estando dentro del límite de gestión de tu aplicación, se convierte en un recurso con el valor de estado de registro discovered, que se puede registrar en otra aplicación.

Sigue estos pasos para anular el registro de servicios y cargas de trabajo:

Consola

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

  2. Ve a la página Aplicaciones desde App Hub:

    Ve a Aplicaciones.

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

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

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

  5. En la página de detalles del componente, haz clic en Anular registro.

gcloud

  1. Busca el ID del proyecto de tu proyecto de gestión.

  2. Para anular el registro de un servicio o una carga de trabajo, sigue estos pasos:

    • Anular el registro de un servicio:

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

      Haz los cambios siguientes:

      • SERVICE_NAME: el nombre del servicio que quieras anular.
      • APPLICATION_NAME: el nombre de tu aplicación. Este valor se especifica al crear una aplicación.
      • PROJECT_ID: el ID de tu proyecto de gestión.
      • 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.

    • Anular el registro de una carga de trabajo:

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

      Sustituye WORKLOAD_NAME por el nombre de la carga de trabajo que quieras anular el registro.

Terraform

Para dar de baja un servicio o una carga de trabajo gestionados por Terraform, elimina el bloque de recursos google_apphub_service o google_apphub_workload correspondiente de tu archivo de configuración y ejecuta terraform apply. Cuando apliques los cambios, Terraform eliminará el registro de App Hub.

Después de dar de baja todos los servicios y cargas de trabajo, puedes eliminar la aplicación.

Siguientes pasos