Substituir propriedades do modelo de instância por uma configuração de todas as instâncias


Nesta página, explicamos como usar uma configuração de todas as instâncias para definir propriedades de rótulos e metadados para todas as instâncias de máquinas virtuais (VM) em um grupo gerenciado de instâncias sem a necessidade de criar um novo modelo.

É possível continuar usando modelos de instância para definir propriedades de instância no MIG. No entanto, usar a configuração de todas as instâncias de um MIG é mais fácil em alguns cenários, como os seguintes:

  • Você precisa atualizar os metadados ou rótulos de instâncias com frequência e sem a sobrecarga de criar novos modelos cada vez. Lembre-se de que os modelos de instância são imutáveis, ou seja, não podem ser modificados depois de criados.

  • Você quer ter vários MIGs com base em um modelo de instância, mas precisa configurar rótulos ou metadados para cada MIG de maneira diferente. Por exemplo, se você tem um app, mas quer oferecer suporte a diferentes ambientes para desenvolvimento, teste e produção. É possível criar um único modelo de instância e reutilizá-lo em todos os ambientes definindo metadados diferentes com outras configurações para todas as instâncias.

  • Você tem uma equipe que é proprietária da infraestrutura e das imagens, enquanto outra equipe executa apps que exigem configuração. É possível ter uma infraestrutura de provisionamento de equipe com um modelo de instância, enquanto a equipe do app pode gerenciar configurações do aplicativo com configurações de todas as instâncias.

  • Você tem um agente em execução nas VMs e quer configurá-lo usando metadados. Você quer garantir que a configuração do agente de VM persista mesmo após a alteração do modelo de instância. Use o modelo de instância para controlar a versão do app e configurar o agente de VM usando uma configuração de todas as instâncias.

Se você definir a mesma propriedade usando o modelo de instância do MIG e a configuração de todas as instâncias dele, o MIG vai priorizar o valor da configuração de todas as instâncias. Por exemplo, se os metadados de enable-guest-attributes estão definidos como FALSE no modelo de instância do MIG e TRUE na configuração de todas as instâncias do MIG, o Compute Engine aplicará TRUE em todas as instâncias do grupo. Isso permite que você use uma configuração de todas as instâncias para substituir as propriedades definidas no modelo de instância.

Antes de começar

  • Crie um grupo de instâncias gerenciadas.
  • Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine da seguinte maneira.

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.

    gcloud

    1. Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:

      gcloud init
    2. Defina uma região e uma zona padrão.

    REST

    Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:

      gcloud init

Limitações

  • Só é possível substituir as seguintes propriedades de modelo de instância por uma configuração de todas as instâncias:

    • Metadados
    • Identificadores
  • Não é possível usar a atualização canário em uma configuração de todas as instâncias. Quando você aplica a configuração ao grupo, o Compute Engine aplica as propriedades a todas as novas instâncias e às instâncias existentes com base na sua política de atualização. Se você quiser controlar quais instâncias existentes são atualizadas, use as atualizações seletivas.

  • Se você usar a configuração com estado no MIG, não será possível definir a mesma propriedade em qualquer configuração por instância e ao mesmo tempo na configuração de todas as instâncias do grupo.

Definir propriedades em uma configuração de todas as instâncias

Criar e atualizar a configuração de todas as instâncias de um MIG usando a CLI gcloud ou a REST.

Console

  1. No Console do Google Cloud, acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Selecione o MIG de que você quer definir a configuração de todas as instâncias.

  3. Clique em Atualizar VMs.

  4. Na seção Configuração de todas as instâncias, faça o seguinte:

    • Para adicionar ou atualizar valores de metadados, clique em Gerenciar metadados. Conclua a configuração e clique em Salvar.
    • Para adicionar ou atualizar rótulos, clique em Gerenciar rótulos. Conclua a configuração e clique em Salvar.
  5. Depois de concluir a configuração das propriedades na configuração de todas as instâncias, clique em Atualizar VMs.

    Se o tipo de atualização do MIG estiver definido como Automático, a configuração de todas as instâncias definida será aplicada imediatamente a todas as VMs. Se o tipo de atualização for Seletivo, será necessário aplicar seletivamente a configuração às VMs. Para mais informações, consulte Aplicar uma configuração de todas as instâncias às VMs.

