Ver el cierre ordenado en una instancia de Compute Engine

En este documento se explica cómo ver los ajustes y el progreso de un cierre ordenado en una instancia de Compute Engine. Para obtener más información sobre el cierre ordenado, consulta el artículo Descripción general del cierre ordenado.

Cuando ves los detalles de una instancia, puedes hacer lo siguiente:

  • Ver los ajustes de cierre gradual. Puedes comprobar si el cierre suave está habilitado y cuánto dura.

  • Monitoriza el cierre ordenado. Cuando se esté llevando a cabo un cierre ordenado, puedes comprobar lo siguiente:

    • Cuando se agota el tiempo de espera del proceso de apagado suave.

    • Si hay una operación de detención o eliminación en curso.

Antes de empezar

  • Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    2. Set a default region and zone.

    REST

    Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.

      Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Roles obligatorios

Para obtener el permiso que necesitas para ver el cierre ordenado de una instancia de Compute, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de instancias de Compute (v. 1) (roles/compute.instanceAdmin.v1) en tu proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el permiso compute.instances.get on the project , que es necesario para ver el cierre ordenado de una instancia de proceso.

También puedes obtener este permiso con roles personalizados u otros roles predefinidos.

Ver los ajustes de cierre gradual

Para ver los ajustes de apagado gradual de una instancia de proceso, selecciona una de las siguientes opciones:

Consola

  1. En la consola de Google Cloud , ve a la página Instancias de VM.

    Ir a instancias de VM

  2. En la columna Nombre, haz clic en el nombre de tu instancia.

    Se abrirá la página de detalles de la instancia en la pestaña Detalles.

  3. Para comprobar los ajustes de cierre gradual, en la sección Políticas de disponibilidad, consulta el valor del campo Duración máxima del cierre gradual. En este campo se muestra el periodo de cierre gradual. Si aparece un guion (-), significa que el cierre controlado está inhabilitado.

gcloud

Para ver los ajustes de cierre ordenado de una instancia, usa el comando gcloud beta compute instances describe:

gcloud beta compute instances describe INSTANCE_NAME \
    --zone=ZONE

Haz los cambios siguientes:

  • INSTANCE_NAME: el nombre de la instancia.

  • ZONE: la zona en la que se encuentra la instancia.

Si el cierre ordenado está habilitado, el resultado será similar al siguiente:

...
scheduling:
  ...
  gracefulShutdown:
    enabled: true
    maxDuration:
      seconds: 'MAX_DURATION'
  ...
...

El resultado incluye el valor MAX_DURATION. Este valor indica la duración del periodo de cierre gradual en segundos. Si no especificaste un periodo de apagado personalizado al habilitar el apagado controlado en la instancia, Compute Engine omitirá el campo maxDuration y establecerá el periodo de apagado controlado en 10 minutos.

REST

Para ver los ajustes de cierre ordenado de una instancia, haz una solicitud GET al método beta instances.get:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto en el que has creado la instancia.

  • ZONE: la zona en la que se encuentra la instancia.

  • INSTANCE_NAME: el nombre de la instancia.

Si el cierre ordenado está habilitado, el resultado será similar al siguiente:

{
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      "enabled": true,
      "maxDuration": {
        "seconds": "MAX_DURATION"
      }
    }
  },
  ...
}

El resultado incluye el valor MAX_DURATION. Este valor indica la duración del periodo de cierre gradual en segundos. Si no especificaste un periodo de apagado personalizado al habilitar el apagado controlado en la instancia, Compute Engine omitirá el campo maxDuration y establecerá el periodo de apagado controlado en 10 minutos.

Monitorizar el cierre ordenado

Para monitorizar un cierre ordenado en curso en una instancia de proceso, selecciona una de las siguientes opciones:

Consola

  1. En la consola de Google Cloud , ve a la página Instancias de VM.

    Ir a instancias de VM

  2. En la columna Nombre, haz clic en el nombre de tu instancia.

    Se abrirá la página de detalles de la instancia en la pestaña Detalles.

  3. Si se está llevando a cabo un cierre ordenado, en la sección Información básica, comprueba los siguientes campos:

    • Estado: este campo muestra el estado de la instancia. Durante un cierre ordenado, este campo muestra Parada pendiente y un temporizador de cuenta atrás. El temporizador cuenta hasta el momento en que finaliza el cierre ordenado.

    • Estado de destino: este campo muestra si Compute Engine está deteniendo (Stopped) o eliminando (Deleted) la instancia.

gcloud

Para monitorizar un cierre ordenado en curso en una instancia, usa el comando gcloud beta compute instances describe:

gcloud beta compute instances describe INSTANCE_NAME \
    --zone=ZONE

