Ver informações sobre MIGs e instâncias gerenciadas

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

Use os métodos nesta página para visualizar informações sobre seus grupos de instâncias gerenciadas (MIGs) e para visualizar informações sobre as instâncias de máquina virtual (VM) em cada MIG.

Antes de começar

• Revise as limitações e crie um grupo.
• 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.

Ver informações sobre MIGs

Você pode recuperar informações sobre os próprios grupos, por exemplo, para inspecionar as políticas anexadas ao grupo e para verificar se o grupo está estável ou passando por alterações. Para obter informações sobre as instâncias de VM em um MIG, consulte Exibir informações sobre instâncias gerenciadas .

Listar MIGs

Para obter uma lista dos seus grupos de instâncias gerenciadas, use o console , a CLI gcloud ou REST .

gcloud compute instance-groups managed list

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers

Veja as propriedades de um MIG

Para visualizar informações sobre um MIG específico, incluindo suas políticas (por exemplo, as políticas de recuperação automática e atualização do grupo), use o console , a CLI gcloud ou REST .

Para visualizar o valor id do grupo, use a CLI gcloud ou a API Compute Engine.

gcloud compute instance-groups managed describe instance-group \
    [--zone zone | --region region]

gcloud compute instance-groups managed describe instance-group --format="(autoscaler)"

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/regionAutoscalers/mig_name

Verifique se um MIG é estável

Vários comandos e solicitações criam, excluem e modificam instâncias em um grupo gerenciado de instâncias. Essas operações são retornadas como DONE depois que o grupo agenda ações para criar, excluir ou atualizar essas instâncias. No entanto, isso não significa que as instâncias do grupo foram criadas, excluídas ou atualizadas até que as ações subjacentes sejam concluídas. Você deve verificar o status do grupo ou, alternativamente , verificar o status dessas instâncias .

Um grupo de instâncias gerenciadas é estável quando todas as instâncias no grupo de instâncias gerenciadas não estão passando por nenhuma alteração, nenhuma alteração futura está programada para as instâncias e o próprio grupo não está sendo modificado.

Talvez seja necessário saber se o grupo é estável quando você tem dependências que dependem de todas as instâncias do grupo estarem íntegras e funcionando. Por exemplo, talvez você queira começar a agendar trabalhos, enviar tráfego ou atribuir intervalos de chaves depois de ter a confirmação de que todas as VMs estão em execução e íntegras.

Verifique se todas as instâncias em um grupo de instâncias gerenciadas estão em execução e íntegras verificando o valor do campo status.isStable do grupo.

gcloud compute instance-groups managed describe instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed wait-until instance-group-name \
    --stable \
    [--zone zone | --region region]
Waiting for group to become stable, current operations: deleting: 4
Waiting for group to become stable, current operations: deleting: 4
...
Group is stable

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/get

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group-name/get

status.isStable definido como false indica que as alterações estão ativas, pendentes ou que o próprio MIG está sendo modificado.

status.isStable definido como true indica o seguinte:

• Nenhuma das instâncias do MIG está passando por qualquer tipo de alteração e a currentAction para todas as instâncias é NONE .
• Não há alterações pendentes para instâncias do MIG.
• O MIG em si não está sendo modificado.

Lembre-se de que a estabilidade de um MIG depende de vários fatores porque um MIG pode ser modificado de diversas maneiras. Por exemplo:

• Você faz uma solicitação para implementar um novo modelo de instância.
• Você faz uma solicitação para criar, excluir, redimensionar ou atualizar instâncias no MIG.
• Um escalonador automático solicita o redimensionamento do MIG.
• Um recurso de recuperação automática está substituindo uma ou mais instâncias não íntegras no MIG.
• Num MIG regional, algumas das instâncias estão sendo redistribuídas .

Assim que todas as ações forem concluídas, status.isStable será definido como true novamente para esse MIG.

Para instâncias de VM individuais, consulte Verificando o status de instâncias gerenciadas .

Verifique se os reparos de VM estão desativados em um MIG

Para verificar se os reparos de VM estão desativados em um MIG, use o console , a CLI gcloud ou a API .

gcloud compute instance-groups managed describe instance-group \
    --format="(instanceLifecyclePolicy)"

instanceLifecyclePolicy:
  defaultActionOnFailure: REPAIR
  forceUpdateOnRepair: NO

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

"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "NO",
  "defaultActionOnFailure": "REPAIR"
}

Se não quiser que um MIG repare uma VM com falha ou não íntegra no grupo, você poderá desativar os reparos no MIG .

Ver o histórico de operações de recuperação automática

Se você configurou a recuperação automática, poderá visualizar eventos de recuperação automática anteriores .

Monitore atualizações contínuas

