Ver ou cancelar a criação em massa de instâncias em um MIG

Neste documento, descrevemos como visualizar o status da criação em massa de instâncias de máquina virtual (VM) em um grupo gerenciado de instâncias (MIG). Também explicamos como cancelar uma criação em massa em andamento.

Para saber como a criação em massa de instâncias funciona em um MIG, consulte Sobre a criação em massa de instâncias em um MIG.

Conferir o status da criação em massa de instâncias

É possível conferir o status de uma operação de criação em massa em um MIG. O status permite verificar se a criação em massa ainda está em andamento e, se as instâncias ainda não foram criadas, entender os motivos.

Os detalhes do MIG contêm os seguintes campos para ajudar a monitorar o status da criação em massa:

  • status.bulkInstanceOperation.inProgress: esse campo indica se uma criação em massa de instâncias está em andamento (true) ou não (false).

  • lastProgressCheck: esse campo fornece detalhes sobre por que as instâncias ainda não foram criadas. Os motivos possíveis são os seguintes:

    • Falta de capacidade: quando o MIG estiver aguardando a capacidade solicitada ficar disponível, você verá o código de erro ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS.

    • Cota insuficiente: quando não houver cota suficiente para atender à solicitação, você verá o erro QUOTA_EXCEEDED. Para aumentar a cota do seu projeto, consulte Solicitar um ajuste de cota.

gcloud

Para conferir o status da criação em massa de instâncias em um MIG, use o gcloud compute instance-groups managed describe comando.

  • Para um MIG zonal, execute o seguinte comando:

    gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --zone=ZONE

  • Para um MIG regional, execute o seguinte comando:

    gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --region=REGION

    Substitua:

  • INSTANCE_GROUP_NAME: o nome do MIG;

  • ZONE: a zona em que o MIG existe;

  • REGION: a região em que o MIG existe.

O exemplo a seguir mostra uma resposta para um MIG em que uma criação em massa está em andamento e o campo lastProgressCheck indica que a criação em massa está aguardando recursos devido a um erro ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS e também tem um erro QUOTA_EXCEEDED.

{
  "status": {
    "bulkInstanceOperation": {
      "inProgress": true,
      "lastProgressCheck": {
        "timestamp": "2024-01-01T12:00:00.712-08:00",
        "errors": [
          {
            "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
            "message": "Waiting for resources. Currently there are not enough resources available to fulfill the request."
          },
          {
            "code": "QUOTA_EXCEEDED",
            "message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1."
          }
        ]
      }
    }
  }
}

REST

Para conferir o status da criação em massa de instâncias em um MIG, faça uma solicitação GET da seguinte maneira:

  • Para um MIG zonal, use o instanceGroupManagers.get método.

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

  • Para um MIG regional, use o regionInstanceGroupManagers.get método.

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

Substitua:

  • PROJECT_ID: o ID do projeto;
  • ZONE: a zona em que o MIG existe;
  • REGION: a região em que o MIG existe;
  • INSTANCE_GROUP_NAME: o nome do MIG.

O exemplo a seguir mostra uma resposta para um MIG em que uma criação em massa está em andamento e o campo lastProgressCheck indica que a criação em massa está aguardando recursos devido a um erro ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS e também tem um erro QUOTA_EXCEEDED.

{
  "status": {
    "bulkInstanceOperation": {
      "inProgress": true,
      "lastProgressCheck": {
        "timestamp": "2024-01-01T12:00:00.712-08:00",
        "errors": [
          {
            "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
            "message": "Waiting for resources. Currently there are not enough resources available to fulfill the request."
          },
          {
            "code": "QUOTA_EXCEEDED",
            "message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1."
          }
        ]
      }
    }
  }
}

Conferir o status de instâncias gerenciadas

É possível monitorar o status de instâncias gerenciadas individuais verificando a ação atual e o status da instância.

  • Enquanto a operação de instância em massa estiver em andamento, as instâncias gerenciadas vão mostrar os seguintes status:

    • currentAction: CREATING
    • instanceStatus: PENDING

  • Depois que a operação de instância em massa for concluída, os status das instâncias gerenciadas vão mudar para o seguinte:

    • currentAction: NONE
    • instanceStatus: RUNNING

Para conferir essas informações sobre instâncias gerenciadas, consulte Verificar o status de instâncias gerenciadas.

Cancelar a operação de criação em massa

Para cancelar uma operação de criação em massa, redimensione o MIG para zero ou exclua o MIG.

Redimensionar o MIG para zero

Console

  1. Acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Clique no nome do MIG que você quer redimensionar.

  3. Clique em Editar.

  4. Clique em Tamanho do grupo e escalonamento automático para abrir a seção.

  5. Defina o Número de instâncias como 0.

  6. Clique em Salvar.

gcloud

Para redimensionar um MIG para zero, use o gcloud compute instance-groups managed resize comando e defina a --size flag como 0.

  • Para um MIG zonal, execute o seguinte comando:

    gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size=0 \
    --zone=ZONE

  • Para um MIG regional, execute o seguinte comando:

    gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size=0 \
    --region=REGION

Substitua:

  • INSTANCE_GROUP_NAME: o nome do MIG;
  • ZONE: a zona em que o MIG existe;
  • REGION: a região em que o MIG existe.

  • REST

    Para redimensionar um MIG para zero, faça uma solicitação PATCH usando um dos seguintes métodos. No corpo da solicitação, defina targetSize como 0.

    • Para um MIG zonal, use o instanceGroupManagers.patch método.

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

{
  "targetSize": 0
}

    • Para um MIG regional, use o regionInstanceGroupManagers.patch método.

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "targetSize": 0
}

    Substitua:

    • PROJECT_ID: o ID do projeto;
    • ZONE: a zona em que o MIG existe;
    • REGION: a região em que o MIG existe;
    • INSTANCE_GROUP_NAME: o nome do MIG.

Excluir um MIG

Console

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

    Acesse grupo de instâncias

  2. Marque a caixa de seleção do MIG que você quer excluir.

  3. Clique em Excluir para excluir o MIG e todas as instâncias nele.

gcloud

Para excluir um MIG, use o delete comando.

  • Para um MIG zonal, execute o seguinte comando:

    gcloud compute instance-groups managed delete INSTANCE_GROUP_NAME \
    --zone ZONE

  • Para um MIG regional, execute o seguinte comando:

    gcloud compute instance-groups managed delete INSTANCE_GROUP_NAME \
    --region REGION

Substitua:

  • INSTANCE_GROUP_NAME: o nome do MIG;
  • ZONE: a zona em que o MIG existe;
  • REGION: a região em que o MIG existe.

REST

Para excluir um MIG, faça uma solicitação PATCH usando um dos seguintes métodos:

Substitua:

  • PROJECT_ID: o ID do projeto;
  • ZONE: a zona em que o MIG existe;
  • REGION: a região em que o MIG existe;
  • INSTANCE_GROUP_NAME: o nome do MIG.

A seguir