Haz los cambios siguientes:

  • INSTANCE_NAME: el nombre de la instancia.

  • ZONE: la zona en la que se encuentra la instancia.

Si se está llevando a cabo un cierre ordenado, el resultado será similar al siguiente:

...
resourceStatus:
  ...
  shutdownDetails:
    maxDuration:
      seconds: 'MAX_DURATION'
    requestTimestamp: 'REQUEST_TIMESTAMP'
    stopState: STOP_STATE
    targetState: TARGET_STATE
...
status: PENDING_STOP
...

Esta salida incluye los siguientes valores:

  • MAX_DURATION: duración del periodo de cierre gradual en segundos. Una vez que Compute Engine asigna el valor STOPPING a STOP_STATE, elimina el campo maxDuration.

  • REQUEST_TIMESTAMP: marca de tiempo en la que se inició STOP_STATE.

  • STOP_STATE: la fase de detención de la instancia. El valor puede ser uno de los siguientes:

    • PENDING_STOP: Compute Engine ha iniciado el cierre controlado. La instancia permanece en este estado hasta que finalices manualmente el cierre ordenado o hasta que se agote el tiempo del periodo de cierre ordenado.

    • STOPPING: el cierre controlado ha finalizado y Compute Engine continúa con la operación de detener o eliminar.

  • TARGET_STATE: indica si Compute Engine está deteniendo (STOPPED) o eliminando (DELETED) la instancia.

Si se está ejecutando una operación de detención, después de que Compute Engine asigne el valor TERMINATE al campo status, se eliminará el campo shutdownDetails.

REST

Para monitorizar un cierre gradual en curso en una instancia, haz una solicitud GET al método beta instances.get:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto en el que has creado la instancia.

  • ZONE: la zona en la que se encuentra la instancia.

  • INSTANCE_NAME: el nombre de la instancia.

Si se está llevando a cabo un cierre ordenado, el resultado será similar al siguiente:

{
  ...
  "resourceStatus": {
    ...
    "shutdownDetails": {
      "maxDuration": {
        "seconds": "MAX_DURATION"
      },
      "requestTimestamp": "REQUEST_TIMESTAMP",
      "stopState": "STOP_STATE",
      "targetState": "TARGET_STATE"
    }
  },
  ...
  "status": "PENDING_STOP",
  ...
}

Esta salida incluye los siguientes valores:

  • MAX_DURATION: duración del periodo de cierre gradual en segundos. Una vez que Compute Engine asigna el valor STOPPING a STOP_STATE, elimina el campo maxDuration.

  • REQUEST_TIMESTAMP: marca de tiempo en la que se inició STOP_STATE.

  • STOP_STATE: la fase de detención de la instancia. El valor puede ser uno de los siguientes:

    • PENDING_STOP: Compute Engine ha iniciado el cierre controlado. La instancia permanece en este estado hasta que finalices manualmente el cierre ordenado o hasta que se agote el tiempo del periodo de cierre ordenado.

    • STOPPING: el cierre controlado ha finalizado y Compute Engine continúa con la operación de detener o eliminar.

  • TARGET_STATE: indica si Compute Engine está deteniendo (STOPPED) o eliminando (DELETED) la instancia.

Si se está ejecutando una operación de detención, después de que Compute Engine asigne el valor TERMINATE al campo status, se eliminará el campo shutdownDetails.

Servidor de metadatos

  1. Conéctate a la instancia.

  2. Consulta el servidor de metadatos:

    curl "http://metadata.google.internal/computeMetadata/v1/instance/shutdown-details/?recursive=true?alt=json" \-H "Metadata-Flavor: Google"

    Si se está llevando a cabo un cierre ordenado, el resultado será similar al siguiente:

    {
  "maxDuration": "MAX_DURATION",
  "requestTimestamp": "REQUEST_TIMESTAMP",
  "stopState": "STOP_STATE",
  "targetState": "TARGET_STATE"
}

    La salida incluye los siguientes valores:

    • MAX_DURATION: duración del periodo de cierre suave en segundos. Una vez que Compute Engine asigna el valor STOPPING a STOP_STATE, elimina el campo maxDuration.

    • REQUEST_TIMESTAMP: marca de tiempo en la que se inició STOP_STATE.

    • STOP_STATE: la fase de detención de la instancia. El valor puede ser uno de los siguientes:

      • PENDING_STOP: Compute Engine ha iniciado el cierre ordenado. La instancia permanece en este estado hasta que finalices manualmente el cierre ordenado o hasta que se agote el tiempo de espera del cierre ordenado.

      • STOPPING: el cierre ordenado ha finalizado y Compute Engine continúa con la operación de detener o eliminar.

    • TARGET_STATE: indica si Compute Engine está deteniendo (STOPPED) o eliminando (DELETED) la instancia.

Siguientes pasos