Ver el apagado ordenado en una instancia de Compute Engine,Ver el apagado ordenado en una instancia de Compute Engine

Este documento explica cómo ver la configuración y el progreso de un apagado ordenado en una instancia de Compute Engine. Para obtener más información sobre el cierre ordenado, consulte Descripción general del cierre ordenado .

Cuando ve los detalles de una instancia, puede hacer lo siguiente:

  • Ver configuraciones de apagado elegante . Puede verificar si el apagado elegante está habilitado y cuánto dura.

  • Supervisar el cierre elegante . Cuando se está realizando un apagado ordenado, puede verificar lo siguiente:

    • Cuando el proceso de cierre elegante finaliza el tiempo de espera.

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

Antes de comenzar

  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras 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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

      3. REST

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

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Roles requeridos

Para obtener el permiso que necesita para ver el cierre ordenado de una instancia informática, solicite a su administrador que le otorgue el rol de IAM de Administrador de instancia informática (v1) ( roles/compute.instanceAdmin.v1 ) en su proyecto. Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

Esta función predefinida contiene el permiso compute.instances.get on the project , que es necesario para ver el cierre correcto de una instancia informática.

Es posible que también pueda obtener este permiso con roles personalizados u otros roles predefinidos .

Ver configuraciones de apagado elegante

Para ver la configuración de apagado elegante en una instancia informática, seleccione una de las siguientes opciones:

Consola

  1. En la consola de Google Cloud, vaya a la página de instancias de VM .

    Ir a instancias de VM

  2. En la columna Nombre , haga clic en el nombre de su instancia.

    La página de detalles de la instancia se abre en la pestaña Detalles .

  3. Para verificar la configuración de apagado elegante, en la sección Políticas de disponibilidad , verifique el valor del campo Duración máxima del cierre elegante . Este campo muestra el período de apagado gradual. Si muestra un guión ( - ), entonces el apagado elegante está deshabilitado.

nube de gcloud

Para ver la configuración de apagado ordenado en una instancia, usa el comando gcloud beta compute instances describe :

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

Reemplace lo siguiente:

  • INSTANCE_NAME : el nombre de la instancia.

  • ZONE : la zona donde existe la instancia.

Si el apagado ordenado está habilitado, el resultado es similar al siguiente:

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

La salida incluye el valor MAX_DURATION . Este valor indica cuánto dura el período de apagado gradual en segundos. Si no especificaste un período de apagado personalizado cuando habilitaste el cierre ordenado en la instancia, Compute Engine omite el campo maxDuration y establece el período de apagado ordenado en 10 minutos.

DESCANSAR

Para ver la configuración de apagado elegante en una instancia, realice una solicitud GET al método instances.get :

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

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde creaste la instancia.

  • ZONE : la zona donde existe la instancia.

  • INSTANCE_NAME : el nombre de la instancia.

Si el apagado ordenado está habilitado, el resultado es similar al siguiente:

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

La salida incluye el valor MAX_DURATION . Este valor indica cuánto dura el período de apagado gradual en segundos. Si no especificaste un período de apagado personalizado cuando habilitaste el cierre ordenado en la instancia, Compute Engine omite el campo maxDuration y establece el período de apagado ordenado en 10 minutos.

Supervisar el cierre elegante

Para monitorear un apagado ordenado continuo en una instancia informática, seleccione una de las siguientes opciones:

Consola

  1. En la consola de Google Cloud, vaya a la página de instancias de VM .

    Ir a instancias de VM

  2. En la columna Nombre , haga clic en el nombre de su instancia.

    La página de detalles de la instancia se abre en la pestaña Detalles .

  3. Si se está realizando un apagado ordenado, en la sección Información básica , verifique los siguientes campos:

    • Estado : este campo muestra el estado de su instancia . Durante un apagado ordenado, este campo muestra Parada pendiente y un temporizador de cuenta regresiva. El cronómetro cuenta regresivamente hasta el momento en que finaliza el apagado elegante.

    • Estado objetivo : este campo muestra si Compute Engine está deteniendo ( Detenido ) o eliminando ( Eliminado ) la instancia.

nube de gcloud

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

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

Reemplace lo siguiente:

  • INSTANCE_NAME : el nombre de la instancia.

  • ZONE : la zona donde existe la instancia.

