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.

  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:

• Defina o método de substituição como RECREATE.
• Defina a sobretensão máxima como 0.
• Para MIGs regionais, é preciso desativar a redistribuição proativa de instâncias entre as zonas.

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

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

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

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.

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

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

{
  "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 compute instance-groups managed instance-configs list NAME

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

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

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

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

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

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

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

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

• Declarar discos permanentes com estado anterior como sem estado para todas as VMs em um MIG.
• Declarar interfaces de rede que anteriormente eram com estado como sem estado para todas as VMs em um MIG.
• Como remover um disco com estado ou declará-lo sem estado para uma VM específica em um MIG.
• Como remover metadados com estado de uma VM específica em um MIG
• Como desassociar um endereço IP estático de uma VM específica em um MIG.

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

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

{
  "statefulPolicy": null
}

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 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]

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

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

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

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

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

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"]
}

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

• Configure um MIG com estado.
• Veja informações sobre um MIG específico e suas instâncias gerenciadas, incluindo o status e as propriedades da VM.
• Saiba mais sobre MIGs com estado.
• Saiba mais sobre MIGs e como trabalhar com instâncias gerenciadas.