Como aplicar, visualizar e remover configurações com estado em MIGs

Depois de criar ou atualizar uma configuração com estado para um grupo de instâncias gerenciadas com estado (MIG), é possível:

  • Aplique a configuração com estado para que ela entre em vigor.
  • Visualize a configuração com estado e o estado preservado efetivo das instâncias gerenciadas.
  • Remova a configuração com estado.

Antes de começar

  • Veja quando usar MIGs com estado e como funcionam os MIGs com estado.
  • 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.

    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 as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

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

        gcloud init

      Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Como aplicar a configuração com estado a instâncias gerenciadas

Sua configuração com estado entra em vigor depois que você ou o MIG a aplica.

  • As alterações de configuração em uma política com estado são aplicadas automaticamente a todas as instâncias gerenciadas.
  • As alterações de configuração em uma instância por instância podem ser aplicadas manual ou automaticamente.

Para mais informações conceituais, leia Como a configuração com estado é aplicada às instâncias gerenciadas.

Como aplicar a configuração de uma política com estado

Todas as alterações de configuração em uma política com estado são aplicadas automaticamente a todas as instâncias gerenciadas. As atualizações de uma política com estado não interrompem a execução de instâncias de máquina virtual (VM).

Como verificar se uma política com estado foi aplicada

Como verificar todas as VMs

Verifique se as alterações em uma política com estado foram aplicadas a todas as VMs conferindo se o MIG se tornou estável após as alterações.

Como verificar VMs específicas

Verifique se as alterações em uma política com estado foram aplicadas a uma VM específica em um MIG, visualizando o estado preservado da instância gerenciada e conferindo se todos os discos da política de estado estão presentes em preservedStateFromPolicy ou preservedStateFromConfig para a instância gerenciada.

Como aplicar a configuração com estado de configurações por instância

É possível aplicar configurações novas ou atualizadas por instância de forma manual ou automática. Use uma das seguintes abordagens:

  • Aplicar seletivamente configurações atualizadas a instâncias específicas: use esta abordagem para controlar a interrupção, o tempo e a sequência das atualizações.
  • Aplicar automaticamente configurações atualizadas com atualizações graduais: use esta abordagem para aplicar alterações de configuração em instâncias gerenciadas de maneira automatizada e contínua.

Esses dois métodos aplicam atualizações pendentes de configurações por instância e versões ou modelo de instância não aplicados, se relevantes.

Aplicar seletivamente configurações atualizadas a instâncias específicas

Para aplicar configurações por instância manualmente em instâncias específicas, siga estas etapas:

  1. Configure uma política de atualização oportunista para evitar uma disputa com atualizações proativas automáticas.
  2. Crie ou atualize configurações por instância.
  3. Aplique configurações atualizadas a VMs específicas atualizando seletivamente as VMs.

Como alternativa, é possível usar as abordagens a seguir:

  • Ao criar ou atualizar uma configuração por instância com a CLI gcloud, use a sinalização --update-instance para aplicar imediatamente a configuração à instância gerenciada associada.
  • Ao criar instâncias manualmente, especifique os nomes e configurações por instância delas no momento da criação. O MIG aplica configurações imediatamente na criação da VM.

Aplicar automaticamente configurações atualizadas com atualizações graduais

Configure atualizações graduais proativas para que o MIG aplique automaticamente atualizações de configuração às instâncias gerenciadas correspondentes de maneira contínua.

MIGs com estado exigem a seguinte configuração para uma política de atualização proativa:

Essa configuração garante que o MIG recrie instâncias com estado existentes e não as substitua por instâncias diferentes.

Para garantir que as alterações nas configurações por instância sejam aplicadas sem interromper as instâncias, defina a ação mínima como REFRESH na atualização do grupo, se possível.

Como verificar se as configurações por instância foram aplicadas

Como verificar todas as configurações por instância

Para verificar se todas as configurações por instância em um MIG foram aplicadas, veja o status com estado do MIG e verifique status.stateful.perInstanceConfigs.allEffective:

  • true: todas as configurações por instância no grupo foram aplicadas e estão em vigor ou o grupo não tem configurações por instância.
  • false: o grupo tem pelo menos uma configuração por instância que ainda não é efetiva: ela ainda não foi aplicada ou está em processo de aplicação.

Como verificar uma configuração específica por instância

