Desativar o desligamento suave em uma instância do Compute Engine

Este documento explica como desativar o desligamento suave em uma instância do Compute Engine. Para saber mais sobre o desligamento suave, incluindo como ignorar o desligamento suave para operações de parada ou exclusão individuais, consulte Visão geral do desligamento suave.

Se você tiver ativado o desligamento suave em uma instância, poderá desativá-lo para fazer o seguinte:

  • Acelere as operações de interrupção ou exclusão para evitar cobranças desnecessárias.

  • Atualize as propriedades da instância que exigem uma reinicialização.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    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.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

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

Funções exigidas

Para receber a permissão necessária para desativar o desligamento suave em uma instância de computação, peça ao administrador para conceder a você o papel do IAM de Administrador da instância da computação (v1) (roles/compute.instanceAdmin.v1) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a permissão compute.instances.update on the instance, que é necessária para desativar o desligamento suave em uma instância de computação.

Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.

Desativar o desligamento normal em uma instância

É possível desativar o desligamento suave em uma instância de computação sem reiniciar a instância. No entanto, não é possível desativar o encerramento otimizado enquanto a instância está no processo de encerramento otimizado (PENDING_STOP).

Para desativar o desligamento suave em uma instância, selecione uma das seguintes opções:

Console

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

    Acessar instâncias de VM

  2. Na coluna Nome, clique no nome da instância para conferir os detalhes dela.

    A página de detalhes da instância é aberta e a guia Detalhes é selecionada.

  3. Clique em Editar.

  4. Na seção Gerenciamento, desmarque a caixa de seleção Desligar a VM normalmente.

  5. Clique em Salvar.

gcloud

Para desativar o encerramento suave em uma instância, use o comando gcloud beta compute instances update com a flag --no-graceful-shutdown:

gcloud beta compute instances update INSTANCE_NAME \
    --no-graceful-shutdown \
    --zone=ZONE

Substitua:

  • INSTANCE_NAME: o nome da instância.

  • ZONE: a zona em que a instância está localizada.

REST

  1. Crie um arquivo JSON vazio.

  2. Para conferir as propriedades de uma instância, faça uma solicitação GET para o método instances.get beta:

    GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

    Substitua:

    • PROJECT_ID: o ID do projeto em que a instância está localizada.

    • ZONE: a zona em que a instância está localizada.

    • INSTANCE_NAME: o nome de uma instância

  3. No arquivo JSON vazio que você criou nas etapas anteriores, faça o seguinte:

    1. Insira as propriedades da instância da saída da solicitação GET.

    2. Localize o campo gracefulShutdown.enabled e mude o valor dele para false:

      {
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      "enabled": false
    }
  },
  ...
}

  4. Para atualizar a instância, faça uma solicitação PUT para o método instances.update Beta. Inclua o seguinte:

    • No URL da solicitação, inclua o parâmetro de consulta mostDisruptiveAllowedAction.

    • No corpo da solicitação, inclua as propriedades da instância do arquivo JSON criado e atualizado nas etapas anteriores.

    A solicitação PUT para atualizar a instância é semelhante a esta:

    PUT https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=ALLOWED_ACTION

{
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      "enabled": false
    }
  },
  ...
}

    Substitua ALLOWED_ACTION por um dos seguintes valores:

    • NO_EFFECT: a solicitação verifica se a solicitação de atualização é válida e se os recursos estão disponíveis, mas não atualiza a instância.

    • REFRESH: se as propriedades da instância modificada não exigirem a reinicialização da instância, o Compute Engine vai atualizar a instância.

Para mais informações sobre como atualizar as propriedades de uma instância, consulte Atualizar propriedades da instância.

A seguir