Janela de manutenção

Nesta página, explicamos como configurar janelas de manutenção para os clusters do Kubernetes Engine.

Visão geral

Uma janela de manutenção é um período de quatro horas que você escolhe para realização dos upgrades automáticos. A criação de uma janela de manutenção instrui o GKE a acionar imediatamente os upgrades de mestre automatizados, as rotações de IP e os upgrades do pool de nós, durante o período escolhido. Por exemplo, se você criar uma janela de manutenção a partir das 16h, a janela durará até as 20h.

Os upgrades podem ocorrer em qualquer dia da semana e a qualquer momento dentro do período. As janelas de manutenção fornecem mais controle sobre quando os upgrades do software Kubernetes no cluster ou nos nós ocorrem.

O GKE faz o upgrade automático do seu mestre de cluster. Se os upgrades automáticos do nó estiverem ativados, os nós com a versão mais recente do Kubernetes também serão atualizados. Se as tarefas forem executadas além da janela de manutenção, o GKE tentará interromper a operação. Uma operação interrompida começa novamente durante a próxima janela de manutenção.

Esses upgrades automáticos ocorrem periodicamente sem a intervenção do usuário. Porém, isso pode causar breves períodos de inatividade dos nós mestres e/ou individuais. No entanto, em alguns cenários, talvez convenha ter mais controle sobre quando esses upgrades ocorrem. Exemplo:

  • Fora dos horários de pico: minimize a chance de inatividade programando os upgrades automáticos fora dos horários de pico, quando o tráfego é reduzido.
  • Em serviço: garanta que os upgrades aconteçam durante as horas de trabalho para que alguém possa monitorá-los e gerenciar problemas imprevistos.
  • Upgrades de vários clusters: implemente upgrades em vários clusters em diferentes regiões, uma de cada vez, em intervalos especificados.

O GKE também pode optar por não realizar upgrades durante a janela especificada. Os upgrades planejados ou futuros geralmente são anunciados na página de notas da versão.

O GKE se reserva o direito de lançar upgrades de emergência não planejados fora das janelas de manutenção. Além disso, os upgrades obrigatórios de software obsoleto ou desatualizado podem ocorrer automaticamente fora das janelas de manutenção.

Advertências

Quando você faz alterações nos seus nós que exigem que os nós sejam recriados, como quando você ativa políticas de rede, seus nós podem não ser recriados até a próxima janela de manutenção, causando um atraso que é percebido. Se preferir não esperar, você pode atualizar manualmente seu cluster a qualquer momento.

Antes de começar

Prepare-se para a tarefa tomando as seguintes medidas:

  • Verifique se você ativou a API Google Kubernetes Engine.
  • Ativar a API Google Kubernetes Engine
  • Verifique se o SDK do Cloud está instalado.
  • Defina o código do projeto padrão:
    gcloud config set project [PROJECT_ID]
  • Se você estiver trabalhando com clusters zonais, defina a zona de computação padrão:
    gcloud config set compute/zone [COMPUTE_ZONE]
  • Se você estiver trabalhando com clusters regionais, defina a região de computação padrão:
    gcloud config set compute/region [COMPUTE_REGION]
  • Atualize a gcloud para a versão mais recente:
    gcloud components update

Como configurar uma janela de manutenção no cluster

Veja nas seções a seguir como configurar as janelas de manutenção.

Para criar uma janela de manutenção, você precisa especificar um horário para iniciar os upgrades automáticos no mestre. Se o upgrade automático de nós estiver ativado, será necessário especificar os nós.

Como criar um cluster com uma janela de manutenção

gcloud

Para criar um novo cluster com uma janela de manutenção, use o comando gcloud container clusters create e inclua a sinalização --maintenance-window:

gcloud container clusters create [CLUSTER_NAME] --maintenance-window [HH:MM]

Por exemplo, o comando a seguir cria um cluster chamado my-cluster com uma janela de manutenção para as 2h:

gcloud container clusters create my-cluster --maintenance-window 2:00

Console

Para criar um novo cluster com uma janela de manutenção, siga as etapas a seguir:

  1. Acesse o menu do Google Kubernetes Engine no console do GCP.

    Acessar o menu do Google Kubernetes Engine

  2. Clique em Criar cluster.

  3. Escolha Cluster padrão ou um modelo apropriado para sua carga de trabalho. Se você escolher o modelo Altamente disponível, um cluster regional será criado com uma janela de manutenção padrão.

  4. Configure o cluster como quiser.

  5. Para personalizar a janela de manutenção ou se você usou um modelo de criação de cluster que não inclui uma janela de manutenção por padrão, clique em Opções avançadas. Em seguida, no menu suspenso Janela de manutenção, selecione o horário desejado.

  6. Clique em Criar

Como configurar uma janela de manutenção de um cluster existente

gcloud

Para criar ou modificar uma janela de manutenção de um cluster atual, use o comando gcloud container clusters update e inclua a sinalização --maintenance-window:

gcloud container clusters update [CLUSTER_NAME] --maintenance-window [HH:MM]

Por exemplo, o comando a seguir muda a janela de manutenção em my-cluster para as 16h:

gcloud container clusters update my-cluster --maintenance-window 16:00

Console

Para criar ou modificar uma janela de manutenção de um cluster existente:

  1. Acesse o menu do Google Kubernetes Engine no console do GCP.

    Acessar o menu do Google Kubernetes Engine

  2. Clique no botão "Editar" do cluster, que se parece com um lápis.

  3. No menu suspenso Janela de manutenção, selecione o horário que você quer.

  4. Clique em Salvar.

Como remover uma janela de manutenção

gcloud

Para remover uma janela de manutenção, defina o valor da sinalização --maintenance-window como None:

gcloud container clusters update [CLUSTER_NAME] --maintenance-window None

Console

Para remover uma janela de manutenção:

  1. Acesse o menu do Google Kubernetes Engine no console do GCP.

    Acessar o menu do Google Kubernetes Engine

  2. Clique no botão "Editar" do cluster, que se parece com um lápis.

  3. No menu suspenso Janela de manutenção, selecione A qualquer momento.

  4. Clique em Salvar.

Como cancelar um upgrade

Nos raros casos em que os upgrades levam mais de quatro horas para serem concluídos, o Kubernetes Engine tenta interromper os upgrades contínuos e retomá-los durante a próxima janela de manutenção. Se um upgrade automático for cancelado e você tiver ativado o upgrade automático de nós, os nós poderão ficar em um estado de versão mista. No entanto, o cluster funcionará normalmente.

Se você quiser cancelar manualmente, reverter ou fazer upgrade manual do cluster, consulte Como fazer upgrade de um cluster de contêiner.

Próximas etapas

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Kubernetes Engine