Aplica de forma selectiva las actualizaciones de configuración de VM en un MIG

En este documento, se describe cómo aplicar de forma selectiva las actualizaciones de configuración a las instancias de máquina virtual (VM) en un grupo de instancias administrado (MIG).

Compute Engine mantiene las VM en un MIG en función de los componentes de configuración que usas: plantilla de instancias, configuración opcional de todas las instancias y configuración con estado opcional.

Cada vez que actualices la configuración de VM de un MIG, cambia esos componentes. Compute Engine aplica de forma automática la configuración actualizada a las VM nuevas que se agregan al grupo.

Para aplicar una configuración actualizada a las VM existentes, puedes establecer una actualización selectiva, también conocida como tipo de actualización “oportunista”. Este tipo de actualización ofrece las siguientes ventajas:

• Puedes seleccionar las instancias que deseas actualizar.
• Puedes controlar el momento y la secuencia de las actualizaciones.
• Puedes usar la gcloud CLI o REST para actualizar todas las VMs de inmediato.

Como alternativa, si deseas automatizar el lanzamiento de una configuración nueva a todas o a un subconjunto aleatorio de las VM en un MIG, consulta Aplica de forma automática las actualizaciones de configuración de VM en un MIG. A fin de ayudarte a decidir, consulta Métodos para aplicar una configuración nueva a las VM existentes.

Antes de comenzar

• Configura la autenticación si aún no lo hiciste. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera
  

  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. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

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

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

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

Aplicar la configuración actualizada a las VM seleccionadas

Asegúrate de que el tipo de política de actualización de tu grupo esté configurado como “oportunista” para evitar que el MIG aplique de forma automática una configuración de VM nueva a las VM existentes. Para obtener más información, consulta Verifica el tipo de política de actualización de tu grupo.

Luego, usa la CLI de gcloud o REST para actualizar la configuración del MIG y aplicar la configuración más reciente a las VMs específicas del grupo o a todas las VMs del grupo.

gcloud compute instance-groups managed set-instance-template INSTANCE_GROUP_NAME \
    --template=INSTANCE_TEMPLATE

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAMES \
    --most-disruptive-allowed-action DISRUPTION_LEVEL \
    --minimal-action DISRUPTION_LEVEL

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --all-instances \
    --most-disruptive-allowed-action DISRUPTION_LEVEL \
    --minimal-action DISRUPTION_LEVEL

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "updatePolicy": {
    "type": "OPPORTUNISTIC"
  },
  "versions": [{
    "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE",
  }]
}

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/applyUpdatesToInstances
{
  "instances": [
    "zones/ZONE/instances/INSTANCE_NAME_1",
    "zones/ZONE/instances/INSTANCE_NAME_2"
  ],
  "minimalAction": DISRUPTION_LEVEL,
  "mostDisruptiveAllowedAction": DISRUPTION_LEVEL
}

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/applyUpdatesToInstances
{
  "allInstances": true,
  "minimalAction": DISRUPTION_LEVEL,
  "mostDisruptiveAllowedAction": DISRUPTION_LEVEL
}

Después de realizar una solicitud, puedes verificar el estado para comprobar que se haya completado la actualización.

Controla el nivel de interrupción durante las actualizaciones selectivas

Dependiendo de su naturaleza, una actualización puede interrumpir el estado de una instancia. Por ejemplo, para cambiar el disco de arranque de una instancia, se debe reemplazar la instancia. Puedes controlar el nivel de interrupción que se produce durante una actualización selectiva si configuras las siguientes opciones:

• Acción mínima: Usa esta opción para minimizar la interrupción tanto como sea posible o aplicar una acción más disruptiva que lo necesario.

  • Para limitar las interrupciones tanto como sea posible, establece la acción mínima en NONE. Si tu actualización requiere una acción más disruptiva, Compute Engine realiza la acción necesaria para ejecutar la actualización.
  • Para aplicar una acción más disruptiva que la estrictamente necesaria, configura la acción mínima en RESTART o REPLACE. Por ejemplo, Compute Engine no necesita reiniciar una VM para cambiar sus metadatos. Sin embargo, si tu aplicación lee los metadatos de la instancia solo cuando se reinicia una VM, puedes establecer la acción mínima en RESTART para que se capturen los cambios de metadatos.

• Acción más disruptiva permitida: Usa esta opción para evitar que se realice una actualización si requiere más interrupciones de las que puedes permitirte. Si tu actualización requiere una acción más interruptiva que la acción que configuraste con esta marca, la solicitud de actualización fallará. Por ejemplo, si estableces la acción más interruptiva permitida en RESTART, un intento de actualizar la imagen de disco de arranque falla porque esa actualización requiere que se vuelvan a crear instancias, que es una acción más interruptiva que la de reiniciar.

Al momento de actualizar las VMs seleccionadas, ambas opciones aceptan los siguientes valores:

La acción más perjudicial permitida no puede ser menos perjudicial que la acción mínima.

Cuando actualizas las VMs de forma selectiva, se aplican los siguientes valores predeterminados:

• La acción mínima predeterminada es NONE, que limita la interrupción tanto como sea posible.
• La acción predeterminada más perjudicial permitida es REPLACE. Si no puedes tolerar esta interrupción, establece la acción más interruptiva permitida para que sea menos perjudicial.

¿Qué sigue?

• Consulta Visualiza información sobre los MIG y las VMs administradas.
• Consulta Crea plantillas de instancias.
• Aprende a usar familias de imágenes y un reemplazo progresivo para actualizar la imagen de SO en todas las VM en un MIG.