Habilitar el cierre ordenado en una instancia de Compute Engine

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 la instancia en la que quieras habilitar el cierre ordenado.

   Se abrirá la página de detalles de la instancia.

3. Haz clic en edit Editar.

4. En la sección Gestión, haga lo siguiente:

   1. Selecciona la casilla Apagar la VM correctamente.

   2. Opcional: Para especificar un periodo de cierre gradual personalizado, indica una duración en el campo Duración máxima.

5. Haz clic en Guardar.

gcloud

Para habilitar el cierre ordenado en una instancia, usa el comando gcloud beta compute instances update con la marca --graceful-shutdown:

gcloud beta compute instances update INSTANCE_NAME \
    --graceful-shutdown \
    --zone=ZONE

Haz los cambios siguientes:

• INSTANCE_NAME: el nombre de la instancia.

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

Si quieres especificar un periodo de cierre gradual personalizado, incluye la marca --graceful-shutdown-max-duration:

gcloud beta compute instances update INSTANCE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --zone=ZONE

Sustituye MAX_DURATION por la duración del periodo de apagado. El valor debe tener el formato del número de horas, minutos o segundos seguido de h, m y s, respectivamente. Por ejemplo, especifica 1h para una hora o 20m10s para 20 minutos y 10 segundos.

REST

1. Crea un archivo JSON vacío.

2. Para ver las propiedades de una instancia, envía 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 se encuentra la instancia.

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

   • INSTANCE_NAME: el nombre de una instancia.

3. En el archivo JSON vacío que has creado en los pasos anteriores, haz lo siguiente:

   1. Introduce los detalles de la configuración de la instancia del resultado de la solicitud GET.

   2. En el campo scheduling, añade el campo gracefulShutdown de la siguiente manera:

      {
        ...
        "scheduling": {
          ...
          "gracefulShutdown": {
            "enabled": true
          }
        },
        ...
      }
      

      Si quiere especificar un periodo de cierre gradual personalizado, incluya el campo maxDuration:

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

      Sustituye MAX_DURATION por la duración en segundos del periodo de cierre gradual. El valor debe estar comprendido entre 1 y 3600, es decir,3600 segundos (una hora).

4. Para actualizar la instancia y reiniciarla, haz una solicitud PUT al método beta instances.update. En la solicitud, haz lo siguiente:

   • En la URL de la solicitud, incluya el parámetro de consulta mostDisruptiveAllowedAction con el valor RESTART.

   • En el cuerpo de la solicitud, incluye las propiedades de la instancia del archivo JSON que creaste y actualizaste en los pasos anteriores.

   La solicitud PUT para actualizar la instancia es similar a la siguiente:

   PUT https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=RESTART
   
   {
     ...
     "scheduling": {
       ...
       "gracefulShutdown": {
         "enabled": true
       }
     },
     ...
   }
   

Consola

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

   Ir a instancias de VM

2. Haz clic en Crear instancia.

   Se abrirá la página Crear una instancia.

3. Escribe el nombre de la instancia.

4. Especifica la región y la zona en las que se creará la instancia.

5. Especifica un tipo de máquina para la instancia.

6. En el menú de navegación, haz clic en Opciones avanzadas.

7. Despliega la sección expand_more Configuración avanzada del modelo de aprovisionamiento de VMs y, a continuación, haz lo siguiente:

   1. Selecciona la casilla Apagar la VM correctamente.

   2. Opcional: Para especificar un periodo de cierre gradual personalizado, indica una duración en el campo Duración máxima.

8. Haz clic en Crear.

gcloud

Para crear una instancia que tenga habilitado el cierre ordenado, usa el comando gcloud beta compute instances create con la marca --graceful-shutdown:

gcloud beta compute instances create INSTANCE_NAME \
    --graceful-shutdown \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

Haz los cambios siguientes:

• INSTANCE_NAME: el nombre de la instancia.

• MACHINE_TYPE: el tipo de máquina que se va a usar en la instancia.

• ZONE: la zona en la que se creará la instancia.

Si quieres especificar un periodo de cierre gradual personalizado, incluye la marca --graceful-shutdown-max-duration:

gcloud beta compute instances create INSTANCE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

Sustituye MAX_DURATION por la duración del periodo de cierre gradual. El valor debe tener el formato de número de horas, minutos o segundos seguido de h, m y s, respectivamente. Por ejemplo, especifica 1h para una hora o 20m10s para 20 minutos y 10 segundos.

REST

Para crear una instancia que tenga habilitada la función de cierre ordenado, haz una solicitud POST al método beta.instances.insert. En el cuerpo de la solicitud, incluye el campo gracefulShutdown:

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

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "scheduling": {
    "gracefulShutdown": {
      "enabled": true
    }
  }
}

