Gestionar servicios y cargas de trabajo

Cuando configuras App Hub, creas un límite administrativo para tus aplicaciones. Este límite es el proyecto de gestión o el conjunto de proyectos host y de servicio que hayas configurado para la gestión de aplicaciones, en función del modelo de configuración. Los servicios y las cargas de trabajo se registran como aplicaciones dentro de este límite administrativo.

Para evitar que la configuración cambie y mantener una fuente de información clara, te recomendamos que gestiones los recursos 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 registrando recursos en App Hub: Gestiona la aplicación, sus servicios y sus 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 como aplicaciones. Puedes realizar estas acciones con la Google Cloud consola o con la CLI de Google Cloud. Para obtener información sobre las aplicaciones implementadas a partir de una plantilla, consulta la documentación de Application Design Center.

Antes de empezar

Para poder ver, actualizar y anular el registro de servicios y cargas de trabajo en App Hub, sigue estos pasos:

  1. Configura el centro de aplicaciones con uno de los modelos de configuración admitidos.
  2. Registrar recursos admitidos en una aplicación

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 límite administrativo de la aplicación de tu modelo de configuración (el proyecto de gestión o los proyectos host y de servicio):

  • Actualiza y anula el registro de servicios y cargas de trabajo: Editor de App Hub (roles/apphub.editor)
  • Ver servicios y cargas de trabajo: 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 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, incluida su ubicación y el estado de registro de una aplicación, dentro de tu límite administrativo de App Hub:

Consola

Para ver los detalles de los servicios y las cargas de trabajo registrados o desvinculados de una aplicación, sigue estos pasos:

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

    Ir a Bienvenida

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

    Ir 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 servicios o las 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 ver.

  5. En la página Detalles del recurso, puedes consultar información 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 el valor discovered o registered en el campo de estado de registro:

  1. Ve 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 cargas de trabajo detectados y registrados.

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

gcloud

Para ver los detalles de los servicios y las cargas de trabajo registrados o desvinculados de una aplicación, sigue estos pasos:

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

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

    • 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 host o 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 host o 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 la salida se muestran 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 el valor discovered o registered en el campo de estado de registro:

Recursos descubiertos

Los recursos detectados se pueden registrar 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 host o 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

Recursos registrados

Los recursos registrados forman parte de una aplicación. Sigue estos pasos para enumerar los recursos 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 host o de gestión.
    • LOCATION: la ubicación del recurso. Usa global para los recursos globales o una región específica, como us-east1, para los recursos regionales.
    • Opcional: FILTER_EXPRESSION: la expresión de filtro para especificar atributos. Por ejemplo, para enumerar los recursos 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 modificas la estructura organizativa de tus recursos de Google Cloudo 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, consulta 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 según la jerarquía de recursos de tu modelo de configuración.

Actualizar atributos de servicios y cargas 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:

Consola

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

    Ir a Bienvenida

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

    Ir 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 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 tu proyecto de gestión o proyecto host.

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

      • Opcional: CRITICALITY_LEVEL: el nivel de importancia del recurso. 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 y vuelve a ser un recurso detectado, disponible para registrarse en otra aplicación.

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

Consola

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

    Ir a Bienvenida

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

    Ir 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.

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

gcloud

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

  2. Anular el registro de un servicio o una carga de trabajo:

    • 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 host o de gestión.
      • LOCATION: la ubicación del recurso. Usa global para los recursos globales o una región específica, como us-east1, para los recursos 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.

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