Configura la política de mantenimiento del host para una instancia de procesamiento

Console

1. En la Google Cloud consola, 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 que deseas actualizar. Aparecerá una página con los detalles de la instancia.

3. Haz clic en edit Editar. Aparecerá una página que te permitirá editar las propiedades de la instancia.

4. En la sección Administración, puedes realizar una o más de las siguientes acciones:

   • Para cambiar el comportamiento durante los eventos de mantenimiento, selecciona otra opción en la lista Mantenimiento en el host.

   • Para cambiar el período de espera antes de reiniciar una instancia que no responde, selecciona otra opción en la lista Tiempo de espera por error del host.

   • Para cambiar si se reiniciará la instancia o no después de errores del host o detenciones programadas, selecciona otra opción en la lista Reinicio automático.

5. Haz clic en Guardar.

gcloud

Para cambiar la política de mantenimiento del host en una instancia existente, usa el comando gcloud compute instances set-scheduling con una o más de las siguientes marcas:

• Para cambiar el comportamiento del mantenimiento del host, incluye la marca --maintenance-policy.

• Para cambiar el comportamiento de reinicio automático, realiza una de las siguientes acciones:

  • Para reiniciar la instancia automáticamente, incluye la marca --restart-on-failure.

  • Para evitar que la instancia se reinicie automáticamente, incluye la marca --no-restart-on-failure.

• Para cambiar el tiempo de espera de recuperación de datos de SSD local si tu instancia tiene discos SSD locales conectados, incluye la marca --local-ssd-recovery-timeout.

• Para cambiar el tiempo de espera de errores del host, incluye la marca --host-error-timeout-seconds.

Por ejemplo, para cambiar el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores del host o detenciones programadas, cambiar el tiempo de espera de recuperación de datos de SSD local y cambiar el tiempo de espera de error del host, ejecuta el siguiente comando:

gcloud compute instances set-scheduling INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

Reemplaza lo siguiente:

• INSTANCE_NAME: el nombre de tu instancia

• ERROR_DETECTION_TIMEOUT: Es la cantidad de segundos que transcurren antes de que Compute Engine reinicie una instancia que no responde. El valor debe estar entre 90 (90 segundos) y 330 (330 segundos, o 5 minutos y 30 segundos). Solo se permiten incrementos de 30 segundos.

• MAINTENANCE_POLICY: Es el comportamiento de mantenimiento de la instancia. El valor puede ser TERMINATE o MIGRATE.

• LOCAL_SSD_RECOVERY_TIMEOUT: Es la cantidad de horas que se dedicarán a recuperar datos de los discos SSD locales conectados. El valor debe estar entre 0 (0 horas) y 168 (168 horas o 7 días). Si configuras este campo como 0, significa que Compute Engine no recuperará los datos de SSD locales.

• ZONE: Es la zona en la que existe tu instancia.

REST

Para cambiar la política de mantenimiento del host en una instancia existente, realiza una solicitud POST al método instances.setScheduling. En el cuerpo de la solicitud, incluye uno o más de los siguientes campos:

• Para cambiar el comportamiento del mantenimiento del host, incluye el campo onHostMaintenance.

• Para cambiar el comportamiento de reinicio automático, realiza una de las siguientes acciones:

  • Para reiniciar la instancia automáticamente, incluye el campo automaticRestart.

  • Para evitar que la instancia se reinicie automáticamente, incluye el campo automaticRestart.

• Para cambiar el tiempo de espera de recuperación de datos de SSD local si tu instancia tiene discos SSD locales conectados, incluye el campo localSsdRecoveryTimeout.

• Para cambiar el tiempo de espera de errores del host, incluye el campo hostErrorTimeoutSeconds.

Por ejemplo, para cambiar el comportamiento del mantenimiento del host, reiniciar automáticamente la instancia después de errores del host o detenciones programadas, cambiar el tiempo de espera de recuperación de datos del SSD local y cambiar el tiempo de espera de error del host, realiza una solicitud de la siguiente manera:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/setScheduling

