Aplicar actualizaciones de configuración durante las reparaciones

En este documento se describe cómo configurar un MIG para aplicar la plantilla de instancia más reciente y las configuraciones por instancia al recrear una VM durante las operaciones de reparación. Aplicar la última configuración disponible durante una operación de reparación también se conoce como actualización durante la reparación. En este documento también se describe cómo comprobar si la actualización durante la reparación está habilitada en tu MIG y, si lo está, cómo inhabilitarla.

De forma predeterminada, durante una reparación, un MIG vuelve a crear una VM con la misma configuración de instancia que se usó originalmente para crearla. Si hay actualizaciones disponibles para la plantilla de instancia del grupo o para las configuraciones por instancia, puedes aplicar estos cambios a una máquina virtual que se esté reparando.

Si quieres aplicar automáticamente las actualizaciones de configuración a todas las VMs o a un conjunto de ellas (PROACTIVE), o bien actualizar selectivamente instancias específicas (OPPORTUNISTIC), consulta el artículo Aplicar nuevas configuraciones a las VMs de un MIG.

Antes de empezar

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

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

    Console

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

    gcloud

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

      gcloud init

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

    2. Set a default region and zone.

    REST

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

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

      gcloud init

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

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

Configurar la actualización en la reparación

Para configurar la actualización en caso de reparación, usa la Google Cloud consola, gcloud CLI o REST.

Consola

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

    Ir a Grupos de instancias

  2. Haz clic en el nombre del MIG en el que quieras configurar la actualización durante la reparación.

  3. Haz clic en Editar para modificar el MIG.

  4. Haga clic en Ciclo de vida de la instancia y reparación automática para desplegar la sección.

  5. En la sección Updates during VM instance repair (Actualizaciones durante la reparación de la instancia de VM), selecciona Update the instance configuration (Actualizar la configuración de la instancia).

  6. Haz clic en Guardar.

gcloud

En el caso de un MIG que ya tengas, usa el comando update:

gcloud compute instance-groups managed update MIG_NAME \
    --force-update-on-repair

Para crear un MIG, usa el comando create:

gcloud compute instance-groups managed create MIG_NAME \
    --template INSTANCE_TEMPLATE_URL_ \
    --size SIZE \
    --force-update-on-repair

Haz los cambios siguientes:

  • MIG_NAME: el nombre del grupo de instancias.
  • INSTANCE_TEMPLATE_URL: la URL de la plantilla de instancia que quieres usar para crear VMs en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancia. Especifica uno de los siguientes valores:
    • En el caso de una plantilla de instancia regional, haz lo siguiente: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • En el caso de una plantilla de instancia global, haz lo siguiente: INSTANCE_TEMPLATE_ID
  • SIZE: tamaño objetivo del grupo de instancias.

REST

En el caso de un MIG de zona, usa el método instanceGroupManagers.patch. En el caso de un MIG regional, usa el método regionInstanceGroupManagers.patch.

Haz la siguiente llamada para configurar la actualización al reparar en un MIG zonal:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME
{
  "instanceLifecyclePolicy": {
    "forceUpdateOnRepair": YES
  }
}

Para crear un grupo de instancias gestionado zonal, usa el método instanceGroupManagers.insert. Para crear un grupo de instancias gestionado regional, usa el método regionInstanceGroupManagers.insert.

Haz la siguiente llamada para configurar la actualización al reparar cuando crees un MIG zonal:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers
{
  "name": "MIG_NAME",
  "instanceTemplate": "INSTANCE_TEMPLATE_URL",
  "targetSize": SIZE,
  "instanceLifecyclePolicy": {
    "forceUpdateOnRepair": YES
  }
}

Haz los cambios siguientes:

  • PROJECT_ID: tu ID de proyecto.
  • ZONE: la zona en la que se encuentra el MIG.
  • MIG_NAME: el nombre del grupo de instancias.
  • INSTANCE_TEMPLATE_URL: la URL de la plantilla de instancia que quieres usar para crear VMs en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancia. Especifica uno de los siguientes valores:
    • En el caso de una plantilla de instancia regional, haz lo siguiente: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • En el caso de una plantilla de instancia global, haz lo siguiente: INSTANCE_TEMPLATE_ID
  • SIZE: tamaño objetivo del grupo de instancias.

