Ative o controlo de manutenção avançado para nós de inquilino único

O controlo de manutenção avançado para a posse exclusiva permite-lhe controlar eventos de manutenção planeados para grupos de nós de posse exclusiva e minimizar as interrupções relacionadas com a manutenção. Esta funcionalidade só está disponível para grupos de nós de inquilino único. Para usar esta funcionalidade com as suas máquinas virtuais existentes, primeiro tem de mover as VMs para grupos de nós de inquilino único com o controlo de manutenção avançado ativado.

O controlo de manutenção avançado para a funcionalidade de posse exclusiva permite-lhe:

  • Verifique se existem eventos de manutenção agendados para um nó de inquilino único com 28 dias de antecedência.
  • Acionar a manutenção imediatamente ou agendá-la para mais tarde. Tenha em atenção que, se acionar a manutenção imediatamente, esta ocorre no prazo de 6 horas a partir do momento em que aciona o pedido.

Segue-se o processo de criação de um grupo de nós de inquilino único com controlo de manutenção avançado:

  1. Ative o controlo de manutenção avançado em grupos de nós de inquilino único compatíveis. Esta funcionalidade só está disponível para grupos de nós de inquilino único. Para usar esta funcionalidade com as suas VMs ou cargas de trabalho de inquilino único existentes, tem de mover primeiro as VMs para grupos de nós de inquilino único com o controlo de manutenção avançado ativado.

  2. Verifique se existe manutenção pendente para os seus nós de inquilino único. A manutenção de um nó de inquilino único ocorre, no máximo, a cada 28 dias. Pode verificar o evento de manutenção de um nó 28 dias antes do início do período de manutenção de 6 horas em que a manutenção está agendada para esse nó.

  3. Se a manutenção estiver agendada para um nó de inquilino único e, antes do início do período de manutenção agendado, pode:

    • Acionar a manutenção imediatamente ou agendá-la para mais tarde. Se optar por acionar a manutenção imediatamente, esta é realizada no prazo de 6 horas a partir do momento em que aciona o pedido. Tenha em atenção que a data e a hora agendadas que escolher têm de ser anteriores à hora de início do período de manutenção inicial.

    • Se não acionar a manutenção imediatamente nem a agendar para mais tarde, a manutenção ocorre dentro do período indicado na janela de manutenção inicial.

Pode optar por dimensionar automaticamente os grupos de nós de inquilino único com o controlo de manutenção avançado ativado. Os registos de auditoria são gerados em todos os casos.

Famílias de máquinas suportadas

O controlo de manutenção avançado para nós de inquilino único é suportado para as famílias de máquinas C2, C3, C3D, C4, G2, H3, M1, M2, M3 e M4 na disponibilidade geral.

Limitações

Seguem-se as limitações do controlo de manutenção avançado para a funcionalidade de posse exclusiva:

  • SSDs e GPUs locais: os SSDs e as GPUs locais não são suportados por esta funcionalidade.
  • Políticas de manutenção: esta funcionalidade suporta a política de manutenção predefinida (migração em direto). Outras políticas de manutenção, como o reinício no local e a migração no grupo de nós, não são suportadas.
  • Nós: esta funcionalidade pode suportar um máximo de 20 nós por projeto, por zona.
  • Controlo de manutenção avançado para grupos de nós de inquilino único existentes: não pode ativar o controlo de manutenção avançado para grupos de nós de inquilino único existentes. Se quiser executar as suas cargas de trabalho existentes em grupos de nós de inquilino único com o controlo de manutenção avançado ativado, primeiro tem de criar um novo grupo de nós com o controlo de manutenção avançado ativado e, em seguida, migrar a sua carga de trabalho para este grupo. Da mesma forma, para desativar o controlo de manutenção avançado, tem de migrar os seus nós de inquilino único para grupos de nós de inquilino único que não tenham o controlo de manutenção avançado ativado.
  • Impacto nas políticas de manutenção atuais: quando ativa esta funcionalidade, substitui todos os intervalos de manutenção existentes associados aos nós de inquilino único.

Custos

Não existe um custo adicional para usar o controlo de manutenção avançado em nós de inquilino único.

Antes de começar

  • Antes de aprovisionar VMs num nó de inquilino único, verifique a sua quota. Consoante o número e o tamanho dos nós que reservar, pode ter de pedir quota adicional.

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-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. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

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

Ative o controlo de manutenção avançado num nó de inquilino único

O controlo de manutenção avançado para a posse exclusiva é uma funcionalidade opcional e está disponível apenas para grupos de nós de posse exclusiva. Para usar esta funcionalidade com as suas VMs existentes ou cargas de trabalho de inquilino único, primeiro tem de mover as VMs para grupos de nós de inquilino único com o controlo de manutenção avançado ativado.

Consola