{
  "automaticRestart": AUTOMATIC_RESTART,
  "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
  "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
  "onHostMaintenance": "MAINTENANCE_POLICY"
}

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto en el que existe tu instancia.

• ZONE: Es la zona en la que existe tu instancia.

• INSTANCE_NAME: el nombre de tu instancia

• AUTOMATIC_RESTART: Es el comportamiento de reinicio automático de la instancia si falla o si Compute Engine la detiene por una detención programada. Especifica uno de los siguientes valores:

  • Para permitir que Compute Engine reinicie automáticamente tu instancia, haz lo siguiente: true

  • Para evitar los reinicios automáticos, haz lo siguiente: false

• ERROR_DETECTION_TIMEOUT: Es la cantidad de segundos que se espera antes de reiniciar una instancia que no responde. El valor debe estar entre 90 (90 segundos) y 330 (330 segundos, o 5 minutos y 30 segundos). Solo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT: Es la cantidad de horas que se dedicarán a recuperar datos de los discos SSD locales conectados. El valor debe estar entre 0 (0 horas) y 168 (168 horas o 7 días). Si configuras este campo como 0, significa que Compute Engine no recuperará los datos de SSD locales.

• MAINTENANCE_POLICY: Es el comportamiento de mantenimiento de la instancia. El valor puede ser TERMINATE o MIGRATE.

Console

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

   Ir a Crear una instancia

2. En el campo Nombre, ingresa un nombre para el instancia.

3. En los campos Región y Zona, especifica en qué región y zona se creará la instancia.

4. Especifica el tipo de máquina para la instancia.

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

6. En la sección Modelo de aprovisionamiento, expande Configuración avanzada del modelo de aprovisionamiento de VM y, luego, haz una o más de las siguientes acciones:

   • Para establecer el comportamiento durante los eventos de mantenimiento, en la lista Mantenimiento en el host, selecciona una de las siguientes opciones:

     • Para migrar la instancia durante los eventos de mantenimiento del host, selecciona Migrar instancia de VM (recomendado).

     • Para detener la instancia durante los eventos de mantenimiento del host, selecciona Finalizar instancia de VM.

   • Para establecer el período de espera antes de reiniciar una instancia que no responde, en la lista Tiempo de espera por error del host, selecciona una de las siguientes opciones:

     • Para no especificar un tiempo de espera de error del host, selecciona Sin especificar (predeterminado).

     • Para especificar un tiempo de espera por error del host, selecciona una de las opciones disponibles, hasta 5 minutos y 30 segundos.

   • Para configurar si se debe reiniciar la instancia si falla o se detiene, en la lista Reinicio automático, selecciona una de las siguientes opciones:

     • Para reiniciar automáticamente la instancia después de errores del host o detenciones programadas, selecciona Activado (recomendado).

     • Para evitar que la instancia se reinicie automáticamente después de errores del host o detenciones programadas, selecciona Desactivado.

7. Haz clic en Crear.

gcloud

Para establecer la política de mantenimiento del host de una instancia mientras la creas, usa el comando gcloud compute instances create con una o más de las siguientes marcas:

• Para establecer el comportamiento de mantenimiento del host, incluye la marca --maintenance-policy.

• Para establecer el comportamiento de reinicio automático, realiza una de las siguientes acciones:

  • Para reiniciar la instancia automáticamente, incluye la marca --restart-on-failure.

  • Para evitar que la instancia se reinicie automáticamente, incluye la marca --no-restart-on-failure.

• Para establecer un tiempo de espera de recuperación de datos de SSD local si tu instancia tiene discos SSD locales conectados, incluye la marca --local-ssd-recovery-timeout.

• Para establecer un tiempo de espera de error del host, incluye la marca --host-error-timeout-seconds.

Por ejemplo, para establecer el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores de host o detenciones programadas, establecer un tiempo de espera para la recuperación de datos de SSD local y establecer un tiempo de espera para errores de host, ejecuta el siguiente comando:

gcloud compute instances create INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

Reemplaza lo siguiente:

• INSTANCE_NAME: El nombre de la instancia.

• ERROR_DETECTION_TIMEOUT: Es la cantidad de segundos que se espera antes de reiniciar una instancia que no responde. El valor debe estar entre 90 (90 segundos) y 330 (330 segundos, o 5 minutos y 30 segundos). Solo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT: Es la cantidad de horas que se dedicarán a recuperar datos de los discos SSD locales conectados. El valor debe estar entre 0 (0 horas) y 168 (168 horas o 7 días). Si configuras este campo como 0, significa que Compute Engine no recuperará los datos de SSD locales.

• MACHINE_TYPE: Es el tipo de máquina que se usará.

• MAINTENANCE_POLICY: Es el comportamiento de mantenimiento de la instancia. El valor puede ser TERMINATE o MIGRATE. Si creas una VM Spot, una VM interrumpible o una instancia que no admite la migración en vivo, solo puedes usar TERMINATE.

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

REST

Para establecer la política de mantenimiento del host de una instancia mientras la creas, realiza una solicitud POST al método instances.insert. En el cuerpo de la solicitud, incluye uno o más de los siguientes campos en el campo scheduling:

• Para establecer el comportamiento de mantenimiento del host, incluye el campo onHostMaintenance.

• Para establecer el comportamiento de reinicio automático, realiza una de las siguientes acciones:

  • Para reiniciar la instancia automáticamente, incluye el campo automaticRestart.

  • Para evitar que la instancia se reinicie automáticamente, incluye el campo automaticRestart.

• Para establecer un tiempo de espera de recuperación de datos de SSD local si tu instancia tiene discos SSD locales conectados, incluye el campo localSsdRecoveryTimeout.

• Para establecer un tiempo de espera de error del host, incluye el campo hostErrorTimeoutSeconds.

Por ejemplo, para establecer el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores de host o detenciones programadas, establecer un tiempo de espera de recuperación de datos de SSD local y establecer un tiempo de espera de error de host, realiza una solicitud de la siguiente manera:

POST https://compute.googleapis.com/compute/v1/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": {
    "automaticRestart": AUTOMATIC_RESTART,
    "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
    "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
    "onHostMaintenance": "MAINTENANCE_POLICY"
  }
}

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto en el que se creará la instancia.

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

• INSTANCE_NAME: El nombre de la instancia.

• MACHINE_TYPE: Es el tipo de máquina que se usará.

• 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 compatibles, consulta Imágenes públicas.

• IMAGE: especifica una de las siguientes opciones:

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

  • Una familia de imágenes, que debe tener el formato family/IMAGE_FAMILY. Esto especifica la imagen de SO no obsoleta más reciente. Por ejemplo, si especificas family/debian-12, se usa la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre el uso de las familias de imágenes, consulta Prácticas recomendadas para las familias de imágenes.

• AUTOMATIC_RESTART: Es el comportamiento de reinicio automático de la instancia si falla o si Compute Engine la detiene por una detención programada. Especifica uno de los siguientes valores:

  • Para permitir que Compute Engine reinicie automáticamente tu instancia, haz lo siguiente: true

  • Para evitar los reinicios automáticos, haz lo siguiente: false

• ERROR_DETECTION_TIMEOUT: Es la cantidad de segundos que se espera antes de reiniciar una instancia que no responde. El valor debe estar entre 90 (90 segundos) y 330 (330 segundos, o 5 minutos y 30 segundos). Solo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT: Es la cantidad de horas que se dedicarán a recuperar datos de los discos SSD locales conectados. El valor debe estar entre 0 (0 horas) y 168 (168 horas o 7 días). Si configuras este campo como 0, significa que Compute Engine no recuperará los datos de SSD locales.