Comprobar si la opción de recibir actualizaciones sobre la reparación está habilitada

De forma predeterminada, un MIG no actualiza una VM durante una reparación. Para comprobar si la actualización durante la reparación está habilitada en tu MIG, usa la consola, la CLI de gcloud o REST para ver la configuración de la actualización durante la reparación. Google Cloud

Consola

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

    Ir a Grupos de instancias

  2. Haga clic en el nombre del MIG cuya configuración quiera comprobar.

  3. Haga clic en la pestaña Detalles.

  4. En la sección Ciclo de vida de la instancia de VM, comprueba la opción seleccionada en Actualizaciones durante la reparación de la instancia de VM. Si en el campo se muestra Actualizar la configuración de la instancia, significa que la actualización durante la reparación está habilitada.

gcloud

Usa el comando describe de la siguiente manera:

gcloud compute instance-groups managed describe MIG_NAME \
--format="(instanceLifecyclePolicy)"

En el cuerpo de la respuesta, busca el campo forceUpdateOnRepair, que tiene uno de los siguientes valores:

  • NO: predeterminado. Los MIGs no actualizan las VMs cuando se reparan.
  • YES: el MIG actualiza las VMs durante la reparación.

A continuación, se muestra un ejemplo de resultado:

instanceLifecyclePolicy:
 forceUpdateOnRepair: YES

REST

En el caso de los MIGs zonales, usa el método instanceGroupManagers.get. En el caso de los MIGs regionales, usa el método regionInstanceGroupManagers.get.

Por ejemplo, en un MIG zonal, usa el siguiente comando:

GET https://compute.googleapis.com/compute/v1/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

En el cuerpo de la respuesta, busca el campo instanceLifecyclePolicy.forceUpdateOnRepair, que tiene uno de los siguientes valores:

  • NO: predeterminado. Los MIGs no actualizan las VMs cuando se reparan.
  • YES: el MIG actualiza las VMs durante la reparación.

A continuación se muestra un ejemplo de respuesta:

{
  ...
  "name": "example-mig",
  "targetSize": 12,
  ...
  "instanceLifecyclePolicy": {
    "forceUpdateOnRepair": "YES"
  },
  ...
}

Haz los cambios siguientes:

  • PROJECT_ID: tu ID de proyecto.
  • ZONE: la zona en la que se encuentra el MIG.
  • MIG_NAME: el nombre del grupo de instancias.

Inhabilitar la actualización en la reparación

Cuando tu MIG repare una VM, si quieres que el MIG use la plantilla de instancia original o las configuraciones por instancia que se usaron para crear la VM, debes inhabilitar la actualización durante la reparación. De forma predeterminada, la actualización durante la reparación está inhabilitada en los MIGs.

Usa la Google Cloud consola, la interfaz de línea de comandos de gcloud o REST para inhabilitar la actualización durante la reparación.

Consola

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

    Ir a Grupos de instancias

  2. Haz clic en el nombre del MIG en el que quieras inhabilitar la actualización durante la reparación.

  3. Haz clic en Editar para modificar el MIG.

  4. Haga clic en Ciclo de vida de la instancia y reparación automática para desplegar la sección.

  5. En la sección Updates during VM instance repair (Actualizaciones durante la reparación de instancias de VM), selecciona Keep the same instance configuration (Mantener la misma configuración de instancia).

  6. Haz clic en Guardar.

gcloud

Usa el comando update para definir la marca --no-force-update-on-repair de la siguiente manera:

gcloud compute instance-groups managed update MIG_NAME \
    --no-force-update-on-repair

REST

En el caso de los MIGs zonales, usa el método instanceGroupManagers.patch. En el caso de los MIGs regionales, usa el método regionInstanceGroupManagers.patch.

Por ejemplo, para inhabilitar la actualización en la reparación de un MIG zonal, usa el siguiente comando:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME
{
"instanceLifecyclePolicy":
{ "forceUpdateOnRepair": NO
}
}

Haz los cambios siguientes:

  • PROJECT_ID: tu ID de proyecto.
  • ZONE: la zona en la que se encuentra el MIG.
  • MIG_NAME: el nombre del grupo de instancias.

Siguientes pasos