Se você iniciou uma atualização contínua e deseja saber quando a atualização foi concluída, consulte Monitorando atualizações .

Ver configuração com estado

Se você configurou um MIG com estado e deseja revisar sua configuração, consulte Visualizando configuração com estado .

Ver informações sobre as instâncias de VM gerenciadas em um MIG

Liste as instâncias gerenciadas de um MIG

Para obter uma lista das instâncias gerenciadas em um grupo, incluindo seus estados e modelos, use o console , a CLI gcloud ou REST .

gcloud compute instance-groups managed list-instances instance-group \
    [--zone zone | --region region]

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

Verifique o status das instâncias gerenciadas

Vários comandos e solicitações criam, excluem e modificam instâncias em um grupo gerenciado de instâncias. Essas operações são retornadas como DONE depois que o grupo agenda ações para criar, excluir ou atualizar essas instâncias. No entanto, isso não significa que as instâncias do grupo foram criadas, excluídas ou atualizadas até que as ações subjacentes sejam concluídas. Você deve verificar o status dessas instâncias ou, alternativamente, verificar o status do próprio grupo .

Use a Google Cloud CLI ou REST para ver detalhes sobre as instâncias em um grupo de instâncias gerenciadas. Os detalhes incluem o status da instância e as ações atuais que o grupo está executando em suas instâncias.

gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
    [--zone=ZONE | --region=REGION]

NAME               ZONE           STATUS   HEALTH_STATE  ACTION  INSTANCE_TEMPLATE  VERSION_NAME  LAST_ERROR
vm-instances-9pk4  us-central1-f                          CREATING  my-new-template
vm-instances-h2r1  us-central1-f  STOPPING                DELETING  my-old-template
vm-instances-j1h8  us-central1-f  RUNNING                 NONE      my-old-template
vm-instances-ngod  us-central1-f  RUNNING                 NONE      my-old-template

gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--zone=ZONE | --region=REGION]

currentAction: NONE
id: '6789072894767812345'
instance: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-mig-hz41
instanceStatus: RUNNING
name: example-mig-hz41
preservedStateFromConfig:
  metadata:
    example-key: example-value
preservedStateFromPolicy:
  disks:
    persistent-disk-0:
      autoDelete: NEVER
      mode: READ_WRITE
      source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-mig-hz41
version:
  instanceTemplate: https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template

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

{
 "managedInstances": [
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-prvp",
   "id": "5317605642920955957",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-pz5j",
   "currentAction": "DELETING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-w2t5",
   "id": "2800161036826218547",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  }
 ]
}

Para ver uma lista de valores válidos do campo instanceStatus , consulte Ciclo de vida da instância de VM .

Se uma instância estiver passando por algum tipo de alteração, o grupo de instâncias gerenciadas definirá o campo currentAction da instância como uma das ações a seguir para ajudar você a acompanhar o progresso da alteração. Caso contrário, o campo currentAction será definido como NONE .

Os possíveis valores currentAction são:

• ABANDONING . A instância está sendo removida do MIG.
• CREATING . A instância está em processo de criação.
• CREATING_WITHOUT_RETRIES . A instância está sendo criada sem novas tentativas; se a instância não for criada na primeira tentativa, o MIG não tentará substituí-la novamente.
• DELETING . A instância está em processo de exclusão.
• RECREATING . A instância está sendo substituída.
• REFRESHING . A instância está sendo removida de seus pools de destino atuais e sendo readicionada à lista de pools de destino atuais (essa lista pode ser igual ou diferente dos pools de destino existentes).
• RESTARTING . A instância está sendo reiniciada usando os métodos stop e start .
• RESUMING . A instância está em processo de retomada após ser suspensa.
• STARTING . A instância está em processo de inicialização após ser interrompida.
• STOPPING . A instância está sendo interrompida.
• SUSPENDING . A instância está sendo suspensa.
• VERIFYING . A instância foi criada e está em processo de verificação.
• NONE . Nenhuma ação está sendo executada na instância.

Para verificar se o grupo como um todo está estável ou passando por alterações, consulte Verificando o status do grupo .

Verifique os estados de saúde

Se você configurou a recuperação automática para seu grupo de instâncias gerenciadas, poderá revisar o estado de integridade de cada VM. Consulte Verificando o status de integridade .

Listar erros de instância

Se suas instâncias gerenciadas encontraram erros, você poderá visualizá-los para diagnosticar e mitigar a causa.

Use o console do Google Cloud, a CLI gcloud ou REST para listar erros.

gcloud compute instance-groups managed list-errors instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed list-errors example-group \
    --region us-west1

INSTANCE_URL                                                                                        ACTION    ERROR_CODE      ERROR_MESSAGE                                                                                     TIMESTAMP                      INSTANCE_TEMPLATE                                                                                                            VERSION_NAME

