Anula las propiedades de la plantilla de instancias con una configuración de todas las instancias


En esta página, se explica cómo puedes usar una configuración de todas las instancias a fin de establecer propiedades de etiquetas y metadatos para todas las instancias de máquina virtual (VM) en un grupo de instancias administrado (MIG) sin la necesidad de crear una plantilla de instancias nueva.

Puedes seguir usando plantillas de instancias para establecer propiedades de estas en MIG. Sin embargo, el uso de la configuración de todas las instancias de un MIG es más fácil en algunas situaciones, como las siguientes:

  • Debes actualizar los metadatos o las etiquetas de las instancias con frecuencia y sin la sobrecarga de crear plantillas nuevas cada vez. Recuerda que las plantillas de instancias son inmutables, lo que significa que no se pueden modificar después de la creación.

  • Deseas tener varios MIG basados en una plantilla de instancias, pero debes configurar las etiquetas o los metadatos de cada MIG de manera diferente. Por ejemplo, si tienes una app, pero deseas admitir diferentes entornos para el desarrollo, las pruebas y la producción. Puedes crear una plantilla de instancia única y reutilizarla para todos los entornos si configuras metadatos diferentes con una configuración de instancias diferente para cada entorno.

  • Tienes un equipo que posee infraestructura y imágenes, mientras que otro equipo ejecuta apps que requieren configuración. Puedes tener una infraestructura de aprovisionamiento de equipos con una plantilla de instancias, mientras que el equipo de aplicaciones puede administrar configuraciones de aplicaciones con configuraciones de todas las instancias.

  • Tienes un agente en ejecución en tus VM y deseas configurarlo mediante metadatos. Deseas asegurarte de que la configuración del agente de VM persista incluso después de que cambie la plantilla de instancias del grupo. Usa la plantilla de instancias para controlar la versión de la app y configurar el agente de VM mediante una configuración de todas las instancias.

Si estableces la misma propiedad con la plantilla de instancias de MIG y su configuración de todas las instancias, el MIG prioriza el valor de la configuración de todas las instancias. Por ejemplo, si los metadatos paraenable-guest-attributes se configura comoFALSE en la plantilla de instancias del MIG yTRUE en la configuración de todas las instancias del MIG, luego se aplica Compute EngineTRUE en todas las instancias del grupo. Esto te permite usar una configuración de todas las instancias para anular las propiedades que se definen en la plantilla de instancias.

Antes de comenzar

  • Crea un grupo de instancias administrado.
  • Si aún no lo hiciste, configura la autenticación. 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 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. Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init
    2. Set a default region and zone.
    3. 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.

Limitaciones

  • Solo puedes anular las siguientes propiedades de la plantilla de instancias con una configuración de todas las instancias:

    • Metadatos
    • Etiquetas
  • No puedes actualizar la configuración de todas las instancias con la versión canary. Cuando aplicas la configuración al grupo, Compute Engine aplica las propiedades a todas las instancias nuevas y a las instancias existentes según la política de actualización. Si quieres controlar qué instancias existentes se actualizan, puedes usar actualizaciones selectivas.

  • Si usas la configuración con estado en tu MIG, no puedes establecer la misma propiedad en ninguna configuración por instancia y al mismo tiempo en la configuración de todas las instancias del grupo.

Establece propiedades en una configuración de todas las instancias

Crea y actualiza la configuración de todas las instancias de un MIG con gcloud CLI o REST.

Console

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

    Ir a Grupos de instancias

  2. Selecciona el MIG cuya configuración de todas las instancias deseas establecer.

  3. Haz clic en Actualizar VMs.

  4. En la sección Configuración de todas las instancias, haz lo siguiente:

    • Para agregar o actualizar valores de metadatos, haz clic en Administrar metadatos. Completa la configuración y haz clic en Guardar.
    • Para agregar o actualizar etiquetas, haz clic en Administrar etiquetas. Completa la configuración y haz clic en Guardar.
  5. Una vez que termines de configurar las propiedades en la configuración de todas las instancias, haz clic en Actualizar VMs.

    Si el tipo de actualización del MIG está configurado como Automático, la configuración de todas las instancias que estableciste se aplica de inmediato a todas las VMs existentes. Si el tipo de actualización es Selectivo, debes aplicar la configuración de forma selectiva a las VMs existentes. Para obtener más información, consulta Aplica una configuración de instancias a VMs existentes.