• MAINTENANCE_POLICY: Es el comportamiento de mantenimiento de la instancia. El valor puede ser TERMINATE o MIGRATE. Si creas una VM Spot o una instancia que no admite la migración en vivo, solo puedes usar TERMINATE.

gcloud

Para establecer la política de mantenimiento del host mientras creas instancias de forma masiva, usa el comando gcloud compute instances bulk create con una o más de las siguientes marcas:

• Para establecer el comportamiento de mantenimiento del host, incluye la marca --maintenance-policy.

• Para establecer el comportamiento de reinicio automático, realiza una de las siguientes acciones:

  • Para reiniciar la instancia automáticamente, incluye la marca --restart-on-failure.

  • Para evitar que la instancia se reinicie automáticamente, incluye la marca --no-restart-on-failure.

• Para establecer un tiempo de espera de recuperación de datos de SSD local si tu instancia tiene discos SSD locales conectados, incluye la marca --local-ssd-recovery-timeout.

• Para establecer un tiempo de espera de error del host, incluye la marca --host-error-timeout-seconds.

Por ejemplo, para establecer el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores de host o detenciones programadas, establecer un tiempo de espera de recuperación de datos de SSD local y establecer un tiempo de espera de error de host, ejecuta el siguiente comando. En el siguiente ejemplo, también se crean instancias en una sola zona y se especifica un patrón de nombre para las instancias:

gcloud compute instances bulk create \
    --count=COUNT \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --name-pattern=NAME_PATTERN \
    --restart-on-failure \
    --zone=ZONE

Reemplaza lo siguiente:

• COUNT: Es la cantidad de instancias que se crearán.

• ERROR_DETECTION_TIMEOUT: Es la cantidad de segundos que se espera antes de reiniciar una instancia que no responde. El valor debe estar entre 90 (90 segundos) y 330 (330 segundos, o 5 minutos y 30 segundos). Solo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT: Es la cantidad de horas que se dedicarán a recuperar datos de los discos SSD locales conectados. El valor debe estar entre 0 (0 horas) y 168 (168 horas o 7 días). Si configuras este campo como 0, significa que Compute Engine no recuperará los datos de SSD locales.

• MACHINE_TYPE: Es el tipo de máquina que se usará.

• MAINTENANCE_POLICY: Es el comportamiento de mantenimiento de las instancias. El valor puede ser TERMINATE o MIGRATE. Si creas VMs Spot, VMs interrumpibles o instancias que no admiten la migración en vivo, solo puedes usar TERMINATE.

