Simular um evento de manutenção de host

Nesta página, descrevemos como testar os efeitos da política de manutenção de host da instância do Compute Engine nos aplicativos.

É possível simular um evento de manutenção nas VMs para testar o seguinte:

  • Os efeitos da migração em tempo real nos seus aplicativos.
  • Como seus aplicativos e jobs em lote lidam com a preempção e o desligamento ao usar uma ou mais VMs spot.
  • Como os aplicativos processam o encerramento e a reinicialização de instâncias configuradas para serem encerradas e reiniciadas durante eventos de manutenção, em vez de serem migradas em tempo real.
  • Como as cargas de trabalho em execução nos nós de locatário individual se comportam durante um evento de manutenção de host e ver os efeitos da política de manutenção de host da VM de locatário individual nos aplicativos em execução nas VMs.

Se você tentar simular um evento de manutenção do host em uma instância que não é compatível com a migração em tempo real, ela será encerrada ou reiniciada, dependendo da política de manutenção do host configurada.

Antes de começar

  • Revise o limite de taxa da API regional para SimulateMaintenanceEventRequestsPerMinutePerProjectPerRegion.
  • 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:

    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 a CLI gcloud.

          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 .

Limitações

  • Para simular corretamente um evento de manutenção em um grupo nó de locatário individual com uma política de manutenção de host definida como migrar dentro do grupo de nós, é necessário acionar o evento de manutenção sequencialmente em cada nó.
  • Para um grupo nó de locatário individual, quando você tenta simular um evento de manutenção do host e o grupo de nós tem uma política de manutenção do host definida para migrar dentro do grupo de nós:
    • Se o número de nós especificado for menor ou igual ao número total de nós de restrição reservados, a simulação do evento de manutenção do host será executada para todos os nós especificados simultaneamente.
    • Se o número de nós especificado for maior que o número total de nós de restrição reservados, a simulação vai falhar.
  • O número de simulações de eventos de manutenção que você pode iniciar por minuto e por região é limitado pelo limite de taxa da API para a métrica simulate_maintenance_event_requests_per_region.

Simular eventos de manutenção de host para testar a migração em tempo real

É possível simular um evento de manutenção para uma instância de computação usando a Google Cloud CLI ou uma solicitação de API. Esse evento simulado inclui as diferentes atividades de manutenção que ocorrem em um evento regular. Isso permite observar o processo de ponta a ponta e testar qualquer automação que você tenha implementado.

Durante a simulação do evento de manutenção do host para uma instância que usa migração dinâmica, a chave de metadados maintenance-event da instância passa pelas seguintes mudanças:

  1. No início da simulação, o valor da chave de metadados maintenance-event muda de NONE para MIGRATE_ON_HOST_MAINTENANCE.
  2. Durante a simulação do evento, o valor permanece como MIGRATE_ON_HOST_MAINTENANCE.
  3. Depois que a simulação terminar, o valor retornará para NONE.

Para consultar a chave de evento de manutenção, consulte Consultar a chave de metadados do evento de manutenção.

gcloud

Use o comando compute instances simulate-maintenance-event para simular um evento de manutenção em uma instância e testar as configurações da política de manutenção do host configurada:

gcloud compute instances simulate-maintenance-event INSTANCE_NAME \
    --zone=ZONE --with-extended-notifications=True

Substitua:

  • INSTANCE_NAME: o nome da instância de computação em que você quer simular o evento de manutenção.

    É possível especificar vários nomes de instância separados por espaços únicos para simular eventos de manutenção em mais de uma instância da mesma zona. Por exemplo, instance-1 instance-2 instance-3.

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

REST

Crie uma solicitação POST para o método compute.instances.simulateMaintenanceEvent:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/simulateMaintenanceEvent

Substitua:

  • PROJECT_ID: o ID do projeto desta solicitação;
  • INSTANCE_NAME: o nome da instância para a qual você quer simular o evento de manutenção.
  • ZONE: a zona em que a instância está localizada.

Simular a manutenção do host para instâncias de computação que são encerradas

É possível simular um evento de manutenção para uma instância de computação usando a Google Cloud CLI ou uma solicitação de API. Esse evento simulado inclui as diferentes atividades de manutenção que ocorrem em um evento regular. Isso permite observar o processo de ponta a ponta e testar qualquer automação que você tenha implementado.