Si hay un apagado ordenado en curso, el resultado es 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 : la duración del período de apagado gradual en segundos. Después de que Compute Engine establece STOP_STATE en STOPPING , elimina el campo maxDuration .

  • REQUEST_TIMESTAMP : la marca de tiempo cuando 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 apagado correcto. La instancia permanece en este estado hasta que finalice manualmente el cierre gradual o hasta que expire el período de cierre gradual.

    • STOPPING : el apagado ordenado ha finalizado y Compute Engine continúa con la operación de detención o eliminación.

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

Si se está ejecutando una operación de detención, luego de que Compute Engine establezca el campo status en TERMINATE , elimina el campo shutdownDetails .

DESCANSAR

Para monitorear un cierre ordenado en curso en una instancia, realice una solicitud GET al método instances.get beta :

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

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde creaste la instancia.

  • ZONE : la zona donde existe la instancia.

  • INSTANCE_NAME : el nombre de la instancia.

Si hay un apagado ordenado en curso, el resultado es 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 : la duración del período de apagado gradual en segundos. Después de que Compute Engine establece STOP_STATE en STOPPING , elimina el campo maxDuration .

  • REQUEST_TIMESTAMP : la marca de tiempo cuando 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 apagado correcto. La instancia permanece en este estado hasta que finalice manualmente el cierre gradual o hasta que expire el período de cierre gradual.

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

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

Si se está ejecutando una operación de detención, luego de que Compute Engine establezca el campo status en TERMINATE , elimina el campo shutdownDetails .

Servidor de metadatos

  1. Conéctese 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 hay un apagado ordenado en curso, el resultado es similar al siguiente: 

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

    La salida incluye los siguientes valores:

    • MAX_DURATION : la duración del período de apagado gradual en segundos. Después de que Compute Engine establece STOP_STATE en STOPPING , elimina el campo maxDuration .

    • REQUEST_TIMESTAMP : la marca de tiempo cuando 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 apagado correcto. La instancia permanece en este estado hasta que finalice manualmente el cierre gradual o hasta que expire el período de cierre gradual.

      • STOPPING : el apagado ordenado ha finalizado y Compute Engine continúa con la operación de detención o eliminación.

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

¿Qué sigue?

,

Este documento explica cómo ver la configuración y el progreso de un apagado ordenado en una instancia de Compute Engine. Para obtener más información sobre el cierre ordenado, consulte Descripción general del cierre ordenado .

Cuando ve los detalles de una instancia, puede hacer lo siguiente:

  • Ver configuraciones de apagado elegante . Puede verificar si el apagado elegante está habilitado y cuánto dura.

  • Supervisar el cierre elegante . Cuando se está realizando un apagado ordenado, puede verificar lo siguiente:

    • Cuando el proceso de cierre elegante finaliza el tiempo de espera.

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

Antes de comenzar

  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras 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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

      3. REST

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

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Roles requeridos

Para obtener el permiso que necesita para ver el cierre ordenado de una instancia informática, solicite a su administrador que le otorgue el rol de IAM de Administrador de instancia informática (v1) ( roles/compute.instanceAdmin.v1 ) en su proyecto. Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

Esta función predefinida contiene el permiso compute.instances.get on the project , que es necesario para ver el cierre correcto de una instancia informática.

Es posible que también pueda obtener este permiso con roles personalizados u otros roles predefinidos .

Ver configuraciones de apagado elegante

Para ver la configuración de apagado elegante en una instancia informática, seleccione una de las siguientes opciones:

Consola

  1. En la consola de Google Cloud, vaya a la página de instancias de VM .

    Ir a instancias de VM

  2. En la columna Nombre , haga clic en el nombre de su instancia.

    La página de detalles de la instancia se abre en la pestaña Detalles .

  3. Para verificar la configuración de apagado elegante, en la sección Políticas de disponibilidad , verifique el valor del campo Duración máxima del cierre elegante . Este campo muestra el período de apagado gradual. Si muestra un guión ( - ), entonces el apagado elegante está deshabilitado.

nube de gcloud

Para ver la configuración de apagado ordenado en una instancia, usa el comando gcloud beta compute instances describe :

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

Reemplace lo siguiente:

  • INSTANCE_NAME : el nombre de la instancia.

  • ZONE : la zona donde existe la instancia.

Si el apagado ordenado está habilitado, el resultado es similar al siguiente:

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