• NAME_PATTERN: Es el patrón del nombre de las instancias. Para reemplazar una secuencia de números en el nombre de una instancia, usa una secuencia de caracteres hash (#). Por ejemplo, si usas instance-# para el patrón de nombre, se generan instancias con nombres que comienzan con instance-1, instance-2 y continúan hasta la cantidad de instancias especificadas por COUNT.

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

REST

Para establecer la política de mantenimiento del host mientras creas instancias de forma masiva, realiza una solicitud POST al método instances.bulkInsert. En el cuerpo de la solicitud, incluye uno o más de los siguientes campos en el campo scheduling:

• Para establecer el comportamiento de mantenimiento del host, incluye el campo onHostMaintenance.

• Para establecer el comportamiento de reinicio automático, realiza una de las siguientes acciones:

  • Para reiniciar la instancia automáticamente, incluye el campo automaticRestart.

  • Para evitar que la instancia se reinicie automáticamente, incluye el campo automaticRestart.

• Para establecer un tiempo de espera de recuperación de datos de SSD local si tu instancia tiene discos SSD locales conectados, incluye el campo localSsdRecoveryTimeout.

• Para establecer un tiempo de espera de error del host, incluye el campo hostErrorTimeoutSeconds.

Por ejemplo, para establecer el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores de host o detenciones programadas, establecer un tiempo de espera de recuperación de datos de SSD local y establecer un tiempo de espera de error de host, realiza una solicitud de la siguiente manera. En el siguiente ejemplo, también se crean instancias en una sola zona y se especifica un patrón de nombre para las instancias:

POST https://compute.googleapis.com/compute/v1/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": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Reemplaza lo siguiente:

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

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

• COUNT: Es la cantidad de instancias que se crearán.

• NAME_PATTERN: Es el patrón del nombre de las instancias. Para reemplazar una secuencia de números en el nombre de una instancia, usa una secuencia de caracteres hash (#). Por ejemplo, si usas instance-# para el patrón de nombre, se generan instancias con nombres que comienzan con instance-1, instance-2 y continúan hasta la cantidad de instancias especificadas por COUNT.

• MACHINE_TYPE: Es el tipo de máquina que se usará.

• 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 compatibles, consulta Imágenes públicas.

• IMAGE: especifica una de las siguientes opciones:

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

  • Una familia de imágenes, que debe tener el formato family/IMAGE_FAMILY. Esto especifica la imagen de SO no obsoleta más reciente. Por ejemplo, si especificas family/debian-12, se usa la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre el uso de las familias de imágenes, consulta Prácticas recomendadas para las familias de imágenes.

• AUTOMATIC_RESTART: Es el comportamiento de reinicio automático de la instancia si falla o si Compute Engine la detiene por una detención programada. Especifica uno de los siguientes valores:

  • Para permitir que Compute Engine reinicie automáticamente tu instancia, haz lo siguiente: true

  • Para evitar los reinicios automáticos, haz lo siguiente: false

• ERROR_DETECTION_TIMEOUT: Es la cantidad de segundos que se espera antes de reiniciar una instancia que no responde. El valor debe estar entre 90 (90 segundos) y 330 (330 segundos, o 5 minutos y 30 segundos). Solo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT: Es la cantidad de horas que se dedicarán a recuperar datos de los discos SSD locales conectados. El valor debe estar entre 0 (0 horas) y 168 (168 horas o 7 días). Si configuras este campo como 0, significa que Compute Engine no recuperará los datos de SSD locales.

• MAINTENANCE_POLICY: Es el comportamiento de mantenimiento de las instancias. El valor puede ser TERMINATE o MIGRATE. Si creas VMs Spot, VMs interrumpibles o instancias que no admiten la migración en vivo, solo puedes usar TERMINATE.

Console

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

   Ir a Plantillas de instancia

2. Haz clic en Crear plantilla de instancias. Aparecerá la página Crear plantilla de instancias.

3. En el campo Nombre, ingresa un nombre para la plantilla de instancias.

4. En la sección Ubicación, selecciona una de las siguientes opciones:

   • Para crear una plantilla de instancias regional, selecciona Regional (recomendado) y, luego, la región en la que deseas crear la plantilla.

   • Para crear una plantilla de instancias global, selecciona Global.

5. En la sección Configuración de máquina, especifica el tipo de máquina para la plantilla de instancias.

6. En la sección Modelo de aprovisionamiento, expande Configuración avanzada del modelo de aprovisionamiento de VM y, luego, haz una o más de las siguientes acciones:

   • Para cambiar el comportamiento durante los eventos de mantenimiento, en la lista Mantenimiento en el host, selecciona una de las siguientes opciones:

     • Para migrar la instancia durante los eventos de mantenimiento del host, selecciona Migrar instancia de VM (recomendado).

     • Para detener la instancia durante los eventos de mantenimiento del host, selecciona Finalizar instancia de VM.

   • Para cambiar el período de espera antes de reiniciar una instancia que no responde, en la lista Tiempo de espera por error del host, selecciona una de las siguientes opciones:

     • Para no especificar un tiempo de espera de error del host, selecciona Sin especificar (predeterminado).

     • Para especificar un tiempo de espera por error del host, selecciona una de las opciones disponibles, hasta 5 minutos y 30 segundos.

   • Para cambiar si se reiniciará la instancia en caso de que falle o se detenga, en la lista Reinicio automático, selecciona una de las siguientes opciones:

     • Para reiniciar automáticamente la instancia después de errores del host o detenciones programadas, selecciona Activado (recomendado).

     • Para evitar que la instancia se reinicie automáticamente después de errores del host o detenciones programadas, selecciona Desactivado.

7. Haz clic en Crear.

gcloud

Para establecer la política de mantenimiento del host mientras creas una plantilla de instancias, usa el comando gcloud compute instance-templates create con una o más de las siguientes marcas:

• Para establecer el comportamiento de mantenimiento del host, incluye el campo onHostMaintenance.

• Para establecer el comportamiento de reinicio automático, realiza una de las siguientes acciones:

  • Para reiniciar la instancia automáticamente, incluye el campo automaticRestart.

  • Para evitar que la instancia se reinicie automáticamente, incluye el campo automaticRestart.

• Para establecer un tiempo de espera de recuperación de datos de SSD local si tu instancia tiene discos SSD locales conectados, incluye el campo localSsdRecoveryTimeout.

• Para establecer un tiempo de espera de error del host, incluye el campo hostErrorTimeoutSeconds.

Por ejemplo, para establecer el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores de host o detenciones programadas, establecer un tiempo de espera de recuperación de datos de SSD local y establecer un tiempo de espera de error de host, ejecuta el siguiente comando. En el siguiente ejemplo, también se crea una plantilla de instancias regional. Para crear una plantilla de instancias global, usa el mismo comando sin la marca --instance-template-region.

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --instance-template-region=REGION \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure

Reemplaza lo siguiente:

• INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de instancias.

• ERROR_DETECTION_TIMEOUT: Es la cantidad de segundos que se espera antes de reiniciar una instancia que no responde. El valor debe estar entre 90 (90 segundos) y 330 (330 segundos, o 5 minutos y 30 segundos). Solo se permiten incrementos de 30 segundos.

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

• LOCAL_SSD_RECOVERY_TIMEOUT: Es la cantidad de horas que se dedicarán a recuperar datos de los discos SSD locales conectados. El valor debe estar entre 0 (0 horas) y 168 (168 horas o 7 días). Si configuras este campo como 0, significa que Compute Engine no recuperará los datos de SSD locales.

• MACHINE_TYPE: Es el tipo de máquina que se usará.

• MAINTENANCE_POLICY: Es el comportamiento de mantenimiento de las instancias. El valor puede ser TERMINATE o MIGRATE. Si especificas una VM Spot, una VM interrumpible o un tipo de instancia que no admite la migración en vivo en la plantilla de instancias, solo puedes usar TERMINATE.

REST

Para establecer la política de mantenimiento del host mientras creas una plantilla de instancias, realiza una solicitud POST a uno de los siguientes métodos:

• Para crear una plantilla de instancias regional: método regionInstanceTemplates.insert

• Para crear una plantilla de instancias global: método instanceTemplates.insert

En el cuerpo de la solicitud, incluye uno o más de los siguientes campos en el campo scheduling:

• Para establecer el comportamiento de mantenimiento del host, incluye el campo onHostMaintenance.

• Para establecer el comportamiento de reinicio automático, realiza una de las siguientes acciones:

  • Para reiniciar la instancia automáticamente, incluye el campo automaticRestart.

  • Para evitar que la instancia se reinicie automáticamente, incluye el campo automaticRestart.

• Para establecer un tiempo de espera de recuperación de datos de SSD local si tu instancia tiene discos SSD locales conectados, incluye el campo localSsdRecoveryTimeout.

• Para establecer un tiempo de espera de error del host, incluye el campo hostErrorTimeoutSeconds.

Por ejemplo, para establecer el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores de host o detenciones programadas, establecer un tiempo de espera de recuperación de datos de SSD local y establecer un tiempo de espera de error de host, realiza una solicitud de la siguiente manera. En el siguiente ejemplo, también se crea una plantilla de instancias regional.

POST https://compute.googleapis.com/compute/v1/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": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Reemplaza lo siguiente:

• PROJECT_ID: el ID del proyecto en el que se creará la plantilla de instancias.

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

• INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de 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 compatibles, consulta Imágenes públicas.

• IMAGE: especifica una de las siguientes opciones:

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

  • Una familia de imágenes, que debe tener el formato family/IMAGE_FAMILY. Esto especifica la imagen de SO no obsoleta más reciente. Por ejemplo, si especificas family/debian-12, se usa la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre el uso de las familias de imágenes, consulta Prácticas recomendadas para las familias de imágenes.

• MACHINE_TYPE: Es el tipo de máquina que se usará.

• AUTOMATIC_RESTART: Es el comportamiento de reinicio automático de la instancia si falla o si Compute Engine la detiene por una detención programada. Especifica uno de los siguientes valores:

  • Para permitir que Compute Engine reinicie automáticamente tu instancia, haz lo siguiente: true

  • Para evitar los reinicios automáticos, haz lo siguiente: false

• ERROR_DETECTION_TIMEOUT: Es la cantidad de segundos que se espera antes de reiniciar una instancia que no responde. El valor debe estar entre 90 (90 segundos) y 330 (330 segundos, o 5 minutos y 30 segundos). Solo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT: Es la cantidad de horas que se dedicarán a recuperar datos de los discos SSD locales conectados. El valor debe estar entre 0 (0 horas) y 168 (168 horas o 7 días). Si configuras este campo como 0, significa que Compute Engine no recuperará los datos de SSD locales.

• MAINTENANCE_POLICY: Es el comportamiento de mantenimiento de las instancias. El valor puede ser TERMINATE o MIGRATE. Si especificas una VM Spot, una VM interrumpible o un tipo de instancia que no admite la migración en vivo en la plantilla de instancias, solo puedes usar TERMINATE.

Console

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

   Ir a Instancias de VM

2. En la columna Nombre, haz clic en la instancia que deseas ver. Aparecerá una página con los detalles de la instancia.

3. En la pestaña Detalles, en la sección Administración, en la sección Políticas de disponibilidad, puedes ver lo siguiente:

   • En el campo En mantenimiento del host, puedes ver los eventos de comportamiento de mantenimiento del host de la instancia.

   • En el campo Tiempo de espera por error del host, puedes ver la cantidad de tiempo que espera la instancia antes de reiniciarla o detenerla después de detectar que no responde. Si el valor no está configurado (—), el tiempo de espera predeterminado es de 5 minutos y 30 segundos.

   • En el campo de reinicio Reinicio automático, puedes ver si la instancia se reinicia automáticamente después de fallar o si Compute Engine la detiene para una detención programada.

gcloud

Para ver la política de mantenimiento del host de una instancia, usa el comando gcloud compute instances describe con la marca --flatten establecida en scheduling:

 gcloud compute instances describe INSTANCE_NAME \
    --flatten=scheduling \
    --zone=ZONE

Reemplaza lo siguiente:

• INSTANCE_NAME: El nombre de la instancia.

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

El resultado es similar a este:

---
scheduling:
  automaticRestart: true
  hostErrorTimeoutSeconds: 120
  localSsdRecoveryTimeout:
    nanos: 0
    seconds: '10800'
  onHostMaintenance: MIGRATE
  preemptible: false
  provisioningModel: STANDARD

REST

Para ver la política de mantenimiento del host de una instancia, realiza una solicitud GET al método instances.get. En la URL de la solicitud, incluye el parámetro de búsqueda fields y configúralo como scheduling:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?fields=scheduling

Reemplaza lo siguiente:

• PROJECT_ID: Es el proyecto en el que existe la instancia.

• ZONE: Es la zona en la que existe la instancia.

• INSTANCE_NAME: El nombre de la instancia.

El resultado es similar a este:

{
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD",
    "localSsdRecoveryTimeout": {
      "seconds": "10800",
      "nanos": 0
    }
  }
}