Establecer la política de mantenimiento del host para una instancia informática

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

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 la instancia que desea actualizar. Aparece una página que proporciona los detalles de la instancia.

3. Haga clic en edit Editar . Aparece una página que le permite editar las propiedades de la instancia.

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

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

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

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

5. Haga clic en Guardar .

nube de 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 de mantenimiento del host, incluya el indicador --maintenance-policy .

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

  • Para reiniciar automáticamente la instancia, incluya el indicador --restart-on-failure .

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

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

• Para cambiar el tiempo de espera del error del host, incluya 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 paradas programadas, cambiar el tiempo de espera de recuperación de datos del SSD local y cambiar el tiempo de espera de error del host, ejecute 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

Reemplace lo siguiente:

• INSTANCE_NAME : el nombre de tu instancia.

• ERROR_DETECTION_TIMEOUT : la cantidad de segundos 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). Sólo se permiten incrementos de 30 segundos.

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

• LOCAL_SSD_RECOVERY_TIMEOUT : 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). Establecer este campo en 0 significa que Compute Engine no recupera los datos del SSD local.

• ZONE : la zona donde existe su instancia.

DESCANSAR

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

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

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

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

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

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

• Para cambiar el tiempo de espera del error del host, incluya el campo hostErrorTimeoutSeconds .

Por ejemplo, para cambiar el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores del host o paradas programadas, cambiar el tiempo de espera de recuperación de datos del SSD local y cambiar el tiempo de espera de error del host, realice 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"
}

Reemplace lo siguiente:

• PROJECT_ID : el ID del proyecto donde existe su instancia.

• ZONE : la zona donde existe su instancia.

• INSTANCE_NAME : el nombre de tu instancia.

• AUTOMATIC_RESTART : el comportamiento de reinicio automático de la instancia si falla o Compute Engine la detiene para una parada programada. Especifique uno de los siguientes valores:

  • Para permitir que Compute Engine reinicie automáticamente tu instancia: true

  • Para evitar reinicios automáticos: false

• ERROR_DETECTION_TIMEOUT : la cantidad de segundos 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). Sólo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT : 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). Establecer este campo en 0 significa que Compute Engine no recupera los datos del SSD local.

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

Consola

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

   Ir a Crear una instancia

2. En el campo Nombre , ingrese un nombre para la instancia.

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

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

5. En el menú de navegación, haga clic en Avanzado .

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

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

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

     • Para detener la instancia durante los eventos de mantenimiento del host, seleccione Terminar instancia de VM .

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

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

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

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

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

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

7. Haga clic en Crear .

nube de gcloud

Para configurar 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 configurar el comportamiento de mantenimiento del host, incluya el indicador --maintenance-policy .

• Para configurar el comportamiento de reinicio automático, realice una de las siguientes acciones:

  • Para reiniciar automáticamente la instancia, incluya el indicador --restart-on-failure .

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

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

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

Por ejemplo, para configurar el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores del host o paradas programadas, establecer un tiempo de espera de recuperación de datos de SSD local y establecer un tiempo de espera de error del host, ejecute 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

Reemplace lo siguiente:

• INSTANCE_NAME : el nombre de la instancia.

• ERROR_DETECTION_TIMEOUT : la cantidad de segundos 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). Sólo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT : 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). Establecer este campo en 0 significa que Compute Engine no recupera los datos del SSD local.

• MACHINE_TYPE : el tipo de máquina a utilizar.

• MAINTENANCE_POLICY : el comportamiento de mantenimiento de la instancia. El valor puede ser TERMINATE o MIGRATE . Si está creando una máquina virtual puntual, una máquina virtual interrumpible o una instancia que no admite la migración en vivo , solo puede usar TERMINATE .

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

DESCANSAR

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

• Para configurar el comportamiento de mantenimiento del host, incluya el campo onHostMaintenance .

• Para configurar el comportamiento de reinicio automático, realice una de las siguientes acciones:

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

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

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

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

Por ejemplo, para configurar el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores del host o paradas programadas, establecer un tiempo de espera de recuperación de datos de SSD local y establecer un tiempo de espera de error del host, realice 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"
  }
}

Reemplace lo siguiente:

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

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

• INSTANCE_NAME : el nombre de la instancia.

• MACHINE_TYPE : el tipo de máquina a utilizar.

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

• IMAGE : especifique uno de los siguientes:

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

  • Una familia de imágenes , que debe tener el formato family/ IMAGE_FAMILY . Esto especifica la imagen del sistema operativo más reciente y no obsoleta. Por ejemplo, si especifica family/debian-12 , se utiliza la última versión de la familia de imágenes de Debian 12. Para obtener más información sobre el uso de familias de imágenes, consulte Mejores prácticas de familias de imágenes .

