Habilite o controle de manutenção avançado para nós de locatário individual

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

O controle de manutenção avançado para locatário individual permite controlar eventos de manutenção planejados para grupos de nós de locatário individual e minimizar interrupções relacionadas à manutenção. Esse recurso está disponível apenas para grupos de nós de locatário individual. Para usar esse recurso com suas máquinas virtuais existentes, você deve primeiro mover suas VMs para grupos de nós de locatário individual que tenham o controle de manutenção avançado habilitado.

O recurso de controle de manutenção avançado para locatário individual permite:

• Verifique se há eventos de manutenção agendados para um nó de locatário individual com 28 dias de antecedência.
• Acione a manutenção imediatamente ou agende-a para mais tarde. Observe que se você acionar a manutenção imediatamente, ela ocorrerá dentro de 6 horas a partir do momento em que você acionou a solicitação.

Veja a seguir o processo para criar um grupo de nós de locatário individual com controle de manutenção avançado:

1. Opte pelo controle de manutenção avançado em grupos de nós de locatário individual compatíveis. Esse recurso está disponível apenas para grupos de nós de locatário individual. Para usar esse recurso com suas VMs existentes ou cargas de trabalho de locatário individual, você deve primeiro mover suas VMs para grupos de nós de locatário individual com controle de manutenção avançado habilitado.

2. Verifique se há manutenções futuras para seus nós de locatário individual. A manutenção de um nó de locatário individual ocorre no máximo a cada 28 dias. Você pode verificar o evento de manutenção de um nó 28 dias antes do início da janela de manutenção de 6 horas na qual a manutenção está programada para esse nó.

3. Se a manutenção estiver agendada para um nó de locatário individual e antes do início da janela de manutenção programada, você poderá:

   • Acione a manutenção imediatamente ou agende-a para mais tarde . Se você optar por acionar a manutenção imediatamente, a manutenção ocorrerá dentro de 6 horas a partir do momento em que você acionou a solicitação. Observe que a data e hora programadas escolhidas devem ser anteriores à hora de início da janela de manutenção inicial.

   • Se você não acionar a manutenção imediatamente ou agendá-la para mais tarde, a manutenção ocorrerá dentro do prazo fornecido na janela de manutenção inicial.

Você pode optar por dimensionar automaticamente grupos de nós de locatário individual com controle de manutenção avançado habilitado. Os logs de auditoria são gerados em todos os casos.

Famílias de máquinas suportadas

O controle de manutenção avançado para nós de locatário individual é compatível com as famílias de máquinas C2, C3, C3D, C4, G2, H3, M1, M2 e M3 em Disponibilidade Geral .

Limitações

A seguir estão as limitações do recurso de controle de manutenção avançado para locatário individual:

• SSDs e GPUs locais: SSDs e GPUs locais não são suportados por este recurso.
• Políticas de manutenção : este recurso oferece suporte à política de manutenção padrão (migração ao vivo). Outras políticas de manutenção, como reiniciar no local e migrar dentro do grupo de nós, não são suportadas.
• Nós: esse recurso pode suportar no máximo 20 nós por projeto, por zona.
• Controle de manutenção avançado para grupos de nós de locatário individual existentes: você não pode aceitar grupos de nós de locatário individual existentes para controle de manutenção avançado. Se quiser executar suas cargas de trabalho existentes em grupos de nós de locatário individual com controle de manutenção avançado habilitado, você deverá primeiro criar um novo grupo de nós com controle de manutenção avançado habilitado e depois migrar sua carga de trabalho para esse grupo. Da mesma forma, para cancelar o controle de manutenção avançado, você deve migrar seus nós de locatário individual para grupos de nós de locatário individual que não tenham o controle de manutenção avançado habilitado.
• Impacto nas políticas de manutenção atuais: quando você aceita esse recurso, ele substitui quaisquer janelas de manutenção existentes associadas aos nós de locatário individual.

Custos

Não há custo adicional para usar o controle de manutenção avançado em nós de locatário individual.

Antes de começar

• Antes de provisionar VMs em um nó de locatário individual, verifique sua cota . Dependendo do número e do tamanho dos nós reservados, talvez seja necessário solicitar uma cota adicional .
• 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.

  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.

Habilite o controle de manutenção avançado em um nó de locatário individual

O controle de manutenção avançado para locatário individual é um recurso opcional e está disponível apenas para grupos de nós de locatário individual. Para usar esse recurso com suas VMs existentes ou cargas de trabalho de locatário individual, você deve primeiro mover suas VMs para grupos de nós de locatário individual com controle de manutenção avançado habilitado.

