Colocar nós no modo de manutenção

Quando você precisar reparar ou manter os nós, primeiro coloque-os no modo de manutenção. Isso drena normalmente os pods e as cargas de trabalho atuais, excluindo os pods críticos do sistema, como o servidor da API. Ele também impede que o nó receba novas atribuições de pod. No modo de manutenção, é possível trabalhar nos nós sem o risco de interromper o tráfego do pod.

Como funciona

O GKE em Bare Metal oferece uma maneira de colocar os nós no modo de manutenção. Essa abordagem permite que outros componentes do cluster saibam corretamente que o nó está no modo de manutenção. Ao colocar um nó no modo de manutenção, nenhum pod adicional pode ser programado no nó, e os pods existentes são interrompidos.

Em vez de usar o modo de manutenção, é possível usar manualmente os comandos do Kubernetes, como kubectl cordon e kubectl drain, em um nó específico. Se você executar a versão 1.12.0 (anthosBareMetalVersion: 1.12.0) ou anterior do GKE em Bare Metal, consulte o problema conhecido em Nós não restritos se você não usar o procedimento do modo de manutenção

Quando você usa o processo do modo de manutenção, o GKE em Bare Metal faz o seguinte:

  • Os taints de nó são adicionados aos nós especificados para indicar que nenhum pod pode ser programado ou executado nos nós.

  • É aplicado um tempo limite de 20 minutos para garantir que os nós não fiquem travados aguardando o encerramento dos pods. Os pods não serão encerrados se estiverem configurados para tolerar todos os taints ou tiverem finalizadores. O GKE em Bare Metal tentam encerrar todos os pods, mas, se o tempo limite for excedido, o nó será colocado no modo de manutenção. Esse tempo limite impede que os pods em execução bloqueiem os upgrades.

Colocar um nó no modo de manutenção

Escolha os nós que você quer colocar no modo de manutenção especificando os intervalos de IPs dos nós selecionados em maintenanceBlocks no arquivo de configuração do cluster. Os nós escolhidos precisam estar prontos e funcionando no cluster.

Para colocar nós no modo de manutenção:

  1. Edite o arquivo de configuração do cluster para selecionar os nós que você quer colocar no modo de manutenção.

    É possível editar o arquivo de configuração com um editor de sua preferência ou editar o recurso personalizado do cluster diretamente executando o seguinte comando:

    kubectl -n CLUSTER_NAMESPACE edit cluster CLUSTER_NAME

    Substitua:

    • CLUSTER_NAMESPACE: o namespace do cluster.
    • CLUSTER_NAME: o nome do cluster.

  2. Adicione a seção maintenanceBlocks ao arquivo de configuração do cluster para especificar um único endereço IP ou um intervalo de endereços para os nós que você quer colocar no modo de manutenção.

    O exemplo a seguir mostra como selecionar vários nós especificando um intervalo de endereços IP:

    metadata:
  name: my-cluster
  namespace: cluster-my-cluster
spec:
  maintenanceBlocks:
    cidrBlocks:
    - 172.16.128.1-172.16.128.64

  3. Salve e aplique a configuração atualizada do cluster.

    O GKE em Bare Metal começa a colocar os nós no modo de manutenção.

  4. Execute o seguinte comando para ver o status dos nós no cluster:

    kubectl get nodes --kubeconfig=KUBECONFIG

    O resultado será assim:

    NAME                       STATUS   ROLES           AGE     VERSION
user-anthos-baremetal-01   Ready    control-plane   2d22h   v1.27.4-gke.1600
user-anthos-baremetal-04   Ready    worker          2d22h   v1.27.4-gke.1600
user-anthos-baremetal-05   Ready    worker          2d22h   v1.27.4-gke.1600
user-anthos-baremetal-06   Ready    worker          2d22h   v1.27.4-gke.1600

    Os nós ainda são programáveis, mas os taints impedem a programação de qualquer pod (sem uma tolerância adequada).

  5. Execute o seguinte comando para ver o número de nós no modo de manutenção:

    kubectl get nodepools --kubeconfig ADMIN_KUBECONFIG

    A resposta será semelhante a esta:

    NAME   READY   RECONCILING   STALLED   UNDERMAINTENANCE   UNKNOWN
