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

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.

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.

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.

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.

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.

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 delete 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.