gcloud

Adicione ou atualize uma configuração com todas as instâncias usando o comando all-instances-config update.

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

Substitua:

  • INSTANCE_GROUP_NAME: nome do MIG.
  • KEYS e VALUES: pares de chave-valor para rótulos ou metadados. Se a chave não existir, o comando de atualização a adicionará. Os valores das chaves atuais são atualizados.

Lembre-se de aplicar sua configuração atualizada às VMs no MIG.

REST

Adicione ou atualize uma configuração de todas as instâncias fazendo uma solicitação PATCH em um MIG zonal ou regional.

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

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

Substitua:

  • PROJECT_ID: o projeto em que o MIG existe.
  • REGION: a região em que o MIG está localizado. Para um MIG zonal, substitua regions/REGION por zones/ZONE.
  • INSTANCE_GROUP_NAME: nome do MIG.
  • KEYS e VALUES: pares de chave-valor para rótulos ou metadados. Se a chave não existir, a solicitação a adicionará. Para chaves atuais, o valor é atualizado.

Lembre-se de aplicar sua configuração atualizada às VMs no MIG.

Aplicar uma configuração de todas as instâncias às VMs

A configuração de VM especificada nas VMs em um MIG é aplicada automaticamente às novas VMs adicionadas ao grupo.

Para aplicar uma configuração de VM atualizada, incluindo uma configuração atualizada de todas as instâncias, às VMs do grupo, use um dos seguintes métodos:

  • Automático (proativo): use esse método se quiser que o MIG aplique automaticamente novas configurações a todas ou a um subconjunto de VMs atuais no grupo. O nível de interrupção na execução de instâncias depende da política de atualização configurada. Use esse método para atualizar canário novos modelos de instância. Para usar esse método, defina o tipo de atualização fo MIG como "proativo".
  • Seletivo (oportunista): use essr método se quiser aplicar a atualização manualmente ou se quiser atualizar todas as VMs do grupo de uma só vez. Você quer segmentar uma ou todas as VMs a serem atualizadas para a configuração mais recente. Para usar esse método, defina o tipo de atualização do MIG como "oportunista".
  • Recriação de VMs: quando você recria uma VM em um MIG, esse aplicativo aplica qualquer configuração atualizada que ainda não tenha sido aplicada a ela. Para mais informações, consulte Recriar VMs em um MIG.

Automático (proativo)

Se você quiser aplicar automaticamente uma configuração atualizada de todas as instâncias a todas as VMs, sempre que fizer uma alteração nela, defina o tipo de política de atualização do grupo como "proativo". Para ver mais informações, consulte Tipo de atualização automática (proativa).

É possível controlar a velocidade de um lançamento proativo da configuração usando as configurações opcionais maxUnavailable, maxSurge e minReadySec.

Para usar atualizações proativas, é preciso configurá-la apenas uma vez. Depois disso, o MIG aplicará todas as futuras alterações de configuração de VM (ou seja, alterações na configuração de todas as instâncias do grupo, modelo de instância e configurações por instância) automaticamente a todas as VMs no grupo nas configurações da política de atualização do grupo.

Para aplicar automaticamente as atualizações de configuração, use a CLI gcloud ou REST.

gcloud

É possível configurar as atualizações automáticas (proativas) usando o comando Beta update.

gcloud beta 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

Substitua:

  • INSTANCE_GROUP_NAME: o nome do MIG;
  • MAX_UNAVAILABLE (opcional): número máximo de instâncias que podem ficar indisponíveis durante a atualização. Por exemplo, se você definir a sinalização update-minimal-action como restart, essa sinalização limitará o número de VMs reiniciadas por vez. Pode ser um número fixo (por exemplo, 5) ou uma porcentagem do tamanho do grupo de instâncias gerenciadas (por exemplo, 10%).
  • MAX_SURGE (opcional): número máximo adicional de instâncias que podem ser criadas durante a atualização. Pode ser um número fixo (por exemplo, 5) ou uma porcentagem do tamanho do grupo de instâncias gerenciadas (por exemplo, 10%).
  • MIN_READY (opcional): tempo mínimo em que uma VM reiniciada ou substituída estará pronta para ser considerada disponível. Por exemplo, 10s por 10 segundos. Consulte gcloud topic datetimes para informações sobre formatos de duração.
  • MINIMAL_ACTION (opcional): ação a ser realizada em cada instância durante a atualização da configuração:
    • refresh: aplica a nova configuração em instâncias em execução sem reiniciá-las.
    • restart: reinicia as VMs durante a atualização. Isso é útil se o app lê metadados somente durante a reinicialização.
    • replace: exclua VMs e crie novas para aplicar a nova configuração.
  • REPLACEMENT_METHOD (opcional): especifica qual ação é usada para substituir uma instância:
    • recreate: aguarda a exclusão da instância antiga e cria uma nova instância com o mesmo nome da anterior.
    • substitute: cria uma instância com um novo nome enquanto exclui a instância antiga.