• AUTOMATIC_RESTART : el comportamiento de reinicio automático de la instancia si falla o Compute Engine la detiene para una parada programada. Especifique uno de los siguientes valores:

  • Para permitir que Compute Engine reinicie automáticamente tu instancia: true

  • Para evitar reinicios automáticos: false

• ERROR_DETECTION_TIMEOUT : la cantidad de segundos 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). Sólo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT : 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). Establecer este campo en 0 significa que Compute Engine no recupera los datos del SSD local.

• MAINTENANCE_POLICY : el comportamiento de mantenimiento de la instancia. El valor puede ser TERMINATE o MIGRATE . Si está creando una máquina virtual puntual o una instancia que no admite la migración en vivo , solo puede usar TERMINATE .

nube de gcloud

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

• Para configurar el comportamiento de mantenimiento del host, incluya el indicador --maintenance-policy .

• Para configurar el comportamiento de reinicio automático, realice una de las siguientes acciones:

  • Para reiniciar automáticamente la instancia, incluya el indicador --restart-on-failure .

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

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

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

Por ejemplo, para configurar el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores del host o paradas programadas, establecer un tiempo de espera de recuperación de datos de SSD local y establecer un tiempo de espera de error del host, ejecute el siguiente comando. El siguiente ejemplo también crea instancias en una única zona y 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

Reemplace lo siguiente:

• COUNT : el número de instancias a crear.

• ERROR_DETECTION_TIMEOUT : la cantidad de segundos 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). Sólo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT : 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). Establecer este campo en 0 significa que Compute Engine no recupera los datos del SSD local.

• MACHINE_TYPE : el tipo de máquina a utilizar.

• MAINTENANCE_POLICY : el comportamiento de mantenimiento de las instancias. El valor puede ser TERMINATE o MIGRATE . Si está creando máquinas virtuales puntuales, máquinas virtuales interrumpibles o instancias que no admiten la migración en vivo , solo puede usar TERMINATE .

• NAME_PATTERN : el patrón de nombre de las instancias. Para reemplazar una secuencia de números en el nombre de una instancia, utilice una secuencia de caracteres almohadilla ( # ). Por ejemplo, el uso de instance-# para el patrón de nombre genera instancias con nombres que comienzan con instance-1 , instance-2 y continúan hasta el número de instancias especificado por COUNT .

• ZONE : la zona en la que crear las instancias.

DESCANSAR

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

• Para configurar el comportamiento de mantenimiento del host, incluya el campo onHostMaintenance .

• Para configurar el comportamiento de reinicio automático, realice una de las siguientes acciones:

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

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

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

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

Por ejemplo, para configurar el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores del host o paradas programadas, establecer un tiempo de espera de recuperación de datos de SSD local y establecer un tiempo de espera de error del host, realice una solicitud de la siguiente manera. El siguiente ejemplo también crea instancias en una única zona y 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"
    }
  }
}

Reemplace lo siguiente:

• PROJECT_ID : el ID del proyecto en el que crear las instancias.

• ZONE : la zona en la que crear las instancias.

• COUNT : el número de instancias a crear.

• NAME_PATTERN : el patrón de nombre de las instancias. Para reemplazar una secuencia de números en el nombre de una instancia, utilice una secuencia de caracteres almohadilla ( # ). Por ejemplo, el uso de instance-# para el patrón de nombre genera instancias con nombres que comienzan con instance-1 , instance-2 y continúan hasta el número de instancias especificado por COUNT .

• MACHINE_TYPE : el tipo de máquina a utilizar.

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

• IMAGE : especifique uno de los siguientes:

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

  • Una familia de imágenes , que debe tener el formato family/ IMAGE_FAMILY . Esto especifica la imagen del sistema operativo más reciente y no obsoleta. Por ejemplo, si especifica family/debian-12 , se utiliza la última versión de la familia de imágenes de Debian 12. Para obtener más información sobre el uso de familias de imágenes, consulte Mejores prácticas de familias de imágenes .

• AUTOMATIC_RESTART : el comportamiento de reinicio automático de la instancia si falla o Compute Engine la detiene para una parada programada. Especifique uno de los siguientes valores:

  • Para permitir que Compute Engine reinicie automáticamente tu instancia: true

  • Para evitar reinicios automáticos: false

• ERROR_DETECTION_TIMEOUT : la cantidad de segundos 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). Sólo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT : 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). Establecer este campo en 0 significa que Compute Engine no recupera los datos del SSD local.

• MAINTENANCE_POLICY : el comportamiento de mantenimiento de las instancias. El valor puede ser TERMINATE o MIGRATE . Si está creando máquinas virtuales puntuales, máquinas virtuales interrumpibles o instancias que no admiten la migración en vivo , solo puede usar TERMINATE .

Consola

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

   Ir a plantillas de instancia

