Veja informações sobre os MIGs e as instâncias geridas

Use os métodos nesta página para ver informações sobre os seus grupos de instâncias geridas (GIGs) e para ver informações sobre as instâncias de máquinas virtuais (VMs) em cada GIG.

Antes de começar

• Reveja as limitações e, de seguida, crie um grupo.
• Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se 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. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:

     gcloud init

     Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

  2. Set a default region and zone.

  REST

  Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

  Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:

  gcloud init

  Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

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

Veja informações sobre os MIGs

Pode obter informações sobre os próprios grupos, por exemplo, para inspecionar as políticas associadas ao grupo e verificar se o grupo é estável ou está a sofrer alterações. Para obter informações sobre as instâncias de VMs num GIG, consulte o artigo Veja informações sobre instâncias geridas.

Apresentar MIGs

Para obter uma lista dos seus grupos de instâncias geridos, use a consola, a CLI gcloud ou a 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 ver informações sobre um MIG específico, incluindo as respetivas políticas (por exemplo, as políticas de atualização e autorrecuperação do grupo), use a consola, a CLI gcloud ou a REST.

Para ver o valor id do grupo, tem de usar 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 pedidos criam, eliminam e modificam instâncias num grupo de instâncias gerido. Essas operações são devolvidas como DONE depois de o grupo ter ações agendadas para criar, eliminar ou atualizar essas instâncias. No entanto, isto não significa que as instâncias no grupo tenham sido criadas, eliminadas ou atualizadas até que essas ações subjacentes estejam concluídas. Tem de validar o estado do grupo ou, em alternativa, validar o estado dessas instâncias.

Um grupo de instâncias gerido está estável quando todas as instâncias no grupo de instâncias gerido não estão a sofrer alterações, não estão agendadas alterações futuras para as instâncias e o próprio grupo não está a ser modificado.

Pode ter de saber se o grupo é estável quando tem dependências que dependem de todas as instâncias no grupo estarem em bom estado e a serem publicadas. Por exemplo, pode querer começar a agendar tarefas, 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 em bom estado.

Verifique se todas as instâncias num grupo de instâncias gerido estão em execução e em bom estado de funcionamento através da verificação do 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á a ser modificado.

status.isStable definido como true indica o seguinte:

• Nenhuma das instâncias no MIG está a sofrer qualquer tipo de alteração e o valor de currentAction para todas as instâncias é NONE.
• Não existem alterações pendentes para instâncias no MIG.
• O MIG não está a ser modificado.

Lembre-se de que a estabilidade de um MIG depende de vários fatores, uma vez que um MIG pode ser modificado de várias formas. Por exemplo:

• Faz um pedido para implementar um novo modelo de instância.
• Faz um pedido para criar, eliminar, redimensionar ou atualizar instâncias no MIG.
• Um escalador automático pede para redimensionar o GIG.
• Um recurso de recuperação automática está a substituir uma ou mais instâncias não íntegras no MIG.
• Num MIG regional, algumas das instâncias estão a ser redistribuídas.

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

Para instâncias de VMs individuais, consulte o artigo Verificar o estado das instâncias geridas.

Verifique se as reparações de VMs estão desativadas num MIG

Para verificar se as reparações de VMs estão desativadas num MIG, use a consola, a CLI gcloud ou a REST.

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

  instanceLifecyclePolicy:
    defaultActionOnFailure: DO_NOTHING
    forceUpdateOnRepair: NO
    onFailedHealthCheck: DEFAULT_ACTION

GET https://compute.googleapis.com/compute/beta/projects/project_ID/zones/zone/instanceGroupManagers/instance_group

...
"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "NO",
  "defaultActionOnFailure": "DO_NOTHING",
  "onFailedHealthCheck": "DEFAULT_ACTION"
}
...

Se as reparações estiverem desativadas e quiser ativá-las novamente, consulte o artigo Ative as reparações ou a autocura.

Veja as operações de autocorreção do histórico

Se configurou a autocorreção, pode ver eventos de autocorreção anteriores.

Monitorize atualizações graduais

Se iniciou uma atualização contínua e quer saber quando a atualização estiver concluída, consulte Monitorizar atualizações.

Veja a configuração com estado

Se configurou um MIG com estado e quiser rever a sua configuração, consulte o artigo Ver configuração com estado.

Veja detalhes sobre as instâncias de VMs geridas num MIG

Esta secção explica como ver vários detalhes sobre instâncias geridas num MIG.

Apresente uma lista das instâncias geridas de um MIG

Para ver uma lista das instâncias geridas num grupo, incluindo os respetivos estados e modelos, use a consola, a CLI gcloud ou a 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 estado das instâncias geridas

Vários comandos e pedidos criam, eliminam e modificam instâncias num grupo de instâncias gerido. Essas operações são devolvidas como DONE depois de o grupo ter ações agendadas para criar, eliminar ou atualizar essas instâncias. No entanto, isto não significa que as instâncias no grupo tenham sido criadas, eliminadas ou atualizadas até que essas ações subjacentes estejam concluídas. Tem de validar o estado dessas instâncias ou, em alternativa, validar o estado do próprio grupo.

Use a Google Cloud CLI ou a REST para ver detalhes sobre as instâncias num grupo de instâncias gerido. Os detalhes incluem o estado da instância e as ações atuais que o grupo está a realizar nas respetivas instâncias.

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