La salida incluye el valor MAX_DURATION . Este valor indica cuánto dura el período de apagado gradual en segundos. Si no especificaste un período de apagado personalizado cuando habilitaste el cierre ordenado en la instancia, Compute Engine omite el campo maxDuration y establece el período de apagado ordenado en 10 minutos.

DESCANSAR

Para ver la configuración de apagado elegante en una instancia, realice una solicitud GET al método instances.get :

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

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde creaste la instancia.

  • ZONE : la zona donde existe la instancia.

  • INSTANCE_NAME : el nombre de la instancia.

Si el apagado ordenado está habilitado, el resultado es similar al siguiente:

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

La salida incluye el valor MAX_DURATION . Este valor indica cuánto dura el período de apagado gradual en segundos. Si no especificaste un período de apagado personalizado cuando habilitaste el cierre ordenado en la instancia, Compute Engine omite el campo maxDuration y establece el período de apagado ordenado en 10 minutos.

Supervisar el cierre elegante

Para monitorear un apagado ordenado continuo en una instancia informática, seleccione una de las siguientes opciones:

Consola

  1. En la consola de Google Cloud, vaya a la página de instancias de VM .

    Ir a instancias de VM

  2. En la columna Nombre , haga clic en el nombre de su instancia.

    La página de detalles de la instancia se abre en la pestaña Detalles .

  3. Si se está realizando un apagado ordenado, en la sección Información básica , verifique los siguientes campos:

    • Estado : este campo muestra el estado de su instancia . Durante un apagado ordenado, este campo muestra Parada pendiente y un temporizador de cuenta regresiva. El cronómetro cuenta regresivamente hasta el momento en que finaliza el apagado elegante.

    • Estado objetivo : este campo muestra si Compute Engine está deteniendo ( Detenido ) o eliminando ( Eliminado ) la instancia.

nube de gcloud

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

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

Reemplace lo siguiente:

  • INSTANCE_NAME : el nombre de la instancia.

  • ZONE : la zona donde existe la instancia.

Si hay un apagado ordenado en curso, el resultado es 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 : la duración del período de apagado gradual en segundos. Después de que Compute Engine establece STOP_STATE en STOPPING , elimina el campo maxDuration .

  • REQUEST_TIMESTAMP : la marca de tiempo cuando 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 apagado correcto. La instancia permanece en este estado hasta que finalice manualmente el cierre gradual o hasta que expire el período de cierre gradual.

    • STOPPING : el apagado ordenado ha finalizado y Compute Engine continúa con la operación de detención o eliminación.

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

Si se está ejecutando una operación de detención, luego de que Compute Engine establezca el campo status en TERMINATE , elimina el campo shutdownDetails .

DESCANSAR

Para monitorear un cierre ordenado en curso en una instancia, realice una solicitud GET al método instances.get beta :

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

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde creaste la instancia.

  • ZONE : la zona donde existe la instancia.

  • INSTANCE_NAME : el nombre de la instancia.

Si hay un apagado ordenado en curso, el resultado es 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 : la duración del período de apagado gradual en segundos. Después de que Compute Engine establece STOP_STATE en STOPPING , elimina el campo maxDuration .

  • REQUEST_TIMESTAMP : la marca de tiempo cuando 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 apagado correcto. La instancia permanece en este estado hasta que finalice manualmente el cierre gradual o hasta que expire el período de cierre gradual.

    • STOPPING : el apagado ordenado ha finalizado y Compute Engine continúa con la operación de detención o eliminación.

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

Si se está ejecutando una operación de detención, luego de que Compute Engine establezca el campo status en TERMINATE , elimina el campo shutdownDetails .

Servidor de metadatos

  1. Conéctese 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 hay un apagado ordenado en curso, el resultado es similar al siguiente: 

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

    La salida incluye los siguientes valores:

    • MAX_DURATION : la duración del período de apagado gradual en segundos. Después de que Compute Engine establece STOP_STATE en STOPPING , elimina el campo maxDuration .

    • REQUEST_TIMESTAMP : la marca de tiempo cuando 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 apagado correcto. La instancia permanece en este estado hasta que finalice manualmente el cierre gradual o hasta que expire el período de cierre gradual.

      • STOPPING : el apagado ordenado ha finalizado y Compute Engine continúa con la operación de detención o eliminación.

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

¿Qué sigue?