Para verificar se as alterações em uma configuração específica por instância foram aplicadas à VM correspondente, veja todas as configurações por instância e verifique o campo status dessa configuração específica:

  • UNAPPLIED: a configuração por instância foi criada ou atualizada e você precisa aplicá-la à VM com uma atualização manual de instância.
  • APPLYING: o MIG está aplicando à VM a configuração nova (ou a atualizada) por instância.
  • EFFECTIVE: a configuração por instância foi aplicada à VM e é eficaz.
  • UNAPPLIED_DELETION: a configuração por instância está definida para ser excluída. Aplique essa atualização à VM com uma atualização de instância manual para que ela entre em vigor.
  • DELETING: a configuração por instância está sendo excluída e a alteração está sendo aplicada à VM.

Como visualizar a configuração com estado e o estado preservado

Receba informações sobre seus MIGs com estado para as seguintes tarefas:

  • Verificar se um MIG tem configuração com estado e se essa configuração é aplicada e eficaz.
  • Visualizar a configuração com estado comum a todas as instâncias no MIG, armazenada na política com estado.
  • Visualizar a configuração com estado específica para instâncias individuais, armazenada em configurações por instância e verificar se essa configuração é aplicada e eficaz.
  • Visualizar o estado preservado efetivo de cada instância em um MIG com base na política com estado que ele possui e nas configurações por instância aplicadas.

Como visualizar o status de uma configuração com estado do MIG

Um MIG é considerado com estado se tiver alguma configuração com estado, ou seja, uma política com estado ou pelo menos uma configuração não vazia por instância.

Se você criar uma política com estado, o MIG a aplicará automaticamente para torná-la efetiva. Se você criar configurações por instância, poderá decidir aplicá-las posteriormente.

Para verificar se um MIG tem configuração com estado e se todas as configurações por instância foram aplicadas, veja o status com estado do MIG usando a CLI gcloud ou a REST.

gcloud

Para verificar se um MIG tem configuração com estado, veja o status com estado executando o comando gcloud compute instance-groups managed describe. Por exemplo:

gcloud compute instance-groups managed describe NAME

baseInstanceName node
...
name example-group
...
status:
  isStable: true
  stateful:
    hasStatefulConfig: true
    perInstanceConfigs:
      allEffective: true
  versionTarget:
    isReached: true
targetSize: 3
...

Nesta saída:

  • hasStatefulConfig:
    • true: o grupo tem configuração com estado, ou seja, tem uma política com estado não vazia ou pelo menos uma configuração não vazia por instância.
    • false: não há configuração com estado.
  • perInstanceConfigs.allEffective:
    • true: todas as configurações por instância no grupo foram aplicadas e estão em vigor ou o grupo não tem configurações por instância.
    • false: o grupo tem pelo menos uma configuração por instância que ainda não é efetiva: você ainda não a aplicou ou está em processo de aplicação.

REST

Para verificar se um MIG tem configuração com estado, use o método instanceGroupManagers.get ou regionInstanceGroupManagers.get e verifique o campo status.stateful. Por exemplo:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME

O método retorna o objeto instanceGroupManagers:

{
  "name": "example-group",
  "baseInstanceName": "node",
  ...
  "status": {
    "isStable": true,
    "stateful": {
      "hasStatefulConfig": true,
      "perInstanceConfigs": {
        "allEffective": true
      }
    },
    "versionTarget": {
      "isReached": true
    }
  },
  "targetSize": 3,
  ...
}

Nesta saída:

  • hasStatefulConfig:
    • true: o grupo tem configuração com estado, ou seja, tem uma política com estado não vazia ou pelo menos uma configuração não vazia por instância.
    • false: não há configuração com estado.
  • perInstanceConfigs.allEffective:
    • true: todas as configurações por instância no grupo foram aplicadas e estão em vigor ou o grupo não tem configurações por instância.
    • false: o grupo tem pelo menos uma configuração por instância que ainda não é efetiva: você ainda não a aplicou ou está em processo de aplicação.

Como visualizar a política com estado de um MIG

Veja a política com estado de um MIG verificando os detalhes do grupo com o console do Google Cloud, a gcloud CLI ou a REST.

Console

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

    Acesse grupo de instâncias

  2. Clique no nome do grupo de instâncias do qual você quer ver a política com estado.

  3. Acesse a guia Detalhes.

  4. Em Recursos com estado, todos os recursos na política com estado são listados.