Pode ativar o controlo de manutenção avançado quando cria um grupo de nós selecionando a opção Ativar manutenção avançada de inquilino único na secção Configurar definições de manutenção. Para mais informações, consulte o artigo Crie um grupo de nós de inquilino único.

gcloud

Para criar um grupo de nós de inquilino único com controlo de manutenção avançado, use o comando gcloud compute sole-tenancy node-groups create.

A flag --maintenance-interval=RECURRENT no comando seguinte especifica que o nó de inquilino único está ativado para o controlo de manutenção avançado.

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

Substitua o seguinte:

  • NODE_GROUP_NAME: o nome do grupo de nós.

  • NODE_TEMPLATE_NAME: o nome do modelo de nó a usar para criar este grupo.

  • NODE_GROUP_SIZE: o número de nós a criar no grupo.

  • NODE_GROUP_ZONE: a zona onde criar o grupo de nós. Tem de ser a mesma região que o modelo de nó no qual está a basear o grupo de nós.

REST

Para criar um grupo de nós de inquilino único com controlo de manutenção avançado com base num modelo de nó criado anteriormente, use o método nodeGroups.insert.

Para criar um grupo de nós de inquilino único com base num modelo de nó criado anteriormente para todos os outros nós, use o método nodeGroups.insert.

O parâmetro maintenanceInterval no comando seguinte especifica que o nó de inquilino único está ativado para o controlo de manutenção avançada.

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"
}

Substitua o seguinte:

  • PROJECT_ID: o nome do projeto no qual o grupo de nós existe.

  • NODE_GROUP_ZONE: a zona do grupo de nós.

  • NODE_GROUP_NAME: o nome do grupo de nós.

  • NODE_TEMPLATE_URL: o URL do modelo de nó a usar para criar este grupo.

  • NODE_GROUP_SIZE: o número de nós a criar no grupo.

O flag ao nível do nó substitui quaisquer flags de VMs atribuídos anteriormente. Por conseguinte, a ativação do controlo de manutenção avançado substitui quaisquer flags de manutenção anteriores.

Verifique se existe manutenção futura

A manutenção de um nó de inquilino único ocorre, no máximo, a cada 28 dias. Pode verificar o evento de manutenção de um nó 28 dias antes do início do período de manutenção de 6 horas, no qual a manutenção está agendada para esse nó.

Consola

Depois de ativar um grupo de nós de inquilino único para o controlo avançado da manutenção, vai ver os eventos de manutenção futuros da seguinte forma:

  1. Na Google Cloud consola, aceda à página Nós de inquilino único.

    Aceda a Nós de inquilino único

  2. Clique em Grupos de nós para ver uma lista de grupos de nós de inquilino único.

  3. Para qualquer grupo de nós de inquilino único, pode ver as colunas Estado de manutenção e Hora de manutenção na tabela para a manutenção futura. Uma vez que a manutenção é definida ao nível do nó, as informações de manutenção que vê aqui são as próximas manutenções agendadas para qualquer um dos nós no grupo de nós.

  4. Para ver informações de manutenção de cada nó num grupo de nós de inquilino único, clique no Nome do grupo de nós para abrir a página de detalhes. Para cada nó no grupo de nós, as colunas Estado de manutenção e Hora de manutenção na tabela apresentam informações sobre a manutenção futura.

gcloud

Para listar os nós de um grupo de nós de inquilino único com controlo de manutenção avançado, juntamente com as respetivas informações de manutenção, use o comando gcloud compute sole-tenancy node-groups list-nodes.

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

Substitua NODE_GROUP_NAME pelo nome do grupo de nós.

REST

Para listar os nós de um grupo de nós de inquilino único com controlo de manutenção avançado, juntamente com as respetivas informações de manutenção, use o método nodeGroups.listNodes.

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

Substitua o seguinte:

  • PROJECT_ID: o nome do projeto no qual o grupo de nós existe.

  • NODE_GROUP_ZONE: a zona do grupo de nós.

  • NODE_GROUP_ID: o ID do grupo de nós.

Segue-se a resposta do método nodeGroups.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
      },
      …
    },
    …
  ],
  …
}

Seguem-se os detalhes do evento de manutenção do grupo de nós:

Nome do parâmetro Descrição
windowStartTime Hora de início do período de manutenção.
windowEndTime Hora de fim do período de manutenção.
latestWindowStartTime Hora de início do período de manutenção inicial. Pode optar por acionar a manutenção imediatamente ou agendá-la para uma data e hora posteriores apenas antes de latestWindowStartTime.
maintenanceType O tipo de manutenção que vai ser realizada:
- Agendada: a manutenção está agendada para este nó.
- Não agendada: a manutenção representa atualizações críticas para as quais é dado um aviso com muito menos antecedência.
canReschedule Se a manutenção pode ser reagendada.
maintenanceStatus O estado da operação de manutenção atual:
- Pendente: a operação de manutenção ainda não começou, mas está agendada.
- Em curso: o período de manutenção foi iniciado.

