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 serviços e APIs do Cloud de Confiance by S3NS . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:

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

    Console

    Quando você usa o console do Cloud de Confiance para acessar os serviços e as APIs do Cloud de Confiance by S3NS , não é necessário configurar a autenticação.

    gcloud

    1. Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init
  • 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 e faça login na CLI gcloud com sua identidade federada.

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

Suspender VMs específicas em um MIG

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

Console

  1. No console, do Cloud de Confiance , 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 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.s3nsapis.fr/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 console do Cloud de Confiance , a CLI gcloud ou a API Compute Engine.

Console

  1. No console, do Cloud de Confiance , 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 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.s3nsapis.fr/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

Se você tiver ativado o encerramento completo no modelo de instância usado pelo MIG, as VMs em execução no MIG serão encerradas normalmente quando você as interromper. Ao interromper uma VM em execução, é possível pular um encerramento completo ou encerrar um encerramento completo em andamento quando todas as tarefas forem concluídas para reduzir custos desnecessários.

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

Console

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

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

  2. Clique no nome do MIG em que você quer interromper as VMs. A página Visão geral é exibida.

  3. Na lista Instâncias de VM, selecione todas as VMs que você quer interromper e clique em Interromper. Se não houver a opção Parar, clique em Mais ações e selecione Parar.

  4. Na caixa de diálogo exibida, execute as ações a seguir:

    1. Opcional: para interromper VMs sem usar o encerramento completo ou para encerrar um encerramento completo em andamento, marque a caixa de seleção Ignorar encerramento completo (se aplicável).

    2. Para confirmar, clique em Interromper.

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.

Se você quiser pular ou encerrar um encerramento completo, use o mesmo comando com a flag --no-graceful-shutdown:

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

REST

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.s3nsapis.fr/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".

Se você quiser pular ou encerrar um encerramento completo, inclua o parâmetro de consulta noGracefulShutdown definido como true no URL da solicitação:

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/stopInstances?noGracefulShutdown=true

{
    "instances": [
      "INSTANCE_NAME_URL"
    ]
}

Iniciar VMs selecionadas em um MIG

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

Console

  1. No console, do Cloud de Confiance , 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 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.s3nsapis.fr/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