gcloud

Para ver a política com estado de um MIG, execute o comando gcloud compute instance-groups managed describe. Por exemplo:

gcloud compute instance-groups managed describe NAME

baseInstanceName node
...
name example-group
...
statefulPolicy:
  preservedState:
    disks:
      data-disk:
        autoDelete: NEVER
      logs-disk:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
    internalIPs:
      nic0:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
    externalIPs:
      nic0:
        autoDelete: NEVER
status:
  isStable: true
  stateful:
    hasStatefulConfig: true
    perInstanceConfigs:
      allEffective: true
  versionTarget:
    isReached: true
targetSize: 3
...

REST

Para ver a política com estado de uma MIG, use o método instanceGroupManagers.get ou regionInstanceGroupManagers.get e verifique o campo statefulPolicy. Por exemplo:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME

O método retorna o objeto instanceGroupManagers:

{
  "name": "example-group",
  "baseInstanceName": "node",
  ...
  "status": {
      "isStable": true,
      "versionTarget": {
        "isReached": true
      },
      "stateful": {
        "hasStatefulConfig": true,
        "perInstanceConfigs": {
          "allEffective": true
        }
      }
  ...
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "data-disk": { "autoDelete": "NEVER" },
        "logs-disk": { "autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
      },
      "internalIPs": {
         "nic0" : { "autoDelete": "ON_PERMANENT_INSTANCE_DELETION"}
      },
      "externalIPs": {
         "nic0" : { "autoDelete": "NEVER"}
      },
    }
  },
  "targetSize": 3,
  ...
}

Como visualizar as configurações por instância de um MIG

Veja as configurações por instância listando todas as configurações por instância em um MIG. Use a CLI gcloud ou a REST.

Se você decidir aplicar configurações por instância manualmente, algumas configurações por instância ainda não serão aplicadas às instâncias associadas. Portanto, os estados preservados das instâncias talvez ainda não reflitam suas configurações por instância. Para mais informações, consulte Como aplicar configurações por instância e Como verificar se as configurações por instância foram aplicadas.

gcloud

Liste todas as configurações por instância em um MIG executando o comando gcloud compute instance-groups managed instance-configs list:

gcloud compute instance-groups managed instance-configs list NAME

Substitua:

  • NAME: o nome de um MIG para listar as configurações por instância

Filtre a lista usando a sinalização --filter padrão.

Por exemplo, para listar todas as configurações por instância em example-group:

gcloud compute instance-groups managed instance-configs list example-group
---
fingerprint: JxPvsKOywuY=
name: node-1
preservedState:
  disks:
    data-disk:
      autoDelete: NEVER
      mode: rw
      source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1
  metadata:
    role: primary
  internalIPs:
    nic0:
      ipAddress:
        address: /projects/example-project/regions/us-east1/addresses/node-1-int-ip
      autoDelete: ON_PERMANENT_INSTANCE_DELETION
  externalIPs:
    nic0:
      ipAddress:
        literal: 130.211.181.55
      autoDelete: NEVER
status: EFFECTIVE
---
fingerprint: IbGmJBqqEkk=
name: node-2
preservedState:
...

REST

Liste todas as configurações por instância em um MIG chamando o método instanceGroupManagers.listPerInstanceConfigs ou regionInstanceGroupManagers.listPerInstanceConfigs:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/listPerInstanceConfigs

Substitua:

  • PROJECT_ID: o ID do projeto para a solicitação.
  • ZONE: a zona onde o MIG está localizado, aplicável a um MIG zonal.
    • Substitua zones/ZONE por regions/REGION e especifique a região do MIG se ele for regional.
  • NAME: o nome de um MIG para listar as configurações por instância

Por exemplo, para listar todas as configurações por instância em example-group:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-group/listPerInstanceConfigs

O método retorna a lista de configurações por instância no grupo: 