https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-v0hl  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-v0hl' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.156-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-qp3d  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-qp3d' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.081-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
...

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100

{
 "items": [
  {
   "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Instance 'example-mig-m1sz' creation failed: Quota 'CPUS' exceeded.  Limit: 50.0 in zone us-central1-c."
   },
   "timestamp": "2019-01-03T18:47:28.457-08:00",
   "instanceDetails" : {
    "instance": "zones/us-central1-c/instances/example-mig-m1sz",
    "action": "CREATING",
    "version": {
     "name": "example-version-name",
     "instanceTemplate": "global/instanceTemplates/example-template",
    }
   }
  }
 ],
 ...
 "nextPageToken": "Ch0yMDE5LTA3LTI5VDExOjA4OjA2LjYxMi0wNzowMBJ5aHR0cHM6Ly93d3cuZ29vZ2xlYXBpcy5jb20vY29tcHV0ZS9zdGFnaW5nX2FscGhhL3Byb2plY3RzL215cnpha2VyZXltcy1zdGFnaW5nL3pvbmVzL3VzLWNlbnRyYWwxLWlyMS9pbnN0YW5jZXMvaWdtLTEtcXAzZA=="
}

A lista de possíveis erros inclui, entre outros, os seguintes exemplos:

• Uma nova instância não pode ser criada devido a:
  • Indisponibilidade de capacidade preemptiva.
  • Falta de cota, por exemplo, para CPUs de uma determinada região.
  • O limite no número de instâncias de VM foi atingido para a rede associada ao grupo.
  • A imagem de disco especificada no campo properties.disks[].initializeParams.sourceImage do modelo de instância foi excluída ou suas permissões foram alteradas.
  • O cartão de crédito da conta de cobrança associada ao projeto recusou o pagamento.
• Uma instância existente não pode ser excluída porque:
  • A conta de serviço usada pelo grupo não tem permissão compute.instances.delete .
  • Foram solicitadas muitas exclusões simultâneas, excedendo os limites de taxa.
• Uma instância não pode ser adicionada a um pool de destino porque o pool de destino foi excluído.

Depois de inspecionar esses erros, você poderá mitigá-los. Por exemplo:

• Mova sua carga de trabalho para uma zona diferente que tenha capacidade preemptiva.
• Solicite um aumento de cota em uma determinada região.
• Adicione a permissão compute.instances.delete à conta de serviço usada pelo grupo.

Se uma ação acionada por um grupo de instâncias gerenciadas falhar (por exemplo, se um escalonador automático encontrar um erro ao tentar aumentar o tamanho do grupo), o grupo poderá tentar novamente essa ação imediatamente. Se a última tentativa imediata falhar, o MIG registrará o erro e você poderá visualizar o erro listando os erros da instância . Após algum tempo de espera, o grupo tenta novamente a ação que falhou. Se o erro persistir, ele poderá ser registrado diversas vezes.

O Compute Engine retém os 500 erros mais recentes dos últimos oito dias, mesmo que as instâncias subjacentes não existam mais ou não possam ser criadas.

Verifique se uma instância de VM faz parte de um MIG

Para verificar se uma VM específica é membro de um grupo, você pode usar o console ou REST.

Como alternativa, para identificar se uma VM é ou foi membro de um grupo de instâncias gerenciadas, procure estas duas chaves de metadados nos metadados da instância:

• instance-template indica o modelo a partir do qual a VM foi criada.
• created-by indica o grupo de instâncias gerenciadas que criou a VM.

Mesmo se você abandonar a instância, a VM ainda terá essas entradas de metadados, a menos que você as remova manualmente.

Por exemplo, se houvesse uma VM chamada random-instance-biy e você quisesse saber se a VM foi criada por um grupo de instâncias gerenciadas, você poderá descrever a instância e procurar as chaves de metadados. Por exemplo:

gcloud compute instances describe random-instance-biy \
    --zone us-central1-f

A CLI gcloud retorna uma resposta semelhante a:

canIpForward: false
cpuPlatform: Intel Ivy Bridge
creationTimestamp: '2016-08-24T14:11:38.012-07:00'
...
metadata:
  items:
  - key: instance-template
    value: projects/123456789012/global/instanceTemplates/example-it
  - key: created-by
    value: projects/123456789012/zones/us-central1-f/instanceGroupManagers/igm-metadata

Ver o estado preservado de uma instância gerenciada

Se você configurou um MIG com estado e deseja visualizar o estado preservado de cada instância gerenciada, consulte Visualização da configuração com estado e do estado preservado .

O que vem a seguir

• Saiba mais sobre grupos de instâncias gerenciadas .
• Crie um modelo de instância que você possa usar para criar um grupo de instâncias gerenciadas .