NAME: vm-instances-9pk4
ZONE: us-central1-f
STATUS:
HEALTH_STATE:
ACTION: CREATING
INSTANCE_TEMPLATE: my-new-template
VERSION_NAME:
LAST_ERROR:

NAME: vm-instances-h2r1
ZONE: us-central1-f
STATUS: STOPPING
HEALTH_STATE:
ACTION: DELETING
INSTANCE_TEMPLATE: my-old-template
VERSION_NAME:
LAST_ERROR:

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",
      "instanceStatus": "RUNNING",
      "currentAction": "REFRESHING",
      "id": "5317605642920955957",
      "version": {
        instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template"
      },
      "name": "vm-instances-prvp"
    },
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-w2t5",
      "instanceStatus": "RUNNING",
      "currentAction": "REFRESHING",
      "id": "2800161036826218547",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template"
      },
      "name": "vm-instances-w2t5"
    }
  ]
}

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

Se uma instância estiver a sofrer algum tipo de alteração, o grupo de instâncias gerido define o campo currentAction da instância para uma das seguintes ações para ajudar a acompanhar o progresso da alteração. Caso contrário, o campo currentAction é definido como NONE.

Os valores currentAction possíveis são:

• ABANDONING. A instância está a ser removida do MIG.
• CREATING. A instância está em processo de criação.
• CREATING_WITHOUT_RETRIES. A instância está a ser criada sem novas tentativas. Se a instância não for criada na primeira tentativa, o MIG não tenta substituí-la novamente.
• DELETING. A instância está a ser eliminada.
• RECREATING. A instância está a ser substituída.
• REFRESHING. A instância está a ser removida dos conjuntos de destino atuais e está a ser adicionada novamente à lista de conjuntos de destino atuais (esta lista pode ser igual ou diferente dos conjuntos de destino existentes).
• RESTARTING. A instância está a ser reiniciada através dos métodos stop e start.
• RESUMING. A instância está a ser retomada após ter sido suspensa.
• STARTING. A instância está a ser iniciada depois de ter sido parada.
• STOPPING. A instância está a ser parada.
• SUSPENDING. A instância está a ser suspensa.
• VERIFYING. A instância foi criada e está em processo de validação.
• NONE. Não estão a ser realizadas ações na instância.

Para verificar se o grupo como um todo é estável ou está a sofrer alterações, consulte a secção Verificar o estado do grupo.

Verifique os estados de funcionamento

Se configurou a autorreparação para o seu grupo de instâncias geridas, pode rever o estado de funcionamento de cada VM. Consulte o artigo Verificar o estado de funcionamento.

Apresente erros de instâncias

Se as suas instâncias geridas tiverem encontrado erros, pode vê-los para diagnosticar e mitigar a causa.

Use a Google Cloud consola, a CLI gcloud ou o 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:

• Não é possível criar uma nova instância devido ao seguinte:
  • Indisponibilidade de capacidade preemptível.
  • Falta de quota, por exemplo, para CPUs numa determinada região.
  • Foi atingido o limite do número de instâncias de VM para a rede associada ao grupo.
  • A imagem de disco especificada no campo properties.disks[].initializeParams.sourceImage do modelo de instância foi eliminada ou as respetivas autorizações foram alteradas.
  • O cartão de crédito na conta de faturação associada ao projeto recusou um pagamento.
• Não é possível eliminar uma instância existente porque:
  • A conta de serviço que o grupo usa não tem autorização compute.instances.delete.
  • Foram pedidas demasiadas eliminações simultâneas, excedendo os limites de taxa.
• Não é possível adicionar uma instância a um grupo de destino porque o grupo de destino foi eliminado.

Depois de inspecionar esses erros, pode mitigá-los. Por exemplo:

• Mova a sua carga de trabalho para uma zona diferente com capacidade preemptível.
• Peça um aumento da quota numa determinada região.
• Adicione a autorização compute.instances.delete à conta de serviço usada pelo grupo.

Se uma ação acionada por um grupo de instâncias gerido falhar (por exemplo, se um escalador automático encontrar um erro ao tentar aumentar o tamanho do grupo), o grupo pode tentar novamente essa ação imediatamente. Se a última tentativa de repetição imediata falhar, o MIG regista o erro, e pode ver o erro listando os erros de instância. Após algum tempo de recuo, o grupo volta a tentar a ação com falha. Se o erro persistir, pode ser registado várias vezes.

O Compute Engine retém os 500 erros mais recentes dos últimos 8 dias, mesmo que as instâncias subjacentes já não existam ou não tenham sido criadas.

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

Para verificar se uma VM específica é membro de um grupo, pode usar a consola ou a API REST.

Em alternativa, para identificar se uma VM é ou foi membro de um grupo de instâncias gerido, 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 geridas que criou a VM.

Mesmo que abandone a instância, a VM continua a ter estas entradas de metadados, a menos que as remova manualmente.

Por exemplo, se existir uma VM denominada random-instance-biy e quiser saber se a VM foi criada por um grupo de instâncias gerido, pode 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 devolve uma resposta semelhante à seguinte:

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

Veja o estado preservado de uma instância gerida

Se configurou um MIG com estado e quer ver o estado preservado de cada instância gerida, consulte o artigo Ver a configuração com estado e o estado preservado.

O que se segue?

• Saiba mais acerca dos grupos de instâncias geridos.
• Crie um modelo de instância que pode usar para criar um grupo de instâncias gerido.