REST

É possível configurar atualizações automáticas (proativas) fazendo uma solicitação PATCH em um MIG zonal ou regional.

PATCH https://compute.googleapis.com/compute/beta/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
  }
}

Substitua:

  • PROJECT_ID: o projeto em que o MIG existe.
  • REGION: a região em que o MIG está localizado. Para um MIG zonal, substitua regions/REGION por zones/ZONE.
  • INSTANCE_GROUP_NAME: nome do MIG.
  • MAX_UNAVAILABLE (opcional): número máximo de instâncias que podem ficar indisponíveis durante a atualização. Por exemplo, se você definir a sinalização update-minimal-action como RESTART, essa sinalização limitará o número de VMs reiniciadas por vez. Ela pode ser uma porcentagem (por exemplo, especificar "percent": 80 para 80%) ou um número fixo. Para especificar um número fixo, substitua "percent": MAX_UNAVAILABLE por "fixed": MAX_UNAVAILABLE.
  • MAX_SURGE (opcional): número máximo adicional de instâncias que podem ser criadas durante a atualização. Pode ser uma porcentagem ou um número fixo.
  • MINIMAL_ACTION (opcional): ação a ser realizada em cada instância durante a atualização da configuração:
    • REFRESH: aplica a nova configuração em instâncias em execução sem reiniciá-las.
    • RESTART: reinicia as VMs durante a atualização. Isso é útil se o app lê metadados somente durante a reinicialização.
    • REPLACE: exclua VMs e crie novas para aplicar a nova configuração.
  • REPLACEMENT_METHOD (opcional): especifica qual ação é usada para substituir uma instância:
    • RECREATE: aguarda a exclusão da instância antiga e cria uma nova instância com o mesmo nome da anterior.
    • SUBSTITUTE: cria uma instância com um novo nome enquanto exclui a instância antiga.

Quando as sinalizações opcionais são omitidas, o grupo usa os valores na política de atualização do grupo. É possível verificar a política de atualização usando a CLI gcloud ou a REST.

Seletivo (oportunista)

Se você quiser controlar quando e a quais VMs aplicar uma nova configuração, defina o tipo de política de atualização do grupo como "oportunista". Para mais informações, consulte Tipo de atualização seletiva (oportunista).

Quando você escolhe aplicar as atualizações de configuração de maneira seletiva, qualquer alteração na configuração de todas as instâncias do grupo, modelo de instância ou configurações por instância não é aplicada automaticamente às VMs. É preciso aplicar explicitamente uma configuração atualizada às VMs para atualizá-las.

Para aplicar seletivamente as atualizações de configuração da VM às VMs em um MIG, use a CLI gcloud ou a REST.

gcloud

É possível configurar atualizações seletivas (oportunistas) usando o comando Beta update:

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

Ao definir o tipo de atualização do grupo como opportunistic, você precisa iniciar a atualização quando quiser aplicar a nova configuração às VMs.

Aplicar configuração a VMs específicas

Para atualizar as instâncias selecionadas, use o seguinte 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 configuração a todas as VMs

Para atualizar todas as instâncias, use o seguinte 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