np1    3       0             0         1                  0

    Na coluna UNDERMAINTENANCE neste exemplo, vemos que um nó está no modo de manutenção.

    O GKE em Bare Metal também adiciona os seguintes taints aos nós quando eles são colocados no modo de manutenção:

    • baremetal.cluster.gke.io/maintenance:NoExecute
    • baremetal.cluster.gke.io/maintenance:NoSchedule

Remover um nó do modo de manutenção

Para remover nós do modo de manutenção:

  1. Edite o arquivo de configuração do cluster para limpar os nós que você quer remover do modo de manutenção.

    É possível editar o arquivo de configuração com um editor de sua preferência ou editar o recurso personalizado do cluster diretamente executando o seguinte comando:

    kubectl -n CLUSTER_NAMESPACE edit cluster CLUSTER_NAME

    Substitua:

    • CLUSTER_NAMESPACE: o namespace do cluster.
    • CLUSTER_NAME: o nome do cluster.

  2. Edite os endereços IP para remover nós específicos do modo de manutenção ou remova a seção maintenanceBlocks para remover todos os nós do modo de manutenção.

  3. Salve e aplique a configuração atualizada do cluster.

  4. Use comandos kubectl para verificar o status dos nós.

Encerrar e reiniciar um cluster

Se for necessário desativar um cluster completo, use as instruções nas seções a seguir para encerrar um cluster e recuperá-lo com segurança.

Encerrar um cluster

Se você estiver encerrando um cluster que gerencia clusters de usuário, primeiro será necessário encerrar todos os clusters de usuário gerenciados. As instruções a seguir se aplicam a todos os tipos de cluster bare metal do GKE.

  1. Verifique o status de todos os nós do cluster:

    kubectl get nodes --kubeconfig CLUSTER_KUBECONFIG

    Substitua CLUSTER_KUBECONFIG pelo caminho do arquivo kubeconfig para o cluster.

    O resultado será assim:

    NAME        STATUS   ROLES           AGE    VERSION
control-0   Ready    control-plane   202d   v1.27.4-gke.1600
control-1   Ready    control-plane   202d   v1.27.4-gke.1600
control-2   Ready    control-plane   202d   v1.27.4-gke.1600
worker-0    Ready    worker          202d   v1.27.4-gke.1600
worker-1    Ready    worker          202d   v1.27.4-gke.1600
worker-2    Ready    worker          202d   v1.27.4-gke.1600
worker-3    Ready    worker          202d   v1.27.4-gke.1600
worker-4    Ready    worker          154d   v1.27.4-gke.1600
worker-5    Ready    worker          154d   v1.27.4-gke.1600
worker-6    Ready    worker          154d   v1.27.4-gke.1600
worker-7    Ready    worker          154d   v1.27.4-gke.1600
worker-8    Ready    worker          154d   v1.27.4-gke.1600
worker-9    Ready    worker          154d   v1.27.4-gke.1600

    Se o STATUS de um nó não for Ready, é altamente recomendável solucionar problemas do nó e prosseguir somente quando todos os nós estiverem Ready.

  2. Se você estiver encerrando um cluster de usuário, verifique o status dos nós do cluster de administrador:

    kubectl get nodes --kubeconfig ADMIN_KUBECONFIG

    Substitua ADMIN_KUBECONFIG pelo caminho do arquivo kubeconfig para o cluster de gerenciamento.

    As etapas subsequentes dependem do cluster de administrador. Se o STATUS de um nó não for Ready, recomendamos que você solucione o problema do nó e prossiga somente quando todos os nós estiverem Ready.

  3. Verifique a integridade do cluster que você quer encerrar:

    bmctl check cluster -c CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG

    Substitua:

    • CLUSTER_NAME: o nome do cluster que você está verificando.

    • ADMIN_KUBECONFIG: o caminho do arquivo kubeconfig para o cluster de gerenciamento.

    Corrija os problemas informados antes de continuar.

  4. Para o cluster que você está encerrando, verifique se todos os pods etcd estão em execução:

    kubectl get pods --kubeconfig CLUSTER_KUBECONFIG -A \
    -l component=etcd

    Substitua CLUSTER_KUBECONFIG pelo caminho do arquivo kubeconfig para o cluster.

    O resultado será assim:

    NAMESPACE     NAME                   READY   STATUS    RESTARTS   AGE
