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

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Console

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

   Vá para grupos de instâncias

2. Selecione o MIG do qual você deseja 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. Após 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 Automatic , a configuração de todas as instâncias definida será aplicada imediatamente a todas as VMs existentes. Se o tipo de atualização for Selective , você deverá aplicar seletivamente a configuração às VMs existentes. Para obter mais informações, consulte Aplicar uma configuração de todas as instâncias às VMs existentes .

gcloud

Adicione ou atualize uma configuração de todas as instâncias usando o 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

Substitua o seguinte:

• INSTANCE_GROUP_NAME : nome do MIG.
• KEYS e VALUES : pares de valores-chave para rótulos ou metadados. Se a chave não existir, o comando update a adiciona. Para chaves existentes, seus valores são atualizados.

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

DESCANSAR

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/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

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

Substitua o seguinte:

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

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

gcloud

Você pode configurar atualizações automáticas (proativas) usando o 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

Substitua o seguinte:

• 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 o sinalizador update-minimal-action para restart , esse sinalizador limitará quantas VMs serão reiniciadas por vez. Pode ser um número fixo (por exemplo, 5 ) ou uma porcentagem do tamanho do grupo gerenciado de instâncias (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 gerenciado de instâncias (por exemplo, 10% ).
• MIN_READY (opcional): tempo mínimo durante o qual uma VM reiniciada ou substituída deve estar pronta para ser considerada disponível. Por exemplo, 10s por 10 segundos. Consulte o tópico gcloud datetimes para obter informações sobre formatos de duração.
• MINIMAL_ACTION (opcional): ação a ser executada em cada instância durante a atualização da configuração:
  • refresh : aplique a nova configuração nas instâncias em execução sem reiniciá-las.
  • restart : reinicia as VMs durante a atualização, o que é útil se seu aplicativo ler 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 : espera que a instância antiga seja excluída e então cria uma nova instância com o mesmo nome da antiga.
  • substitute : cria uma instância com um novo nome enquanto exclui a instância antiga

DESCANSAR

Você pode configurar atualizações automáticas (proativas) fazendo uma solicitação PATCH em um MIG zonal ou 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
  }
}

Substitua o seguinte:

• PROJECT_ID : o projeto no qual o MIG existe.
• REGION : a região onde seu 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 o sinalizador update-minimal-action como RESTART , esse sinalizador limitará quantas VMs serão reiniciadas por vez. Pode ser uma porcentagem (por exemplo, especifique "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 executada em cada instância durante a atualização da configuração:
  • REFRESH : aplique a nova configuração nas instâncias em execução sem reiniciá-las.
  • RESTART : reinicie as VMs durante a atualização, o que é útil se seu aplicativo ler metadados apenas 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 : espera que a instância antiga seja excluída e então cria uma nova instância com o mesmo nome da antiga.
  • SUBSTITUTE : cria uma instância com um novo nome enquanto exclui a instância antiga

gcloud

Você pode configurar atualizações seletivas (oportunistas) usando o comando update :

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

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

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 existentes, 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 o seguinte:

• INSTANCE_GROUP_NAME : nome do MIG.
• INSTANCE_NAMES : uma lista de instâncias às quais aplicar o modelo.
• MINIMAL_ACTION (opcional): ação a ser executada em cada instância durante sua atualização de configuração:
  • refresh (padrão): aplique a nova configuração nas instâncias em execução sem reiniciá-las.
  • restart : reinicia as VMs durante a atualização, o que é útil se seu aplicativo ler 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 esta ação em cada instância. Se a atualização da configuração exigir uma ação mais perturbadora 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 as instâncias, se possível. Por exemplo, use refresh para aplicar alterações que afetem apenas metadados ou discos adicionais.
  • restart : aplique a nova configuração sem substituir instâncias, se possível. Por exemplo, interromper instâncias e iniciá-las novamente é suficiente para aplicar alterações ao tipo de máquina.
  • replace : substitui instâncias antigas de acordo com o sinalizador --replacement-method .

DESCANSAR

Você pode configurar atualizações seletivas (oportunistas) fazendo uma solicitação PATCH em um MIG zonal ou regional .

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

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

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

Aplicar configuração a VMs específicas

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

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 configuração a todas as VMs

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

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
}

Substitua o seguinte:

• PROJECT_ID : o projeto no qual o MIG existe.
• REGION : a região onde seu 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 executada em cada instância durante a atualização da configuração:
  • REFRESH : aplique a nova configuração nas instâncias em execução sem reiniciá-las.
  • RESTART : reinicie as VMs durante a atualização, o que é útil se seu aplicativo ler metadados apenas 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 esta ação em cada instância. Se a atualização da configuração exigir uma ação mais perturbadora 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 parar as instâncias, se possível. Por exemplo, use REFRESH para aplicar alterações que afetem apenas metadados ou discos adicionais.
  • RESTART : aplique a nova configuração sem substituir instâncias, se possível. Por exemplo, interromper instâncias e iniciá-las novamente é suficiente para aplicar alterações ao tipo de máquina.
  • REPLACE : substitui 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 .

   Vá para grupos de instâncias

2. Selecione o MIG do qual deseja visualizar a configuração de todas as instâncias.

3. Vá para 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 , o carimbo de data/hora da última modificação e o campo Status deverão mostrar os valores da seguinte forma:

   • Última modificação : mostra a hora em que você aplicou a configuração de todas as instâncias a todas as VMs.
   • Status : Mostra Aplicado a todas as VMs . Se todas as instâncias não forem aplicadas a todas as VMs, o status será mostrado como Pending VM update .

gcloud

Use o comando describe e inclua o sinalizador --format para procurar o valor status.allInstancesConfig.effective .

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

Exemplo de saída:

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 última alteração na configuração de todas as instâncias do grupo.

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

Para verificar o status de cada VM, você pode listar todas as VMs do MIG ou verificar cada VM individualmente com o comando describe-instance :

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

Exemplo de saída:

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.

DESCANSAR

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

GET https://compute.googleapis.com/compute/v1/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 for definido como true , todas as VMs terão a configuração mais recente aplicada. O campo currentRevision mostra o carimbo de data/hora da última alteração na configuração de todas as instâncias do grupo.

Se o campo effective for definido como false , a configuração mais recente ainda não será 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/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

Exemplo de saída:

{
  "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 .

   Vá para grupos de instâncias

2. Selecione o MIG do qual deseja visualizar a configuração de todas as instâncias.

3. Vá para a guia Detalhes .

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

gcloud

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

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

O comando retorna a configuração de todas as instâncias do grupo, se existir.

DESCANSAR

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

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

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

Console

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

   Vá para grupos de instâncias

2. Selecione o MIG do qual deseja 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 sobre uma configuração para ativar a opção de exclusão e clique em delete Excluir item .
   2. Clique em Salvar .

6. Depois de terminar a exclusão, clique em Atualizar VMs .

   Se o tipo de atualização do MIG estiver definido como Automatic , as alterações na configuração de todas as instâncias serão aplicadas imediatamente a todas as VMs existentes. Se o tipo de atualização for Selective , você deverá aplicar seletivamente a configuração às VMs existentes. Para obter mais informações, consulte Aplicar uma configuração de todas as instâncias às VMs existentes .

gcloud

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

gcloud 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 existentes no MIG.

DESCANSAR

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 você deseja remover.

PATCH https://compute.googleapis.com/compute/v1/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 existentes no MIG.