gcloud compute sole-tenancy node-groups create NODE_GROUP_NAME \
--node-template=NODE_TEMPLATE_NAME \
--zone=NODE_GROUP_ZONE \
--target-size=NODE_GROUP_SIZE \
--maintenance-interval=RECURRENT

POST https://compute.googleapis.com/compute/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups
{
"name": "NODE_GROUP_NAME",
"nodeTemplate": "NODE_TEMPLATE_URL",
"zone": "NODE_GROUP_ZONE",
"size": "NODE_GROUP_SIZE",
"maintenanceInterval": "RECURRENT"
}

Verifique a próxima manutenção

A manutenção de um nó de locatário individual ocorre no máximo a cada 28 dias. Você pode verificar o evento de manutenção de um nó 28 dias antes do início da janela de manutenção de 6 horas, na qual a manutenção está programada para esse nó.

gcloud compute sole-tenancy node-groups list-nodes NODE_GROUP_NAME \
--format "table(name, status, node_type, instances, server_id, upcoming_maintenance)"

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/listNodes

{
  …
  "items": [
    …
    {
      "name": string,
      "status": string,
      …
      "upcomingMaintenance": {
        "canReschedule": boolean,
        "maintenanceType": enum, // SCHEDULED | UNSCHEDULED
        "windowStartTime": string, // RFC 3339 timestamp string
        "windowEndTime": string, // RFC 3339 timestamp string
        "latestWindowStartTime": string, // RFC 3339 timestamp string
        "maintenanceStatus": enum // PENDING | ONGOING
      },
      …
    },
    …
  ],
  …
}

Se você não vir nenhum evento de manutenção, significa que não há manutenção futura para nenhum nó do grupo de nós.

Acione a manutenção imediatamente ou agende a manutenção de um nó

Depois de saber quais nós de um grupo de nós de locatário individual estão programados para manutenção, você poderá executar um dos seguintes procedimentos:

• Acione a manutenção imediatamente. Se você optar por acionar a manutenção imediatamente, a manutenção ocorrerá dentro de 6 horas a partir do momento em que você acionou a solicitação.

• Agende a manutenção para mais tarde com base em suas necessidades.

Se você não acionar a manutenção imediatamente ou agendá-la para uma data e hora posteriores, a manutenção ocorrerá dentro da janela de manutenção inicial. Depois que a manutenção de um nó for iniciada, você não poderá pausá-la ou reprogramá-la.

gcloud compute sole-tenancy node-groups perform-maintenance NODE_GROUP_NAME \
--zone=NODE_GROUP_ZONE \
--nodes=NODE_NAMES \
--window-start-time=WINDOW_START_TIME

POST
https://compute.googleapis.com/compute/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/performMaintenance
{
"nodes": "NODE_NAMES" // [Required] The user needs to list at least 1 node
"windowStartTime":  "WINDOW_START_TIME" // [Optional] RFC 3339 timestamp string
}

O campo Status de manutenção de um nó exibe o seguinte status durante o processo de manutenção:

• Pendente: A operação de manutenção ainda não foi iniciada, mas está agendada.
• Em andamento : A janela de manutenção foi iniciada. O evento de manutenção permanece em andamento até que a manutenção do nó seja concluída com êxito.

Verifique se a manutenção foi concluída

Para consultar o status de manutenção de um nó com controle de manutenção avançado, use o comando gcloud compute sole-tenancy node-groups list-nodes ou o método nodeGroups.listNodes .

Para obter mais informações, consulte verificar o status de manutenção .

• A manutenção foi bem-sucedida: se a manutenção de um nó de locatário individual for bem-sucedida, a notificação de manutenção será removida. Ao consultar o nome do grupo de nós, a seção upcomingMaintenance não estará mais presente para o nó.
• A manutenção falhou: se a manutenção não for concluída no intervalo de 6 horas, o evento de manutenção permanecerá em andamento até que a manutenção seja concluída com êxito para o nó. Após a conclusão bem-sucedida, a notificação de manutenção será removida.

Às vezes, a solicitação de acionamento de manutenção para a data e hora de sua escolha pode ser rejeitada se Google Cloud os limites internos do controle de manutenção avançado para nós de locatário individual foram excedidos na data e hora especificadas. Neste caso, deve-se selecionar outra data e horário para a manutenção do nó. O status de manutenção deste nó é Contínuo e permanece assim até que a manutenção seja concluída com êxito.

Alterar data e hora da manutenção programada

Você pode modificar a data e hora da manutenção programada para um nó de locatário individual usando o mesmo procedimento usado para acionar ou programar a manutenção de um nó .