kube-system   etcd-control-0-admin   1/1     Running   0          2d22h
kube-system   etcd-control-1-admin   1/1     Running   0          2d22h
kube-system   etcd-control-2-admin   1/1     Running   0          2d22h

    Se o STATUS de um pod não for Running, recomendamos que você solucione o problema do pod e prossiga somente quando todos os pods estiverem Running.

  5. Faça um backup conforme descrito em Fazer backup de um cluster.

    É importante fazer um backup do etcd antes de encerrar o cluster para que ele possa ser restaurado se você encontrar algum problema ao reiniciar o cluster. Corrupção de etcd, falhas de hardware do nó, problemas de conectividade de rede e potencialmente outras condições podem impedir que o cluster seja reiniciado corretamente.

  6. Se você estiver encerrando um cluster com nós de trabalho, coloque-os no modo de manutenção.

    Essa etapa minimiza a quantidade de gravações no etcd, o que reduz a probabilidade de que uma grande quantidade de gravações do etcd precise ser reconciliada quando o cluster for reiniciado.

  7. Coloque os nós do plano de controle no modo de manutenção.

    Essa etapa impede gravações corrompidas em cargas de trabalho com estado durante o encerramento do nó.

  8. Desative os nós do cluster na seguinte sequência:

    1. Nós de trabalho
    2. Nós do balanceador de carga do plano de controle

    3. Os nós do plano de controle, começando com os seguidores do etcd e terminando com o líder do etcd

      Se você tiver um cluster de alta disponibilidade (HA), poderá encontrar o líder do etcd usando o SSH para se conectar a cada nó do plano de controle e executando o seguinte comando etcdctl:

      ETCDCTL_API=3 etcdctl \
    --cacert /etc/kubernetes/pki/etcd/ca.crt \
    --cert /etc/kubernetes/pki/etcd/server.crt \
    --key /etc/kubernetes/pki/etcd/server.key \
    --write-out=table endpoint status

      A resposta inclui uma coluna IS LEADER, que retorna true se o nó for o líder do etcd.

Neste momento, seu cluster está completamente encerrado. Depois de realizar a manutenção necessária, reinicie o cluster conforme descrito na próxima seção.

Reiniciar o cluster

Use as etapas a seguir para reiniciar um cluster que foi completamente desligado.

  1. Ative as máquinas de nós na ordem inversa da sequência de desligamento.

  2. Remova os nós do plano de controle do modo de manutenção.

    Para instruções, consulte Remover um nó do modo de manutenção.

  3. Remover os nós de trabalho do modo de manutenção.

  4. Execute verificações de integridade para garantir que o cluster esteja funcionando corretamente:

    bmctl check cluster -c CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG

  5. Se um problema, como o loop de falhas do etcd, impedir que o cluster seja reiniciado corretamente, tente restaurá-lo a partir do último backup válido conhecido. Para instruções, consulte Restaurar um cluster.

Modo de faturamento e manutenção

O faturamento do GKE em Bare Metal é baseado no número de vCPUs que o cluster tem para nós capazes de executar cargas de trabalho. Quando você coloca um nó no modo de manutenção, os taints NoExecute e NoSchedule são adicionados ao nó, mas não desativam o faturamento. Depois de colocar um nó no modo de manutenção, demarque o nó (kubectl cordon NODE_NAME) para marcá-lo como não programável. Depois que um nó é marcado como não programável, ele e as vCPUs associadas são excluídos do faturamento.

Conforme descrito na página de preços, é possível usar kubectl para ver a capacidade de vCPU (usada para faturamento) de cada um dos clusters de usuário. O comando não considera se o nó é programável ou não. Ele fornece uma contagem de vCPUs apenas por nó.

Para identificar o número de vCPUs por nó do cluster de usuário:

kubectl get nodes \
    --kubeconfig USER_KUBECONFIG \
    -o=jsonpath="{range .items[*]}{.metadata.name}{\"\t\"} \
    {.status.capacity.cpu}{\"\n\"}{end}"

Substitua USER_KUBECONFIG pelo caminho do arquivo kubeconfig do cluster de usuário.