2. Haga clic en Crear plantilla de instancia . Aparece la página Crear plantilla de instancia .

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

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

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

   • Para crear una plantilla de instancia global, seleccione Global .

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

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

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

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

     • Para detener la instancia durante los eventos de mantenimiento del host, seleccione Terminar instancia de VM .

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

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

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

   • Para cambiar si se reinicia la instancia si falla o se detiene, en la lista Reinicio automático , seleccione una de las siguientes opciones:

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

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

7. Haga clic en Crear .

nube de gcloud

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

• Para configurar el comportamiento de mantenimiento del host, incluya el campo onHostMaintenance .

• Para configurar el comportamiento de reinicio automático, realice una de las siguientes acciones:

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

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

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

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

Por ejemplo, para configurar el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores del host o paradas programadas, establecer un tiempo de espera de recuperación de datos de SSD local y establecer un tiempo de espera de error del host, ejecute el siguiente comando. El siguiente ejemplo también crea una plantilla de instancia regional. Para crear una plantilla de instancia global, use el mismo comando sin el indicador --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

Reemplace lo siguiente:

• INSTANCE_TEMPLATE_NAME : el nombre de la plantilla de instancia.

• ERROR_DETECTION_TIMEOUT : la cantidad de segundos 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). Sólo se permiten incrementos de 30 segundos.

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

• LOCAL_SSD_RECOVERY_TIMEOUT : 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). Establecer este campo en 0 significa que Compute Engine no recupera los datos del SSD local.

• MACHINE_TYPE : el tipo de máquina a utilizar.

• MAINTENANCE_POLICY : el comportamiento de mantenimiento de las instancias. El valor puede ser TERMINATE o MIGRATE . Si especifica una máquina virtual puntual, una máquina virtual interrumpible o un tipo de instancia que no admite la migración en vivo en la plantilla de instancia, solo puede usar TERMINATE .

DESCANSAR

Para configurar la política de mantenimiento del host mientras crea una plantilla de instancia, realice una solicitud POST a uno de los siguientes métodos:

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

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

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

• Para configurar el comportamiento de mantenimiento del host, incluya el campo onHostMaintenance .

• Para configurar el comportamiento de reinicio automático, realice una de las siguientes acciones:

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

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

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

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

Por ejemplo, para configurar el comportamiento de mantenimiento del host, reiniciar automáticamente la instancia después de errores del host o paradas programadas, establecer un tiempo de espera de recuperación de datos de SSD local y establecer un tiempo de espera de error del host, realice una solicitud de la siguiente manera. El siguiente ejemplo también crea una plantilla de instancia 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"
    }
  }
}

Reemplace lo siguiente:

• PROJECT_ID : el ID del proyecto en el que 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, consulte Imágenes públicas .

• IMAGE : especifique uno de los siguientes:

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

  • Una familia de imágenes , que debe tener el formato family/ IMAGE_FAMILY . Esto especifica la imagen del sistema operativo más reciente y no obsoleta. Por ejemplo, si especifica family/debian-12 , se utiliza la última versión de la familia de imágenes de Debian 12. Para obtener más información sobre el uso de familias de imágenes, consulte Mejores prácticas de familias de imágenes .

• MACHINE_TYPE : el tipo de máquina a utilizar.

• AUTOMATIC_RESTART : el comportamiento de reinicio automático de la instancia si falla o Compute Engine la detiene para una parada programada. Especifique uno de los siguientes valores:

  • Para permitir que Compute Engine reinicie automáticamente tu instancia: true

  • Para evitar reinicios automáticos: false

• ERROR_DETECTION_TIMEOUT : la cantidad de segundos 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). Sólo se permiten incrementos de 30 segundos.

• LOCAL_SSD_RECOVERY_TIMEOUT : 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). Establecer este campo en 0 significa que Compute Engine no recupera los datos del SSD local.

• MAINTENANCE_POLICY : el comportamiento de mantenimiento de las instancias. El valor puede ser TERMINATE o MIGRATE . Si especifica una máquina virtual puntual, una máquina virtual interrumpible o un tipo de instancia que no admite la migración en vivo en la plantilla de instancia, solo puede usar TERMINATE .

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 la instancia que desea ver. Aparece una página que proporciona 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 , puede ver lo siguiente:

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

   • En el campo Tiempo de espera de error del host , puede 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á establecido ( — ), entonces el tiempo de espera predeterminado es de 5 minutos y 30 segundos.

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

nube de gcloud

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

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

Reemplace lo siguiente:

• INSTANCE_NAME : el nombre de la instancia.

• ZONE : la zona donde se encuentra la instancia.

El resultado es similar al siguiente:

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

DESCANSAR

Para ver la política de mantenimiento del host para una instancia, realice una solicitud GET al método instances.get . En la URL de solicitud, incluya el parámetro de consulta fields y configúrelo en scheduling :

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

Reemplace lo siguiente:

• PROJECT_ID : el proyecto donde existe la instancia.

• ZONE : la zona donde existe la instancia.

• INSTANCE_NAME : el nombre de la instancia.

El resultado es similar al siguiente:

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