{
  "items": [
    {
      "fingerprint": "JxPvsKOywuY=",
      "name": "node-1",
      "preservedState" : {
        "disks": {
          "data-disk" : {
            "source": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1",
            "mode": "READ_WRITE",
            "autoDelete": "NEVER"
          }
        },
        "metadata": {
          "role": "primary"
        },
        "internalIPs": {
         "nic0" : {
           "ipAddress" : {
             "address":  "/projects/example-project/regions/us-east1/addresses/node-1-int-ip"
           },
           "autoDelete": "ON_PERMANENT_INSTANCE_DELETION"
         }
        },
        "externalIPs": {
         "nic0": {
           "ipAddress" : {
             "literal": "54.2.3.4"
           },
           "autoDelete": "NEVER"
         }
        }
      },
      "status": "EFFECTIVE"
    },
    {
      "fingerprint": "IbGmJBqqEkk=",
      "name": "node-2",
      "preservedState" : {
        ...
      }
      ...
    },
    ...
  ]
}

Como visualizar os estados preservados de instâncias gerenciadas

Quando a configuração com estado for aplicada, o MIG gerará e definirá o estado preservado efetivo de cada instância gerenciada em dois campos:

  • preservedStateFromPolicy: contém o estado preservado que é gerado com base em uma política com estado, excluindo qualquer configuração com estado que seja substituída por configurações por instância.
  • preservedStateFromConfig: contém o estado preservado que é gerado com base em uma configuração por instância que já foi aplicada à instância gerenciada.

Para ver o estado preservado efetivo de cada instância gerenciada em um MIG, liste as instâncias gerenciadas usando a gcloud CLI ou a REST.

gcloud

Verifique quais instâncias gerenciadas preservaram o estado usando o comando gcloud compute instance-groups managed list-instances e visualizando valores na coluna PRESERVED_STATE. Por exemplo:

gcloud compute instance-groups managed list-instances NAME

NAME    ZONE        STATUS   HEALTH_STATE  ACTION  PRESERVED_STATE  INSTANCE_TEMPLATE  ...
node-1  us-east1-c  RUNNING                NONE    POLICY,CONFIG    example-template
node-2  us-east1-c  RUNNING                NONE    POLICY,CONFIG    example-template

A coluna PRESERVED_STATE pode conter os seguintes valores:

  • POLICY: a instância gerenciada preservou o estado com base em uma política com estado.
  • CONFIG: a instância gerenciada tem estado preservado com base em uma configuração por instância.
  • Sem valor: a instância de gerenciamento não tem estado preservado e não tem estado.

Visualize o estado preservado de uma instância gerenciada específica executando o comando gcloud compute instance-groups managed describe-instance:

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

Substitua:

  • INSTANCE_GROUP_NAME: o nome de um MIG
  • INSTANCE_NAME: o nome de uma instância gerenciada no grupo

Por exemplo, para ver o estado preservado da instância gerenciada node-1 em example-group, execute:

gcloud compute instance-groups managed describe-instance example-group \
  --instance node-1
instance: .../example-project/zones/us-east1-c/instances/node-1
instanceStatus: RUNNING
currentAction: NONE
id: 123456789012345678
version:
  instanceTemplate: .../example-project/global/instanceTemplates/example-template
preservedStateFromPolicy:
  disks:
    data-disk:
      autoDelete: NEVER
      mode: rw
      source: .../example-project/zones/us-east1-c/disks/data-disk-1
    internalIPs:
      nic0:
        ipAddress:
          literal: 10.0.0.1
          address: .../example-project/regions/us-east1/addresses/node-1-int-ip
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
preservedStateFromConfig:
  metadata:
    role: primary
    my-key: my-value
  externalIPs:
    nic0:
      ipAddress:
        literal: 130.211.181.55
        address: .../example-project/regions/us-east1/addresses/node-1-nat-ip
      autoDelete: NEVER

REST

Liste instâncias gerenciadas para visualizar o estado preservado de cada instância chamando o método instanceGroupManagers.listManagedInstances ou regionInstanceGroupManagers.listManagedInstances.

Por exemplo, para listar todas as instâncias gerenciadas:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/listManagedInstances

O método retorna a lista de instâncias gerenciadas no grupo, que contém informações sobre os estados preservados:

{
  "managedInstances": [
    {
      "instance": ".../example-project/zones/us-east1-c/instances/node-1",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "id": "123456789012345678",
      "version": {
         "instanceTemplate":".../example-project/global/instanceTemplates/example-template"
      },
      "preservedStateFromPolicy": {
        "disks": {
          "data-disk" : {
            "source": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1",
            "mode": "rw",
            "autoDelete": "NEVER"
          },
        },
        "internalIPs": {
          "nic0" : {
            "ipAddress": {
              "literal": "10.0.0.1",
              "address":  "/projects/example-project/regions/us-east1/addresses/node-1-int-ip"
            },
            "autoDelete": "ON_PERMANENT_INSTANCE_DELETION"
          }
        },
      },
      "preservedStateFromConfig": {
        "metadata": {
          "role": "primary",
          "my-key": "my-value"
        },
        "externalIPs": {
          "nic0": {
            "ipAddress": {
              "literal": "130.211.181.55",
              "address":  "/projects/example-project/regions/us-east1/addresses/node-1-nat-ip"
            },
            "autoDelete": "NEVER"
          }
        },
      }
    },
    {
      "instance": ".../example-project/zones/us-east1-c/instances/node-2",
      "instanceStatus": "RUNNING",
      ...
      "preservedStateFromPolicy": {
        ...
      },
      "preservedStateFromConfig": {
        ...
      }
    },
    ...
  ]
}

Como ver os recursos de endereços IP estáticos associados

Para recuperar endereços IP estáticos (recursos Address) atribuídos a instâncias gerenciadas em um MIG, visualize os estados preservados dessas instâncias. É possível ver endereços estáticos nos campos ipAddress.address.

Se um MIG ou as instâncias não existirem mais, mas as reservas de endereço IP ainda existirem, será possível listar as reservas de endereço estáticos interno ou externo.

Como remover a configuração com estado

A remoção da configuração com estado é útil nos seguintes cenários:

  • Você migrou VMs independentes para um MIG com estado e agora quer mover a configuração com estado de configurações por instância para uma política com estado comum.
  • Você pesquisou novamente sua carga de trabalho e não precisa mais manter nenhum estado nas instâncias de VM.
  • Você criou uma configuração com estado para fins de teste e agora quer limpá-la.

Nesta seção, descrevemos como remover completamente uma política com estado em uma configuração por instância. Se você só precisar remover um subconjunto de uma política com estado ou por instância, consulte as seguintes seções:

Como remover uma política com estado

Ao remover uma política com estado, você afeta todas as VMs em um MIG. O MIG trata todos os recursos com estado configurados na política com estado como sem estado, a menos que esses recursos também estejam configurados em configurações por instância para instâncias individuais. Em operações de recriação, recuperação automática ou atualização de instâncias posteriores, os recursos sem estado agora podem perder o estado:

  • Os discos podem ser excluídos e recriados da origem, que é definida no modelo de instância.
  • Os endereços IP podem mudar.

Para informações conceituais, consulte como a remoção de um recurso de política com estado afeta um estado preservado.

gcloud

Para excluir toda a configuração de uma política com estado, execute o comando gcloud compute instance-groups managed update com as flags aplicáveis. As sinalizações aplicáveis são as seguintes:

  • --remove-stateful-disks e liste os nomes dos dispositivos de todos os discos com estado configurados.
  • --remove-stateful-internal-ips e liste os nomes das interfaces de rede de todos os endereços IP internos com estado configurados.
  • --remove-stateful-external-ips e liste os nomes das interfaces de rede de todos os endereços IP externos com estado configurados.

Por exemplo, se a política com estado tiver configuração para dois discos com estado com nomes de dispositivo data-disk e logs-disk e incluir configuração de endereços IP internos e externos com estado em nic0 }, execute o seguinte comando para limpar a política:

gcloud compute instance-groups managed update example-group \
    --zone us-east1-c \
    --remove-stateful-disks data-disk,logs-disk \
    --remove-stateful-internal-ips nic0 \
    --remove-stateful-external-ips nic0

O MIG remove da política com estado a configuração com estado data-disk e logs-disk, bem como a configuração de IP interno e externo com estado para a interface de rede nic0. Como resultado, o MIG remove esses discos e endereços IP estáticos dos estados preservados de todas as instâncias gerenciadas no grupo de forma automática e assíncrona, a menos que os discos ou endereços IP também estejam configurados por instância. .

REST

Para excluir todas as configurações na política com estado, defina o campo statefulPolicy como null usando o método instanceGroupManagers.patch ou regionInstanceGroupManagers.patch. .

Por exemplo, a seguinte chamada remove a configuração de política com estado:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME

{
  "statefulPolicy": null
}

O MIG limpa a configuração de política com estado e remove os recursos dos estados preservados de todas as instâncias gerenciadas no grupo de forma automática e assíncrona, a menos que os recursos também sejam configurados em configurações por instância.