Substitua:

  • INSTANCE_GROUP_NAME: nome do MIG.
  • INSTANCE_NAMES: uma lista de instâncias para aplicar o modelo.
  • MINIMAL_ACTION (opcional): ação a ser realizada em cada instância durante a atualização da configuração:
    • refresh (padrão): aplica a nova configuração em instâncias em execução sem reiniciá-las.
    • restart: reinicia as VMs durante a atualização. Isso é útil se o app lê metadados somente durante a reinicialização.
    • replace: exclua VMs e crie novas para aplicar a nova configuração.
  • MOST_DISRUPTIVE_ALLOWED_ACTION (opcional): execute no máximo essa ação em cada instância. Se a atualização da configuração exigir uma ação mais disruptiva do que a especificada aqui, a atualização falhará e nenhuma alteração será feita.
    • none: nenhuma ação
    • refresh: aplique a nova configuração sem interromper instâncias, se possível. Por exemplo, use refresh para aplicar alterações que afetam apenas metadados ou outros discos.
    • restart: aplique a nova configuração sem substituir instâncias, se possível. Por exemplo, parar instâncias e iniciá-las novamente é suficiente para aplicar alterações ao tipo de máquina.
    • replace: substitua instâncias antigas de acordo com a sinalização --replacement-method.

REST

É possível configurar atualizações seletivas (oportunistas) fazendo uma solicitação PATCH em um MIG zonal ou regional.

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

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

Ao definir o tipo de atualização do grupo como OPPORTUNISTIC, você precisa iniciar a atualização quando quiser aplicar a nova configuração às VMs.

Aplicar configuração a VMs específicas

Para atualizar instâncias específicas, use a seguinte solicitação:

POST https://compute.googleapis.com/compute/beta/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 configuração a todas as VMs

Para atualizar todas as instâncias, use a seguinte solicitação:

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

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

Substitua:

  • PROJECT_ID: o projeto em que o MIG existe.
  • REGION: a região em que o MIG está localizado. Para um MIG zonal, substitua regions/REGION por zones/ZONE.
  • INSTANCE_GROUP_NAME: nome do MIG.
  • MINIMAL_ACTION (opcional): ação a ser realizada em cada instância durante a atualização da configuração:
    • REFRESH: aplica a nova configuração em instâncias em execução sem reiniciá-las.
    • RESTART: reinicia as VMs durante a atualização. Isso é útil se o app lê metadados somente durante a reinicialização.
    • REPLACE: exclua VMs e crie novas para aplicar a nova configuração.
  • MOST_DISRUPTIVE_ALLOWED_ACTION (opcional): execute no máximo essa ação em cada instância. Se a atualização da configuração exigir uma ação mais disruptiva do que a especificada aqui, a atualização falhará e nenhuma alteração será feita.
    • NONE: nenhuma ação
    • REFRESH: aplique a nova configuração sem interromper instâncias, se possível. Por exemplo, use REFRESH para aplicar alterações que afetam apenas metadados ou outros discos.
    • RESTART: aplique a nova configuração sem substituir instâncias, se possível. Por exemplo, parar instâncias e iniciá-las novamente é suficiente para aplicar alterações ao tipo de máquina.
    • REPLACE: substitua instâncias antigas de acordo com o campo updatePolicy.replacementMethod do grupo.

Verificar se uma configuração de todas as instâncias atualizada foi aplicada

É possível verificar se a configuração mais recente de todas as instâncias foi aplicada a todas as VMs no grupo usando uma das maneiras a seguir.

Console

  1. No Console do Google Cloud, acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Selecione o MIG de que você quer visualizar a configuração de todas as instâncias.

  3. Acesse a guia Detalhes.

  4. Se a configuração mais recente de todas as instâncias for aplicada a todas as VMs, na seção Configuração de todas as instâncias, os carimbos de data/hora da última modificação e do Status precisa mostrar os valores da seguinte forma:

    • Última modificação: mostra o horário em que você aplicou a configuração de todas as instâncias a todas as VMs.
    • Status: mostra Aplicado a todas as VMs. Se a opção "todas as instâncias" não for aplicada a todas as VMs, o status será mostrado como Atualização de VM pendente.

gcloud

Use o comando describe Beta e inclua a sinalização --format para procurar o valor status.allInstancesConfig.effective.

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

Exemplo de resposta:

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

Se o valor effective for definido como true, todas as VMs terão a configuração mais recente aplicada. O valor currentRevision mostra o carimbo de data/hora da alteração mais recente na configuração de todas as instâncias do grupo.

