Suspender ou parar manualmente VMs em um MIG

Este documento explica como suspender e interromper instâncias de máquinas virtuais (VM) em um grupo gerenciado de instâncias (MIG) e como retomar sua operação.

Antes de começar

  • Revise a página introdutória sobre VMs suspensas e interrompidas em um MIG .
  • 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.

      3. 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.

Suspender VMs específicas em um MIG

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

Console

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

    Vá para a página Grupos de instâncias

  2. Clique no nome do grupo de instâncias onde você deseja 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ê deseja suspender.
  4. Clique em Suspender .
  5. Na caixa de diálogo de confirmação exibida, clique em Suspender para confirmar.

gcloud

Use o comando de instance-groups managed suspend-instances .

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

Substitua o seguinte:

  • MIG_NAME : o nome do MIG no qual suspender uma instância.
  • 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 onde o MIG está localizado.
  • ZONE : para um MIG zonal, a zona onde o MIG está localizado.

DESCANSAR

Use o método instanceGroupManager.suspendInstances 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 o seguinte:

  • PROJECT_ID : o ID do projeto da solicitação.
  • ZONE : para um MIG zonal, a zona onde o MIG está localizado.
    • Para um MIG regional, substitua zones/ ZONE por regions/ REGION e especifique a região do MIG.
  • MIG_NAME : o nome do MIG no qual suspender uma instância.
  • 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írgula, 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 console do Google Cloud, a CLI gcloud ou a API Compute Engine.

Console

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

    Vá para a página Grupos de instâncias

  2. Clique no nome do grupo de instâncias onde você deseja 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ê deseja 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 o seguinte:

  • MIG_NAME : o nome do MIG no qual será retomada uma instância.
  • 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 onde o MIG está localizado.
  • ZONE : para um MIG zonal, a zona onde o MIG está localizado.

DESCANSAR

Use o método instanceGroupManager.resumeInstances 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 o seguinte:

  • PROJECT_ID : o ID do projeto da solicitação.
  • ZONE : para um MIG zonal, a zona onde o MIG está localizado.
    • Para um MIG regional, substitua zones/ ZONE por regions/ REGION e especifique a região do MIG.
  • MIG_NAME : o nome do MIG no qual será retomada uma instância.
  • 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írgula, por exemplo, "zones/us-central1-a/instances/example-instance-name1","zones/us-central1-a/instances/example-instance-name2" .

Pare as VMs selecionadas em um MIG

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

Console

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

    Vá para a página Grupos de instâncias

  2. Clique no nome do grupo de instâncias onde você deseja 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ê deseja interromper e clique em Parar .
  4. Na caixa de diálogo de confirmação exibida, clique em Parar 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 o seguinte:

  • MIG_NAME : o nome do MIG no qual interromper uma instância.
  • 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 onde o MIG está localizado.
  • ZONE : para um MIG zonal, a zona onde o MIG está localizado.

DESCANSAR

Use o método instanceGroupManager.stopInstances 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 o seguinte:

  • PROJECT_ID : o ID do projeto da solicitação.
  • ZONE : para um MIG zonal, a zona onde o MIG está localizado.
    • Para um MIG regional, substitua zones/ ZONE por regions/ REGION e especifique a região do MIG.
  • MIG_NAME : o nome do MIG no qual interromper uma instância.
  • 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írgula, 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 console do Google Cloud, a CLI gcloud ou a API Compute Engine.

Console

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

    Vá para a página Grupos de instâncias

  2. Clique no nome do grupo de instâncias onde você deseja iniciar as VMs.
  3. Na página Visão geral do grupo de instâncias, em Instâncias de VM , selecione todas as VMs interrompidas que você deseja iniciar 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 o seguinte:

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

DESCANSAR

Use o método instanceGroupManager.startInstances 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 o seguinte:

  • PROJECT_ID : o ID do projeto da solicitação.
  • ZONE : para um MIG zonal, a zona onde o MIG está localizado.
    • Para um MIG regional, substitua zones/ ZONE por regions/ REGION e especifique a região do MIG.
  • MIG_NAME : o nome do MIG no qual iniciar uma instância.
  • 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írgula, por exemplo, "zones/us-central1-a/instances/example-instance-name1","zones/us-central1-a/instances/example-instance-name2" .

O que vem a seguir