gcloud

Agrega o actualiza una configuración de todas las instancias con el comando all-instances-config update.

gcloud compute instance-groups managed all-instances-config update INSTANCE_GROUP_NAME \
    --metadata=KEY1=VALUE1,KEY2=VALUE2 \
    --labels=KEY3=VALUE3,KEY4=VALUE4

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • KEYS y VALUES: Son los pares clave-valor para etiquetas o metadatos. Si la clave no existe, el comando de actualización la agrega. Para las claves existentes, sus valores se actualizan.

Recuerda aplicar tu configuración actualizada a las VM existentes en el MIG.

REST

Agrega o actualiza una configuración de todas las instancias mediante una solicitud PATCH en un MIG zonal o regional.

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

{
  "allInstancesConfig": {
    "properties": {
      "metadata": {
        "KEY1": "VALUE1",
        ...
      },
      "labels": {
        "KEY2": "VALUE2",
        ...
      },
    }
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el proyecto en el que existe el MIG.
  • REGION: Es la región en la que se encuentra el MIG. Si es un MIG zonal, reemplaza regions/REGION por zones/ZONE.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • KEYS y VALUES: Son los pares clave-valor para etiquetas o metadatos. Si la clave no existe, la solicitud la agrega. Para las claves existentes, su valor se actualiza.

Recuerda aplicar tu configuración actualizada a las VM existentes en el MIG.

Aplica una configuración de todas las instancias a las VM existentes

La configuración de VM que especificas para las VM en un MIG se aplica de forma automática a las VM nuevas que se agregan al grupo.

Para aplicar una configuración de VM actualizada, incluida una configuración de instancias actualizada, a las VM existentes en el grupo, usa uno de los siguientes métodos:

  • Automático (proactivo): Usa este método si deseas que el MIG aplique de forma automática configuraciones nuevas a todas las VM del grupo o a un subconjunto de ellas. El nivel de interrupción en las VMs en ejecución depende de la política de actualización que configures. Puedes usar este método para actualizar versiones canary de plantillas de instancias nuevas. Para usar este método, configura el tipo de actualización del MIG como “proactivo”.
  • Selectivo (oportunista): Usa este método si deseas aplicar la actualización de forma manual o si deseas actualizar todas las VM existentes en el grupo a la vez. Apuntas a cualquiera o todas las VM que se actualizarán a la configuración más reciente. Para usar este método, configura el tipo de actualización del MIG como “oportunista”.
  • Recreación de VM: Cuando vuelves a crear una VM en un MIG, este aplica cualquier configuración actualizada que aún no se aplicó a esa VM. Para obtener más información, consulta Vuelve a crear las VM en un MIG.

Automática (proactiva)

Si deseas aplicar de forma automática una configuración de instancias actualizada a todas las VM existentes cada vez que realizas un cambio en ella, configura el tipo de política de actualización del grupo como “proactivo”. Para obtener más información, consulta Tipo de actualización automática (proactiva).

Puedes controlar la velocidad de un lanzamiento de configuración proactiva mediante el uso de la función opcional.maxUnavailable ,maxSurge , yminReadySec Configuración.

Para usar actualizaciones proactivas, solo necesitas configurarla una vez. Después, el MIG aplica todos los cambios futuros de la configuración de VM (es decir, los cambios en la configuración de todas las instancias del grupo, la plantilla de instancias y las configuraciones por instancia) de forma automática a todas las VM del grupo. en la configuración de la política de actualización del grupo.

Para aplicar actualizaciones de configuración de forma automática, usa gcloud CLI o REST.

gcloud

Puedes configurar las actualizaciones automáticas (proactivas) mediante el comando update.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --update-policy-type=proactive \
    --update-policy-max-unavailable=MAX_UNAVAILABLE \
    --update-policy-max-surge=MAX_SURGE \
    --update-policy-min-ready=MIN_READY \
    --update-policy-minimal-action=MINIMAL_ACTION \
    --update-policy-replacement-method=REPLACEMENT_METHOD

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • MAX_UNAVAILABLE (opcional): Es la cantidad máxima de instancias que pueden no estar disponibles durante la actualización. Por ejemplo, si estableces la marca update-minimal-action en restart, esta marca limita cuántas VM se reinician a la vez. Puede ser un número fijo (por ejemplo, 5) o un porcentaje de tamaño para el grupo de instancias administrado (por ejemplo, 10%).
  • MAX_SURGE (opcional): Es la cantidad máxima adicional de instancias que se pueden crear durante la actualización. Puede ser un número fijo (por ejemplo, 5) o un porcentaje de tamaño para el grupo de instancias administrado (por ejemplo, 10%).
  • MIN_READY (opcional): Es el tiempo mínimo durante el cual una VM reiniciada o reemplazada debe estar lista para que se considere disponible. Por ejemplo, 10s durante 10 segundos. Consulta gcloud topic datetime para obtener más información sobre los formatos de hora válidos.
  • MINIMAL_ACTION (opcional): Es una acción que se debe realizar en cada instancia durante la actualización de la configuración:
    • refresh: Aplica la configuración nueva en instancias en ejecución sin reiniciarlas.
    • restart: Reinicia las VMs durante la actualización, lo que es útil si tu app lee metadatos solo durante el reinicio.
    • replace: borra las VM y crea otras nuevas a las que se aplicará la configuración nueva.
  • REPLACEMENT_METHOD (opcional): Especifica qué acción se usa para reemplazar una instancia:
    • recreate: Espera a que se borre la instancia anterior y, luego, crea una instancia nueva con el mismo nombre que la anterior.
    • substitute: crea una instancia con un nombre nuevo mientras se borra la instancia anterior

REST

Puedes configurar actualizaciones automáticas (proactivas) mediante una solicitud PATCH en un MIG zonal o regional.

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

{
  "updatePolicy": {
    "type": "PROACTIVE",
    "maxUnavailable": {
      "percent": MAX_UNAVAILABLE
    },
    "maxSurge": {
      "percent": MAX_SURGE
    },
    "minimalAction": MINIMAL_ACTION,
    "replacementMethod": REPLACEMENT_METHOD
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el proyecto en el que existe el MIG.
  • REGION: Es la región en la que se encuentra el MIG. Si es un MIG zonal, reemplaza regions/REGION por zones/ZONE.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • MAX_UNAVAILABLE (opcional): Es la cantidad máxima de instancias que pueden no estar disponibles durante la actualización. Por ejemplo, si estableces la marca update-minimal-action en RESTART, esta marca limita cuántas VM se reinician a la vez. Puede ser un porcentaje (por ejemplo, especifica "percent": 80 para el 80%) o un número fijo. Para especificar un número fijo, reemplaza "percent": MAX_UNAVAILABLE por "fixed": MAX_UNAVAILABLE.
  • MAX_SURGE (opcional): Es la cantidad máxima adicional de instancias que se pueden crear durante la actualización. Puede ser un porcentaje o un número fijo.
  • MINIMAL_ACTION (opcional): Es una acción que se debe realizar en cada instancia durante la actualización de la configuración:
    • REFRESH: Aplica la configuración nueva en instancias en ejecución sin reiniciarlas.
    • RESTART: Reinicia las VMs durante la actualización, lo que es útil si tu app lee metadatos solo durante el reinicio.
    • REPLACE: borra las VM y crea otras nuevas a las que se aplicará la configuración nueva.
  • REPLACEMENT_METHOD (opcional): Especifica qué acción se usa para reemplazar una instancia:
    • RECREATE: Espera a que se borre la instancia anterior y, luego, crea una instancia nueva con el mismo nombre que la anterior.
    • SUBSTITUTE: crea una instancia con un nombre nuevo mientras se borra la instancia anterior

Cuando se omiten las marcas opcionales, el grupo usa los valores de la política de actualización del grupo. Puedes verificar la política de actualización mediante gcloud CLI o REST.

Selectivo (oportunista)

Si deseas controlar cuándo y a qué VM aplicar una configuración nueva, establece el tipo de política de actualización del grupo en “oportunista”. Para obtener más información, consulta Tipo de actualización selectiva (oportunista).

Cuando eliges aplicar actualizaciones de configuración de forma selectiva, los cambios en la configuración de todas las instancias del grupo, la plantilla de instancias o la configuración por instancia no se aplican de forma automática a las VM existentes. Debes aplicar de manera explícita una configuración actualizada a las VM existentes para actualizarlas.

Para aplicar de forma selectiva las actualizaciones de configuración de VM a las VM en un MIG, usa gcloud CLI o REST.

gcloud

Puedes configurar actualizaciones selectivas (oportunistas) con el comando update:

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --update-policy-type=opportunistic

Cuando estableces el tipo de actualización del grupo en opportunistic, debes iniciar la actualización cuando quieras aplicar la configuración nueva a las VM existentes.

Aplicar la configuración a VM específicas

Para actualizar las instancias seleccionadas, usa el siguiente comando:

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

Aplicar la configuración a todas las VM

Para actualizar todas las instancias existentes, usa el siguiente comando:

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

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • INSTANCE_NAMES: es una lista de las instancias a las que se les aplicará la plantilla.
  • MINIMAL_ACTION (opcional): Es la acción que se debe realizar en cada instancia durante su actualización de configuración:
    • refresh (predeterminado): Aplica la configuración nueva en las instancias en ejecución sin reiniciarlas.
    • restart: Reinicia las VMs durante la actualización, lo que es útil si tu app lee metadatos solo durante el reinicio.
    • replace: borra las VM y crea otras nuevas a las que se aplicará la configuración nueva.
  • MOST_DISRUPTIVE_ALLOWED_ACTION (opcional): Realiza como máximo esta acción en cada instancia. Si la actualización de la configuración requiere una acción más disruptiva que la especificada aquí, la actualización fallará y no se realizarán cambios.
    • none: No ejecutar ninguna acción
    • refresh: Aplica la configuración nueva sin detener instancias, si es posible. Por ejemplo, usa refresh para aplicar cambios que solo afecten los metadatos o discos adicionales.
    • restart: Aplica la configuración nueva sin reemplazar instancias, si es posible. Por ejemplo, detener las instancias y volver a iniciarlas es suficiente para aplicar los cambios al tipo de máquina.
    • replace: Reemplaza instancias antiguas según la marca --replacement-method.

REST

Puedes configurar actualizaciones selectivas (oportunistas) mediante una solicitud PATCH en un MIG zonal o regional.

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

{
  "updatePolicy": {
    "type": "OPPORTUNISTIC"
  }
}

Cuando estableces el tipo de actualización del grupo en OPPORTUNISTIC, debes iniciar la actualización cuando quieras aplicar la configuración nueva a las VM existentes.

Aplicar la configuración a VM específicas

Para actualizar instancias específicas, usa la siguiente solicitud:

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": MINIMAL_ACTION,
  "mostDisruptiveAllowedAction": MOST_DISRUPTIVE_ALLOWED_ACTION
}

Aplicar la configuración a todas las VM

Para actualizar todas las instancias existentes, usa la siguiente solicitud:

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

{
  "allInstances": true,
  "minimalAction": MINIMAL_ACTION,
  "mostDisruptiveAllowedAction": MOST_DISRUPTIVE_ALLOWED_ACTION
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el proyecto en el que existe el MIG.
  • REGION: Es la región en la que se encuentra el MIG. Si es un MIG zonal, reemplaza regions/REGION por zones/ZONE.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • MINIMAL_ACTION (opcional): Es una acción que se debe realizar en cada instancia durante la actualización de la configuración:
    • REFRESH: Aplica la configuración nueva en instancias en ejecución sin reiniciarlas.
    • RESTART: Reinicia las VMs durante la actualización, lo que es útil si tu app lee metadatos solo durante el reinicio.
    • REPLACE: borra las VM y crea otras nuevas a las que se aplicará la configuración nueva.
  • MOST_DISRUPTIVE_ALLOWED_ACTION (opcional): Realiza como máximo esta acción en cada instancia. Si la actualización de la configuración requiere una acción más disruptiva que la especificada aquí, la actualización fallará y no se realizarán cambios.
    • NONE: No ejecutar ninguna acción
    • REFRESH: Aplica la configuración nueva sin detener instancias, si es posible. Por ejemplo, usa REFRESH para aplicar cambios que solo afecten los metadatos o discos adicionales.
    • RESTART: Aplica la configuración nueva sin reemplazar instancias, si es posible. Por ejemplo, detener las instancias y volver a iniciarlas es suficiente para aplicar los cambios al tipo de máquina.
    • REPLACE: Reemplaza instancias antiguas según el campo updatePolicy.replacementMethod del grupo.

Verifica si se aplicó una configuración actualizada de todas las instancias

Puedes verificar si la configuración más reciente de todas las instancias se aplicó a todas las VMs del grupo mediante una de las siguientes formas.

Console

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

    Ir a Grupos de instancias

  2. Selecciona el MIG cuya configuración de todas las instancias deseas ver.

  3. Ve a la pestaña Detalles.

  4. Si la configuración más reciente de todas las instancias se aplica a todas las VMs, en el Configuración de todas las instancias . Última modificación marca de tiempo y el campo Estado debe mostrar los valores de la siguiente manera:

    • Última modificación: Muestra la hora en que aplicaste la configuración de todas las instancias a todas las VMs.
    • Estado: Muestra Aplicado a todas las VMs. Si las instancias no se aplican a todas las VMs, el estado se muestra como Actualización de VM pendiente.

gcloud

Usa el comando describe y, luego, incluye la marca --format para buscar el valor status.allInstancesConfig.effective.

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --format="(status.allInstancesConfig)"

Resultado de muestra:

status:
  allInstancesConfig:
    currentRevision: 2022-12-02T10:30:15.012345Z
    effective: true

Si el valor effective se establece como true, todas las VM tienen la configuración más reciente aplicada. El valor currentRevision muestra la marca de tiempo del último cambio en la configuración de todas las instancias del grupo.

Si el valor effective se establece como false, la configuración más reciente aún no se aplicó a todas las VM.

Para verificar el estado de cada VM, puedes enumerar todas las VM del MIG o verificar cada VM de forma individual con el comando describe-instance:

gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME

Resultado de muestra:

allInstancesConfig:
  revision: 2022-12-02T10:30:15.012345Z
currentAction: NONE
id: '8393021473297481188'
instance: .../projects/PROJECT/zones/ZONE/instances/INSTANCE_NAME
instanceStatus: RUNNING
name: INSTANCE_NAME
version:
  instanceTemplate: .../projects/PROJECT/global/instanceTemplates/INSTANCE_TEMPLATE

Para ver qué VM tienen la configuración más reciente aplicada, compara la marca de tiempo revision en cada VM con la marca de tiempo currentRevision en el MIG.

REST

Realiza una solicitud GET en un MIG zonal o regional para verificar el valor de la marca status.allInstancesConfig.effective.

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

Respuesta de muestra:

{
  ...
  "status": {
    "isStable": "true",
    "versionTarget": {
      "isReached": "true"
    },
    "allInstancesConfig": {
      "currentRevision": "2022-12-02T10:30:15.012345Z",
      "effective": "true"
    },
  ...
  },
  ...
}

Si el campo effective se establece como true, todas las VM tienen la configuración más reciente aplicada. El campo currentRevision muestra la marca de tiempo del último cambio en la configuración de todas las instancias del grupo.

Si el campo effective está configurado como false, la configuración más reciente aún no se aplicó a todas las VM.

A fin de verificar el estado de cada instancia, enumera las instancias administradas para el MIG zonal o regional:

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

Resultado de muestra:

{
  "managedInstances": [
    ...
    {
      "instance": ".../zones/ZONE/instances/INSTANCE_NAME",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "allInstancesConfig": {
        "revision": "2022-12-02T10:30:15.012345Z"
      },
      "version": {
        "name": "V1",
        "instanceTemplate": ".../projects/.../instanceTemplates/INSTANCE_TEMPLATE"
      }
    },
    {
      ...
    }
  ]
}

Para ver qué VM tienen la configuración más reciente aplicada, compara la marca de tiempo revision en cada VM con la marca de tiempo currentRevision en el MIG.

Enumera las propiedades en una configuración de todas las instancias

Una configuración de todas las instancias es parte de la configuración del MIG. Para revisar la configuración de todas las instancias, usa una de las siguientes maneras.

Console

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

    Ir a Grupos de instancias

  2. Selecciona el MIG cuya configuración de todas las instancias deseas ver.

  3. Ve a la pestaña Detalles.

  4. Consulta la sección Configuración de todas las instancias.

gcloud

Usa el comando describe y, luego, incluye la marca --format para mostrar el valor de configuración de todas las instancias del grupo.

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --format="(allInstancesConfig)"

El comando muestra la configuración de todas las instancias del grupo, si existe.

REST

Realiza una solicitud GET en un MIG zonal o regional y busca el campo allInstancesConfig.

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

Si el campo allInstancesConfig no está configurado, el grupo no tiene ninguna configuración de todas las instancias.

Borrar propiedades de la configuración de todas las instancias

Si borras una propiedad de la configuración de todas las instancias del MIG y existe la misma propiedad en la plantilla de la instancia del MIG, las VM del MIG volverán a heredar esa propiedad de la plantilla de instancias una vez que se complete la última versión se aplica a las VMs en el MIG. Para obtener más información sobre la aplicación de la configuración más reciente a las VMs existentes, consulta Aplica una configuración de instancias a VMs existentes.

Para borrar propiedades de una configuración de todas las instancias, usa una de las siguientes maneras.

Console

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

    Ir a Grupos de instancias

  2. Selecciona el MIG del que deseas borrar la configuración de todas las instancias.

  3. Haz clic en Actualizar VMs.

  4. En la sección Configuración de todas las instancias, haz lo siguiente:

    • Para borrar metadatos, haz clic en Administrar metadatos.
    • Para borrar etiquetas, haz clic en Administrar etiquetas.
  5. En el panel Administrar metadatos o Administrar etiquetas, haz lo siguiente:

    1. Mantén el puntero sobre un parámetro de configuración para activar la opción de borrar y, luego, haz clic en Borrar elemento.
    2. Haz clic en Guardar.
  6. Cuando termines de borrar, haz clic en Actualizar VMs.

    Si el tipo de actualización del MIG está configurado como Automático, los cambios en la configuración de todas las instancias se aplican de inmediato a todas las VMs existentes. Si el tipo de actualización es Selectivo, debes aplicar la configuración de forma selectiva a las VMs existentes. Para obtener más información, consulta Aplica una configuración de instancias a VMs existentes.

gcloud

Para borrar propiedades, usa el comando all-instances-configuration delete y especifica una o más claves para las propiedades que deseas borrar.

gcloud compute instance-groups managed all-instances-config delete INSTANCE_GROUP_NAME \
    --metadata=KEY1[, KEY1]\
    --labels=KEY1[, KEY1]

Recuerda aplicar tu configuración actualizada a las VM existentes en el MIG.

REST

Para borrar propiedades, realiza una solicitud PATCH en un MIG zonal o regional y especifica un valor null como la clave de cada propiedad que desees quitar.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
{
  "allInstancesConfig": {
    "properties": {
      "metadata": {
        "KEY1": null,
        ...
      },
      "labels": {
        "KEY2": null,
        ...
      }
    }
  }
}

Recuerda aplicar tu configuración actualizada a las VM existentes en el MIG.

¿Qué sigue?