Haz los cambios siguientes:

• PROJECT_ID: el ID del proyecto en el que se va a crear la instancia.

• ZONE: la zona en la que se creará la instancia.

• INSTANCE_NAME: el nombre de la instancia.

• MACHINE_TYPE: el tipo de máquina de la instancia.

• IMAGE_PROJECT: el proyecto de imagen que contiene la imagen (por ejemplo, debian-cloud). Para obtener más información sobre los proyectos de imágenes admitidos, consulta Imágenes públicas.

• IMAGE: especifica una de las siguientes opciones:

  • Una versión específica de la imagen del SO, por ejemplo, debian-12-bookworm-v20240617.

  • Una familia de imágenes, que debe tener el formato family/IMAGE_FAMILY. Este formato especifica la imagen del SO más reciente que no está obsoleta. Por ejemplo, si especificas family/debian-12, se usará la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre cómo usar familias de imágenes, consulte las prácticas recomendadas para familias de imágenes.

Si quieres especificar un periodo de cierre gradual personalizado, incluye el campo maxDuration en el cuerpo de la solicitud:

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

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "scheduling": {
    "gracefulShutdown": {
      "enabled": true,
      "maxDuration": {
        "seconds": "MAX_DURATION"
      }
    }
  }
}

Sustituye MAX_DURATION por la duración en segundos del periodo de cierre gradual. El valor debe estar comprendido entre 1 y 3600, es decir,3600 segundos (una hora).

gcloud

Para crear instancias en bloque que tengan habilitado el cierre ordenado, usa el comando gcloud beta compute instances bulk create con la marca --graceful-shutdown.

Por ejemplo, para crear instancias en bloque en una sola zona y especificar un patrón de nombre para las instancias, ejecuta el siguiente comando:

gcloud beta compute instances bulk create \
    --count=COUNT \
    --graceful-shutdown \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --zone=ZONE

Haz los cambios siguientes:

• COUNT: número de instancias que se van a crear.

• MACHINE_TYPE: el tipo de máquina de las instancias.

• NAME_PATTERN: el patrón de nombre de las instancias. Para sustituir una secuencia de números en un nombre de instancia, utiliza una secuencia de caracteres de almohadilla (#). Por ejemplo, si se usa instance-# como patrón de nombre, se generan instancias con nombres que empiezan por instance-1, instance-2 y así sucesivamente hasta el número de instancias especificado por COUNT.

• ZONE: la zona en la que se crearán las instancias en bloque.

Si quieres especificar un periodo de cierre gradual personalizado, incluye la marca --graceful-shutdown-max-duration:

gcloud beta compute instances bulk create \
    --count=COUNT \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --zone=ZONE

Sustituye MAX_DURATION por la duración del periodo de cierre gradual. El valor debe tener el formato de número de horas, minutos o segundos seguido de h, m y s, respectivamente. Por ejemplo, especifica 1h para una hora o 20m10s para 20 minutos y 10 segundos.

REST

Para crear instancias en bloque que tengan habilitado el cierre ordenado, haz una solicitud POST al método beta instances.bulkInsert. En el cuerpo de la solicitud, incluye el campo gracefulShutdown.

Por ejemplo, para crear instancias de forma masiva en una sola zona y especificar un patrón de nombres para las instancias, haz una solicitud POST de la siguiente manera:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "gracefulShutdown": {
        "enabled": true
      }
    }
  }
}

Haz los cambios siguientes:

• PROJECT_ID: ID del proyecto en el que se crearán las instancias en bloque.

• ZONE: la zona en la que se crearán las instancias en bloque.

• COUNT: número de instancias que se van a crear.

• NAME_PATTERN: el patrón de nombre de las instancias. Para sustituir una secuencia de números en un nombre de instancia, utiliza una secuencia de caracteres de almohadilla (#). Por ejemplo, si se usa instance-# como patrón de nombre, se generan instancias con nombres que empiezan por instance-1, instance-2 y así sucesivamente hasta el número de instancias especificado por COUNT.

• MACHINE_TYPE: el tipo de máquina de las instancias.

• IMAGE_PROJECT: el proyecto de imagen que contiene la imagen (por ejemplo, debian-cloud). Para obtener más información sobre los proyectos de imágenes admitidos, consulta Imágenes públicas.

• IMAGE: especifica una de las siguientes opciones:

  • Una versión específica de la imagen del SO, por ejemplo, debian-12-bookworm-v20240617.

  • Una familia de imágenes, que debe tener el formato family/IMAGE_FAMILY. Este formato especifica la imagen del SO más reciente que no está obsoleta. Por ejemplo, si especificas family/debian-12, se usará la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre cómo usar familias de imágenes, consulte las prácticas recomendadas para familias de imágenes.

• ZONE: la zona en la que se crearán las instancias en bloque.

Si quieres especificar un periodo de cierre gradual personalizado, incluye el campo maxDuration en el cuerpo de la solicitud:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "gracefulShutdown": {
        "enabled": true,
        "maxDuration": {
          "seconds": "MAX_DURATION"
        }
      }
    }
  }
}