Como remover a configuração com estado de uma VM específica

A remoção da configuração com estado de uma VM específica é feita em duas etapas:

  1. Exclua a configuração por instância associada.
  2. Aplique a alteração à instância gerenciada. É possível escolher se a alteração precisa ser aplicada de forma manual ou automática.

Depois que a alteração é aplicada, todos os itens com estado que foram configurados anteriormente na configuração por instância agora são tratados como sem estado, a menos que também estejam configurados na política com estado do grupo. Quando a VM é recriada ou atualizada posteriormente, o estado dos itens é perdido:

  • Os discos podem ser desanexados ou recriados da origem no modelo de instância.
  • Os metadados são removidos ou redefinidos para os valores definidos no modelo de instância.
  • Os endereços IP podem mudar.

Para mais informações, consulte Como a remoção de itens das configurações por instância afeta o estado preservado.

gcloud

Para excluir completamente a configuração por instância, execute o comando gcloud compute instance-groups managed instance-configs delete.

Use a sinalização --update-instance opcional para aplicar as alterações imediatamente à instância (a padrão). Se você definir a flag --no-update-instance, as alterações serão aplicadas na próxima vez em que você recriar ou atualizar a instância.

A sinalização --instance-update-minimal-action só pode ser usado com a sinalização --update-instance.

gcloud compute instance-groups managed instance-configs delete INSTANCE_GROUP_NAME \
  --instances INSTANCE_NAME[,INSTANCE_NAME,...] \
  [--no-update-instance | --update-instance] \
  [--instance-update-minimal-action MINIMAL_ACTION]

Substitua:

  • INSTANCE_GROUP_NAME: o nome do MIG.
  • INSTANCE_NAME: nomes das instâncias para as quais você quer excluir configurações por instância
  • MINIMAL_ACTION: a ação mínima a ser executada ao aplicar a atualização da configuração por instância à VM. O valor precisa ser um destes:
    • none: nenhuma ação.
    • refresh: aplicar as atualizações possíveis sem parar a VM.
    • restart: interromper a VM e iniciá-la novamente.
    • replace: recrie a VM.

Por exemplo, para excluir a configuração por instância para node-1 em example-group, execute o seguinte comando:

gcloud compute instance-groups managed instance-configs delete example-group \
  --instances node-1 \
  --update-instance

O MIG exclui a configuração por instância para node-1 e, como a VM foi atualizada e as alterações de configuração foram aplicadas, o MIG não trata mais os itens com estado como "com estado".

REST

Para excluir completamente a configuração por instância de uma ou várias instâncias, use o método instanceGroupManagers.deletePerInstanceConfigs ou regionInstanceGroupManagers.deletePerInstanceConfigs.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/deletePerInstanceConfigs

{
  "names": ["INSTANCE_NAME",...]
}

Substitua:

  • PROJECT_ID: o ID do projeto para a solicitação.
  • ZONE: a zona onde o MIG está localizado, aplicável a um MIG zonal.
    • Substitua zones/ZONE por regions/REGION e especifique a região do MIG, se ele for regional.
  • INSTANCE_GROUP_NAME: o nome do MIG.
  • INSTANCE_NAME: nomes das instâncias para as quais você quer excluir configurações por instância

O método deletePerInstanceConfig exclui as configurações especificadas por instância, mas não aplica as alterações às VMs associadas. As alterações são aplicadas a uma VM quando você recria ou atualiza a instância. Atualize as VMs selecionadas manualmente para aplicar as alterações.

Por exemplo, para excluir a configuração por instância para node-1 em example-group, chame o seguinte método:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-group/deletePerInstanceConfigs

{
  "names": ["node-1"]
}

O método exclui a configuração por instância da instância node-1 de example-group. A alteração será aplicada à instância gerenciada quando você recriar ou atualizar a instância.

Para aplicar a alteração de configuração, chame o método instanceGroupManagers.applyUpdatesToInstances:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-group/applyUpdatesToInstances

{
  "instances": ["/zones/us-east1-c/instances/node-1"]
}

O método remove itens com estado do estado preservado da instância gerenciada.

Feedback

Queremos saber sobre seus casos de uso, desafios e feedback que envolvem os MIGs com estado. Compartilhe essas informações com nossa equipe em mig-discuss@google.com.

A seguir