Suspender ou interromper manualmente VMs em um MIG

Neste documento, explicamos como suspender e interromper instâncias de máquina virtual (VM) em um grupo gerenciado de instâncias (MIG) e como retomar a operação delas.

Antes de começar

• Consulte a página introdutória sobre VMs suspensas e interrompidas em um MIG.
• Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a Google Cloud serviços e APIs do. Para executar códigos ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com um destes métodos:

  Selecione a guia para como planeja usar as amostras nesta página:

  Console

  Quando você usa o Google Cloud console para acessar Google Cloud serviços e APIs, não é necessário configurar a autenticação.

  gcloud

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

     gcloud init

     Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

     Observação: se você já tiver instalado a CLI gcloud, verifique se você tem a versão mais recente executando gcloud components update.
• Defina uma região e uma zona padrão.

REST

Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

Instale a Google Cloud CLI.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Suspender VMs específicas em um MIG

É possível suspender uma VM em execução em um MIG usando o Google Cloud console, a Google Cloud CLI ou a API Compute Engine.

Console

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

   Acessar a página "Grupos de instâncias"

2. Clique no nome do grupo de instâncias em que você quer suspender as VMs.
3. Na página Visão geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs que você quer suspender.
4. Clique em Suspender.
5. Na caixa de diálogo de confirmação, clique em Suspender para confirmar.

gcloud

Use o comando instance-groups managed suspend-instances.

gcloud compute instance-groups managed suspend-instances MIG_NAME \
  --instances=INSTANCE_NAME \
  [--region=REGION | --zone=ZONE]

Substitua:

• MIG_NAME: o nome do MIG em que uma instância será suspensa.
• INSTANCE_NAME: o nome da instância a ser suspensa. Para suspender várias instâncias, forneça uma lista de nomes separados por vírgulas.
• REGION: para um MIG regional, a região em que o MIG está localizado.
• ZONE: para um MIG zonal, a zona em que o MIG está localizado.

REST

Use o instanceGroupManager.suspendInstances método e especifique as instâncias no corpo da solicitação. Para MIGs regionais, use o método regionInstanceGroupManager.suspendInstances.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/suspendInstances

{
  "instances": [
    "INSTANCE_NAME_URL"
  ]
}

Substitua:

• PROJECT_ID: o ID do projeto para a solicitação.
• ZONE: para um MIG zonal, a zona em que o MIG está localizado.
  • zones/ZONE por regions/REGION e especifique a região do MIG se ele for regional;
• MIG_NAME: o nome do MIG em que uma instância será suspensa.
• INSTANCE_NAME_URL: o URL da instância a ser suspensa, por exemplo, zones/us-central1-a/instances/example-instance-name1. Para suspender várias instâncias, forneça uma lista de URLs separados por vírgulas, por exemplo, "zones/us-central1-a/instances/example-instance-name1","zones/us-central1-a/instances/example-instance-name2".

Retomar VMs selecionadas em um MIG

É possível retomar uma VM suspensa em um MIG usando o Google Cloud console, a CLI gcloud ou a API Compute Engine.

Console

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

   Acessar a página "Grupos de instâncias"

2. Clique no nome do grupo de instâncias em que você quer retomar as VMs.
3. Na página Visão geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs suspensas que você quer retomar e clique em Iniciar/Retomar.

gcloud

Use o comando instance-groups managed resume-instances.

gcloud compute instance-groups managed resume-instances MIG_NAME \
  --instances=INSTANCE_NAME \
  [--region=REGION | --zone=ZONE]

Substitua:

• MIG_NAME: o nome do MIG em que uma instância será retomada.
• INSTANCE_NAME: o nome da instância a ser retomada. Para retomar várias instâncias, forneça uma lista de nomes separados por vírgulas.
• REGION: para um MIG regional, a região em que o MIG está localizado.
• ZONE: para um MIG zonal, a zona em que o MIG está localizado.

REST

Use o instanceGroupManager.resumeInstances método e especifique as instâncias no corpo da solicitação. Para MIGs regionais, use o método regionInstanceGroupManager.resumeInstances.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/resumeInstances

{
  "instances": [
    "INSTANCE_NAME_URL"
  ]
}

Substitua:

• PROJECT_ID: o ID do projeto para a solicitação.
• ZONE: para um MIG zonal, a zona em que o MIG está localizado.
  • zones/ZONE por regions/REGION e especifique a região do MIG se ele for regional;