Além disso, usando o parâmetro --with-extended-notifications com um tipo de máquina compatível é possível testar o início manual da manutenção do host durante o evento simulado.

gcloud

  1. Use o comando compute instances simulate-maintenance-event para simular um evento de manutenção em uma instância e testar as configurações de política de manutenção do host configuradas. Também é possível incluir a flag --with-extended-notifications.

    gcloud compute instances simulate-maintenance-event INSTANCE_NAME \
   --zone=ZONE --with-extended-notifications=True

    Substitua:

    • INSTANCE_NAME: o nome da instância de computação em que você quer simular o evento de manutenção.

      É possível especificar vários nomes de instância separados por espaços únicos para simular eventos de manutenção em mais de uma instância da mesma zona. Por exemplo, instance-1 instance-2 instance-3.

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

  2. Opcional: para iniciar manualmente o evento de manutenção simulado, use o comando compute instances perform-maintenance.

    gcloud compute instances perform-maintenance INSTANCE_NAME \
   --zone=ZONE

    Substitua:

    • INSTANCE_NAME: o nome da instância de computação em que você quer simular o evento de manutenção.

      É possível especificar vários nomes de instância separados por espaços únicos para simular eventos de manutenção em mais de uma instância da mesma zona. Por exemplo, instance-1 instance-2 instance-3

    • ZONE: a zona em que as instâncias estão localizadas.

REST

  1. Crie uma solicitação POST para o método compute.instances.simulateMaintenanceEvent. Também é possível incluir o parâmetro de consulta withExtendedNotifications.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/simulateMaintenanceEvent?withExtendedNotifications=True

    Substitua:

    • PROJECT_ID: o ID do projeto desta solicitação;
    • INSTANCE_NAME: o nome da instância para a qual você quer simular o evento de manutenção.
    • ZONE: a zona em que a instância está localizada.

  2. Opcional: para iniciar manualmente o evento de manutenção simulado, crie uma solicitação POST para o método compute.instances.performMaintenance.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/performMaintenance

    Substitua:

    • INSTANCE_NAME: o nome da instância de computação em que você quer iniciar o evento de manutenção.

      É possível especificar vários nomes de instância separados por espaços únicos para realizar eventos de manutenção em mais de uma instância na mesma zona. Por exemplo, instance-1 instance-2 instance-3

    • ZONE: a zona em que as instâncias estão localizadas.

Simular eventos de manutenção de host em nós de locatário individual

É possível simular um evento de manutenção de host em nós de locatário individual usando a Google Cloud CLI ou uma solicitação de API. Durante a simulação do evento de manutenção de host em uma VM de locatário único, o valor da chave de metadados maintenance-event não muda e permanece NONE durante toda a simulação.

gcloud

Execute o comando sole-tenancy node-groups simulate-maintenance-event para forçar os nós de locatário individual a ativar a política de manutenção configurada:

 gcloud compute sole-tenancy node-groups simulate-maintenance-event NODE_GROUP \
    --nodes=NODE_NAMES \
    --zone=ZONE \
    --async

Substitua:

  • NODE_GROUP: o nome do grupo de nós em que você quer simular o evento de manutenção.

  • NODE_NAMES: os nomes dos nós em que você quer simular o evento de manutenção. Ao especificar vários nomes de nós, use valores separados por vírgula, por exemplo, node-1,node-2,node-3.

  • ZONE: a zona em que os nós estão localizados.

REST

Crie uma solicitação POST para o método compute.nodeGroups.simulateMaintenanceEvent:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups/NODE_GROUP/simulateMaintenanceEvent

{
  "nodes": [
      "NODE_NAMES"
  ]
}

Substitua:

  • PROJECT_ID: o ID do projeto desta solicitação;
  • ZONE: a zona em que os nós estão localizados.
  • NODE_GROUP: o nome do grupo de nós em que você quer simular o evento de manutenção.
  • NODE_NAMES: os nomes dos nós em que você quer simular o evento de manutenção. Coloque o nome do nó entre aspas duplas, por exemplo, "node-1". E, ao especificar vários nomes de nós, use valores separados por vírgula, por exemplo, "node-1","node-2","node-3".

A seguir