Aplicando, visualizando e removendo configurações com estado em MIGs

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

Depois de criar ou atualizar uma configuração com estado para um grupo gerenciado de instâncias (MIG) com estado , você poderá:

• Aplique a configuração com estado para que ela entre em vigor.
• Visualize a configuração com estado, bem como o estado efetivamente preservado de suas instâncias gerenciadas.
• Remova a configuração com estado.

Antes de começar

• Revise quando usar MIGs com estado e como funcionam os MIGs com estado .
• Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
  

  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. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  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.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Aplicando 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 configuração por instância podem ser aplicadas manual ou automaticamente.

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

Aplicando 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 em uma política com estado não interrompem a execução de instâncias de máquinas virtuais (VM).

Verificando se uma política com estado foi aplicada

Verificando todas as VMs

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

Verificando 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 verificando se todos os discos da política com estado estão presentes em preservedStateFromPolicy ou preservedStateFromConfig para a instância gerenciada.

Aplicando configuração com estado de configurações por instância

Você pode aplicar configurações por instância novas ou atualizadas manualmente ou automaticamente. 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 contínuas : use esta abordagem para aplicar alterações de configuração a instâncias gerenciadas de maneira automatizada e contínua.

Ambos os métodos aplicam atualizações pendentes de configurações por instância e de versões não aplicadas ou modelo de instância, se relevante.

Aplicar seletivamente a configuração atualizada a instâncias específicas

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

1. Configure uma política de atualização oportunista para evitar uma corrida 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 essas VMs.

Como alternativa, você pode usar as seguintes abordagens:

• 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 novas instâncias manualmente , especifique seus nomes e configurações por instância no momento da criação. O MIG aplica configurações imediatamente na criação da VM.

Aplicar automaticamente a configuração atualizada com atualizações contínuas

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

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

• Você deve definir o método de substituição como RECREATE .
• Você deve definir o pico máximo como 0 .
• Para MIGs regionais, você deve desabilitar a redistribuição proativa de instâncias entre zonas.

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

Você também pode garantir que as alterações nas configurações por instância sejam aplicadas sem parar as instâncias, se possível, definindo a ação mínima como REFRESH na política de atualização do grupo.

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

Verificando todas as configurações por instância

Para verificar se todas as configurações por instância em um MIG foram aplicadas, visualize 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 está em vigor: ou você ainda não a aplicou ou está em processo de aplicação.

Verificando 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, visualize todas as configurações por instância e verifique o campo status da configuração específica por instância:

• UNAPPLIED : a configuração por instância foi criada ou atualizada e você precisa aplicá-la à VM com uma atualização manual da instância.
• APPLYING : O MIG está atualmente aplicando a configuração nova ou atualizada por instância à VM.
• EFFECTIVE : A configuração por instância foi aplicada com êxito à VM e está em vigor.
• UNAPPLIED_DELETION : a configuração por instância está definida para ser excluída. Você deve aplicar esta atualização à VM com uma atualização manual da instância 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.

Visualizando configuração com estado e estado preservado

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

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

Visualizando o status da configuração com estado de um MIG

Um MIG é considerado stateful se tiver alguma configuração stateful , ou seja, uma política stateful 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 são aplicadas, visualize o status com estado do MIG usando a CLI gcloud ou 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,
  ...
}

Visualizando 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 CLI gcloud ou o 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,
  ...
}

Visualizando configurações por instância de um MIG

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

Se você decidir aplicar configurações por instância manualmente, algumas configurações por instância poderão ainda não ter sido aplicadas às instâncias associadas e, portanto, os estados preservados das instâncias poderão ainda não refletir suas configurações por instância. Para obter mais informações, consulte Aplicando configurações por instância e Verificando 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" : {
        ...
      }
      ...
    },
    ...
  ]
}

Visualizando os estados preservados de instâncias gerenciadas

Quando a configuração com estado é aplicada , o MIG gera e define 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 gerado com base em uma configuração por instância que já foi aplicada à instância gerenciada.

Para ver o estado efetivamente preservado de cada instância gerenciada em um MIG, liste as instâncias gerenciadas usando a CLI gcloud ou 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": {
        ...
      }
    },
    ...
  ]
}

Visualizando recursos de endereço IP estático associados

Para recuperar endereços IP estáticos (recursos de Address ) atribuídos a instâncias gerenciadas em um MIG, visualize os estados preservados dessas instâncias. Você pode 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ços IP ainda existirem, você poderá listar as reservas de endereços internos ou externos estáticos.

Removendo configuração com estado

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

• Você migrou VMs autônomas para um MIG com estado e agora deseja migrar a configuração com estado das configurações por instância para uma política com estado comum.
• Você reprojetou 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 deseja limpá-la.

Esta seção descreve como remover completamente uma política com estado em uma configuração por instância. Se você precisar remover apenas um subconjunto de uma política com estado ou configuração por instância, consulte as seções a seguir:

• Declarar discos persistentes anteriormente com estado como sem estado para todas as VMs em um MIG.
• Declarar interfaces de rede anteriormente com estado como sem estado para todos os VMS em um MIG.
• Desanexar um disco com estado ou declará-lo sem estado para uma VM específica em um MIG.
• Removendo metadados com estado de uma VM específica em um MIG
• Desassociar um endereço IP estático de uma VM específica em um MIG.

Removendo 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 que foram configurados na política com estado como sem estado, a menos que esses recursos também sejam configurados em configurações por instância para instâncias individuais. Nas operações subsequentes de recriação de instância, recuperação automática ou atualização, os recursos agora sem estado podem perder seu estado:

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

Para obter informações conceituais, veja como a remoção de um recurso da política com estado afeta o 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
}

Removendo configuração com estado para 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. Você pode escolher se a alteração deve ser aplicada manualmente ou automaticamente.

Após a aplicação da alteração, 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 sejam 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 de sua 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 obter mais informações, consulte como a remoção de itens de 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"]
}

Opinião

Queremos saber mais sobre seus casos de uso, desafios e feedback sobre MIGs com estado. Compartilhe seus comentários com nossa equipe em mig-discuss@google.com .

O que vem a seguir

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