Se não vir nenhum evento de manutenção, significa que não existe nenhuma manutenção futura para nenhum nó no grupo de nós.

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

Depois de saber que nós num grupo de nós de inquilino único estão agendados para manutenção, pode fazer uma das seguintes ações:

  • Acionar a manutenção imediatamente. Se optar por acionar a manutenção imediatamente, esta ocorre no prazo de 6 horas a partir do momento em que aciona o pedido.

  • Agende a manutenção para mais tarde com base nos seus requisitos.

Se não acionar a manutenção imediatamente nem a agendar para uma data e hora posteriores, a manutenção ocorre no período de manutenção inicial. Assim que a manutenção de um nó começar, não pode pausá-la nem reagendá-la.

Consola

Para acionar imediatamente a manutenção de um nó, faça o seguinte:

  1. Na Google Cloud consola, aceda à página Nós de inquilino único.

    Aceda a Nós de inquilino único

  2. Clique em Grupos de nós.

  3. Clique no nome do grupo de nós para abrir a página de detalhes.

  4. Selecione o nó para o qual quer acionar a manutenção imediatamente e clique em Iniciar agora.

É apresentada uma mensagem de confirmação e a manutenção ocorre no prazo de 6 horas a partir do momento em que aciona o pedido.

Para agendar a manutenção de um nó, faça o seguinte:

  1. Na Google Cloud consola, aceda à página Nós de inquilino único.

    Aceda a Nós de inquilino único

  2. Clique em Grupos de nós para ver uma lista de grupos de nós de inquilino único.

  3. Clique no Nome do grupo de nós para abrir a página de detalhes.

  4. Selecione o nó para o qual quer agendar a manutenção e clique em Agendar manutenção.

  5. No painel Agendar manutenção apresentado, selecione uma data e uma hora à sua escolha para a manutenção. Tenha em atenção que pode agendar a manutenção de um nó em qualquer altura antes da hora de início do período de manutenção inicial.

É apresentada uma mensagem de confirmação e a manutenção é realizada no prazo de 6 horas a partir do momento em que o pedido é acionado.

gcloud

Para iniciar ou agendar a manutenção de um nó de inquilino único com controlo de manutenção avançado, use o comando gcloud compute sole-tenancy node-groups perform-maintenance .

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

Substitua o seguinte:

  • NODE_GROUP_NAME: o nome do grupo de nós.

  • NODE_GROUP_ZONE: a zona do grupo de nós.

  • NODE_NAMES: o nome do nó para o qual quer realizar a manutenção.

  • WINDOW_START_TIME: data e hora de início da manutenção. Se quiser que a manutenção comece assim que possível, omita esta flag.

REST

Use o método nodeGroups.performMaintenance para iniciar ou agendar a manutenção de um nó de inquilino único com controlo de manutenção avançado.

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
}

Substitua o seguinte:

  • PROJECT_ID: o nome do projeto no qual o grupo de nós existe.

  • NODE_GROUP_ZONE: a zona do grupo de nós.

  • NODE_GROUP_ID: o ID do grupo de nós.

  • NODE_NAMES: o nome do nó para o qual quer realizar a manutenção.

  • WINDOW_START_TIME: data e hora de início da manutenção. Omita este campo se quiser que a manutenção comece assim que possível.

O campo Estado de manutenção de um nó apresenta o seguinte estado durante o processo de manutenção:

  • Pendente: a operação de manutenção ainda não começou, mas está agendada.
  • Em curso: o período de manutenção foi iniciado. O evento de manutenção permanece Em curso até a manutenção ser concluída com êxito para o nó.

Verifique se a manutenção está concluída

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

Para mais informações, consulte o artigo verificar o estado de manutenção.

  • A manutenção é bem-sucedida: se a manutenção de um nó de inquilino único for bem-sucedida, a notificação de manutenção é removida. Quando consulta o nome do grupo de nós, a secção upcomingMaintenance deixa de estar presente para o nó.
  • A manutenção falhou: se a manutenção não for concluída no período de 6 horas, o evento de manutenção permanece Em curso até a manutenção ser concluída com êxito para o nó. Após a conclusão com êxito, a notificação de manutenção é removida.

Por vezes, o pedido de acionamento de manutenção para a data e a hora da sua escolha pode ser rejeitado se os Google Cloud limites internos de manutenção avançada para nós de inquilino único tiverem sido excedidos para a data e a hora especificadas. Neste caso, tem de selecionar outra data e hora para a manutenção do nó. O Estado de manutenção deste nó é Em curso e permanece assim até que a manutenção seja concluída com êxito.

Altere a data e a hora da manutenção agendada

Pode modificar a data e a hora da manutenção agendada de um nó de inquilino único através do mesmo procedimento que usa para acionar ou agendar a manutenção de um nó.