Sustituye MAX_DURATION por la duración en segundos del periodo de cierre gradual. El valor debe estar comprendido entre 1 y 3600, es decir,3600 segundos (una hora).

Consola

1. En la consola, ve a la página Plantillas de instancia. Google Cloud

   Ir a Plantillas de instancia

2. Haz clic en Crear plantilla de instancia.

   Se abrirá la página Crear una plantilla de instancia.

3. En el campo Nombre, introduce un nombre para la plantilla de instancia.

4. Selecciona la ubicación de la siguiente manera:

   • Para reducir la dependencia entre regiones creando una plantilla de instancia regional, siga estos pasos:

     1. Elige Regional, si no está seleccionado.

     2. En el campo Región, seleccione la región en la que quiera crear la plantilla de instancia.

   • De lo contrario, para usar la plantilla de instancia en varias regiones, elige Global.

5. En la sección Configuración de la máquina, especifica un tipo de máquina.

6. Despliega la sección expand_more Configuración avanzada del modelo de aprovisionamiento de VMs y, a continuación, haz lo siguiente:

   1. Selecciona la casilla Apagar la VM correctamente.

   2. Opcional: Para especificar un periodo de cierre gradual personalizado, indica una duración en el campo Duración máxima.

7. Haz clic en Crear.

gcloud

Para crear una plantilla de instancia que tenga habilitado el cierre ordenado, usa el comando gcloud beta compute instance-templates create con la marca --graceful-shutdown.

Por ejemplo, para crear una plantilla de instancia regional que tenga habilitado el cierre gradual, ejecuta el siguiente comando:

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --graceful-shutdown \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE

Haz los cambios siguientes:

• INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de instancia.

• REGION: la región en la que se creará la plantilla de instancia.

• MACHINE_TYPE: el tipo de máquina de las instancias creadas con la plantilla de instancia.

Si quiere especificar un periodo de cierre gradual personalizado, incluya la marca --graceful-shutdown-max-duration.

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE

Sustituye MAX_DURATION por la duración del periodo de apagado. El valor debe tener el formato del número de horas, minutos o segundos seguido de h, m y s, respectivamente. Por ejemplo, especifica 1h para una hora o 20m10s para 20 minutos y 10 segundos.

REST

Para crear una plantilla de instancia que tenga habilitado el cierre ordenado, haz una solicitud POST a uno de los siguientes métodos:

• Para crear una plantilla de instancia global, usa el método beta instanceTemplates.insert.

• Para crear una plantilla de instancia regional, usa el método beta regionInstanceTemplates.insert.

Por ejemplo, para crear una plantilla de instancia regional que tenga habilitado el cierre gradual, haz una solicitud POST de la siguiente manera:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "gracefulShutdown": {
        "enabled": true
      }
    }
  }
}

Haz los cambios siguientes:

• PROJECT_ID: el ID del proyecto en el que se va a crear la plantilla de instancia.

• REGION: la región en la que se creará la plantilla de instancia.

• INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de instancia.

• IMAGE_PROJECT: el proyecto de imagen que contiene la imagen (por ejemplo, debian-cloud). Para obtener más información sobre los proyectos de imágenes admitidos, consulta Imágenes públicas.

• IMAGE: especifica una de las siguientes opciones:

  • Una versión específica de la imagen del SO, por ejemplo, debian-12-bookworm-v20240617.

  • Una familia de imágenes, que debe tener el formato family/IMAGE_FAMILY. Este formato especifica la imagen del SO más reciente que no está obsoleta. Por ejemplo, si especificas family/debian-12, se usará la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre cómo usar familias de imágenes, consulte las prácticas recomendadas para familias de imágenes.

• MACHINE_TYPE: el tipo de máquina de las instancias creadas con la plantilla de instancia.

Si quiere especificar un periodo de cierre gradual personalizado, incluya el campo maxDuration en el cuerpo de la solicitud.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/global/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "gracefulShutdown": {
        "enabled": true,
        "maxDuration": {
          "seconds": "MAX_DURATION"
        }
      }
    }
  }
}

Sustituye MAX_DURATION por la duración en segundos del periodo de apagado. El valor debe estar entre 1 y 3600, es decir,3600 segundos (una hora).