• MIG_NAME: o nome do MIG em que uma instância será retomada.
• INSTANCE_NAME_URL: o URL da instância a ser retomada, por exemplo, zones/us-central1-a/instances/example-instance-name1. Para retomar várias instâncias, forneça uma lista de URLs separados por vírgulas, por exemplo, "zones/us-central1-a/instances/example-instance-name1","zones/us-central1-a/instances/example-instance-name2".

Interromper VMs selecionadas em um MIG

É possível interromper uma VM em execução em um MIG usando o Google Cloud console, a Google Cloud CLI ou a API Compute Engine.

Console

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

   Acessar a página "Grupos de instâncias"

2. Clique no nome do grupo de instâncias em que você quer interromper as VMs.
3. Na página Visão geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs que você quer interromper e clique em Interromper. Se não houver a opção Interromper, clique em Mais ações > Interromper.
4. Na caixa de diálogo de confirmação que aparece, clique em Interromper para confirmar.

gcloud

Use o comando instance-groups managed stop-instances.

gcloud compute instance-groups managed stop-instances MIG_NAME \
  --instances=INSTANCE_NAME \
  [--region=REGION | --zone=ZONE]

Substitua:

• MIG_NAME: o nome do MIG em que uma instância será interrompida.
• INSTANCE_NAME: o nome da instância a ser interrompida. Para interromper várias instâncias, forneça uma lista de nomes separados por vírgulas.
• REGION: para um MIG regional, a região em que o MIG está localizado.
• ZONE: para um MIG zonal, a zona em que o MIG está localizado.

REST

Use o instanceGroupManager.stopInstances método e especifique as instâncias no corpo da solicitação. Para MIGs regionais, use o método regionInstanceGroupManager.stopInstances.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/stopInstances

{
  "instances": [
    "INSTANCE_NAME_URL"
  ]
}

Substitua:

• PROJECT_ID: o ID do projeto para a solicitação.
• ZONE: para um MIG zonal, a zona em que o MIG está localizado.
  • zones/ZONE por regions/REGION e especifique a região do MIG se ele for regional;
• MIG_NAME: o nome do MIG em que uma instância será interrompida.
• INSTANCE_NAME_URL: o URL da instância a ser interrompida, por exemplo, zones/us-central1-a/instances/example-instance-name1. Para interromper várias instâncias, forneça uma lista de URLs separados por vírgulas, por exemplo, "zones/us-central1-a/instances/example-instance-name1","zones/us-central1-a/instances/example-instance-name2".

Iniciar VMs selecionadas em um MIG

É possível iniciar uma VM interrompida em um MIG usando o Google Cloud console, a CLI gcloud ou a API Compute Engine.

Console

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

   Acessar a página "Grupos de instâncias"

2. Clique no nome do grupo de instâncias em que você quer iniciar as VMs.
3. Na página Visão geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs suspensas que você quer retomar e clique em Iniciar/Retomar.

gcloud

Use o comando instance-groups managed start-instances.

gcloud compute instance-groups managed start-instances MIG_NAME \
  --instances=INSTANCE_NAME \
  [--region=REGION | --zone=ZONE]

Substitua:

• MIG_NAME: o nome do MIG em que uma instância será iniciada.
• INSTANCE_NAME: o nome da instância a ser iniciada. Para iniciar várias instâncias, forneça uma lista de nomes separados por vírgulas.
• REGION: para um MIG regional, a região em que o MIG está localizado.
• ZONE: para um MIG zonal, a zona em que o MIG está localizado.

REST

Use o instanceGroupManager.startInstances método e especifique as instâncias no corpo da solicitação. Para MIGs regionais, use o método regionInstanceGroupManager.startInstances.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/startInstances

{
  "instances": [
    "INSTANCE_NAME_URL"
  ]
}

Substitua:

• PROJECT_ID: o ID do projeto para a solicitação.
• ZONE: para um MIG zonal, a zona em que o MIG está localizado.
  • zones/ZONE por regions/REGION e especifique a região do MIG se ele for regional;
• MIG_NAME: o nome do MIG em que uma instância será iniciada.
• INSTANCE_NAME_URL: o URL da instância a ser iniciada. Por exemplo, zones/us-central1-a/instances/example-instance-name1. Para iniciar várias instâncias, forneça uma lista de URLs separados por vírgulas, por exemplo, "zones/us-central1-a/instances/example-instance-name1","zones/us-central1-a/instances/example-instance-name2".

A seguir

• Saiba como acelerar o escalonamento horizontal com o pool em espera.