Se o valor effective estiver definido como false, a configuração mais recente ainda não foi aplicada a todas as VMs.

Para verificar o status de cada VM, liste todas as VMs do MIG ou verifique cada VM individualmente com o comando describe-instance Beta:

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

Exemplo de resposta:

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 quais VMs têm a configuração mais recente aplicada, compare o carimbo de data/hora revision em cada VM com o carimbo de data/hora currentRevision no MIG.

REST

Faça uma solicitação GET no MIG zonal ou regional para verificar o valor da sinalização status.allInstancesConfig.effective.

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

Exemplo de resposta:

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

Se o campo effective estiver definido como true, todas as VMs terão a configuração mais recente aplicada. O campo currentRevision mostra o carimbo de data/hora da alteração mais recente na configuração de todas as instâncias do grupo.

Se o campo effective estiver definido como false, a configuração mais recente ainda não foi aplicada a todas as VMs.

Para verificar o status de cada instância, liste as instâncias gerenciadas para o MIG zonal ou regional:

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

Exemplo de resposta:

{
  "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 quais VMs têm a configuração mais recente aplicada, compare o carimbo de data/hora revision em cada VM com o carimbo de data/hora currentRevision no MIG.

Listar propriedades em uma configuração de todas as instâncias

Uma configuração de todas as instâncias faz parte da configuração do MIG. Para revisar a configuração de todas as instâncias, use uma das opções a seguir.

Console

  1. No Console do Google Cloud, acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Selecione o MIG de que você quer visualizar a configuração de todas as instâncias.

  3. Acesse a guia Detalhes.

  4. Consulte a seção Configuração de todas as instâncias.

gcloud

Use o comando describe e inclua a sinalização --format para mostrar o valor de configuração de todas as instâncias do grupo.

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

O comando retornará a configuração de todas as instâncias do grupo, se houver.

REST

Faça uma solicitação GET em um MIG zonal ou regional e procure o campo allInstancesConfig.

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

Se o campo allInstancesConfig não estiver definido, o grupo não terá configuração de todas as instâncias.

Excluir propriedades da configuração de todas as instâncias

Se você excluir uma propriedade da configuração de todas as instâncias do MIG e a mesma propriedade existir no modelo de instância do MIG, as VMs no MIG vão herdar novamente essa propriedade do modelo de instância quando a versão mais recente da configuração for aplicada às VMs no MIG. Para mais informações sobre como aplicar a configuração mais recente a VMs atuais, consulte Aplicar uma configuração de todas as instâncias a VMs atuais.

Para excluir propriedades de uma configuração de todas as instâncias, use uma das seguintes maneiras.

Console

  1. No Console do Google Cloud, acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Selecione o MIG de que você quer excluir a configuração de todas as instâncias.

  3. Clique em Atualizar VMs.

  4. Na seção Configuração de todas as instâncias, faça o seguinte:

    • Para excluir metadados, clique em Gerenciar metadados
    • Para excluir rótulos, clique em Gerenciar rótulos.
  5. No painel Gerenciar metadados ou Gerenciar rótulos, faça o seguinte:

    1. Mantenha o ponteiro do mouse sobre uma configuração para ativar a opção de exclusão e clique em Excluir item.
    2. Clique em Save.
  6. Depois de concluir a exclusão, clique em Atualizar VMs.

    Se o tipo de atualização do MIG estiver definido como Automático, as alterações na configuração de todas as instâncias serão aplicadas imediatamente a todas as VMs. Se o tipo de atualização for Seletivo, será necessário aplicar seletivamente a configuração às VMs. Para mais informações, consulte Aplicar uma configuração de todas as instâncias às VMs.

gcloud

Para excluir propriedades, use o comando Beta all-instances-configuration delete e especifique uma ou mais chaves para as propriedades que você quer excluir.

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

Lembre-se de aplicar sua configuração atualizada às VMs no MIG.

REST

Para excluir propriedades, faça uma solicitação PATCH em um MIG zonal ou regional e especifique um valor null como a chave para cada propriedade que quiser remover.

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

Lembre-se de aplicar sua configuração atualizada às VMs no MIG.

A seguir