Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Atualizando e Revertendo o Kubernetes

Após fazer upgrade para a versão mais recente do Rancher, os clusters Kubernetes downstream podem ser atualizados para usar a versão mais recente suportada do Kubernetes.

O Rancher chama o RKE (Rancher Kubernetes Engine) como uma biblioteca ao provisionar e editar clusters RKE. Para mais informações sobre como configurar a estratégia de upgrade para clusters RKE, consulte a documentação do RKE.

Versões do Kubernetes Testadas

Antes de lançar uma nova versão do Rancher, ela é testada com as versões minor mais recentes do Kubernetes para garantir a compatibilidade. Para detalhes sobre quais versões do Kubernetes foram testadas em cada versão do Rancher, consulte os termos de suporte e manutenção.

Como Funcionam os Upgrades

O RKE v1.1.0 mudou a forma como os clusters fazem upgrade.

Nesta seção da documentação do RKE,, você aprenderá o que acontece quando edita ou faz upgrade do seu cluster Kubernetes RKE.

Melhores Práticas Recomendadas para Upgrades

Ao fazer upgrade da versão do Kubernetes de um cluster, recomendamos que você:

  1. Tire um instantâneo.

  2. Inicie um upgrade do Kubernetes.

  3. Se o upgrade falhar, reverta o cluster para a versão do Kubernetes anterior ao upgrade. Isso é alcançado selecionando a opção Restaurar a versão do etcd e do Kubernetes. Isso retornará seu cluster para a versão do Kubernetes anterior ao upgrade antes de restaurar o instantâneo do etcd.

A operação de restauração funcionará em um cluster que não está em um estado saudável ou ativo.

Fazendo upgrade da Versão do Kubernetes

Pré-requisitos:

  1. No canto superior esquerdo, clique em ☰ > Gerenciamento de Cluster.

  2. Na página Clusters, vá para o cluster que você deseja fazer upgrade e clique em ⋮ > Editar Configuração.

  3. No menu suspenso Versão do Kubernetes, escolha a versão do Kubernetes que você deseja usar para o cluster.

  4. Clique em Salvar.

Resultado: O Kubernetes começa a fazer upgrade do cluster.

Revertendo

Um cluster pode ser restaurado a um backup em que a versão anterior do Kubernetes foi usada. Para mais informações, consulte as seguintes seções:

Configurando a Estratégia de Upgrade

A partir da versão RKE v1.1.0, opções adicionais de upgrade se tornaram disponíveis para lhe dar um controle mais granular sobre o processo de upgrade. Essas opções podem ser usadas para manter a disponibilidade de suas aplicações durante um upgrade de cluster se certas condições e requisitos forem atendidos.

A estratégia de upgrade pode ser configurada na interface do Rancher ou editando o cluster.yml. Opções mais avançadas estão disponíveis ao editar o cluster.yml.

Configurando o Número Máximo de Nós de Trabalho Indisponíveis na Interface do Rancher

A partir da interface do Rancher, o número máximo de nós de trabalho indisponíveis pode ser configurado. Durante um upgrade de cluster, os nós de trabalho serão atualizados em lotes desse tamanho.

Por padrão, o número máximo de nós de trabalho indisponíveis é definido como 10 por cento de todos os nós de trabalho. Esse número pode ser configurado como uma porcentagem ou como um inteiro. Quando definido como uma porcentagem, o tamanho do lote é arredondado para baixo para o nó mais próximo, com um mínimo de um nó.

Para alterar o número padrão ou a porcentagem de nós de trabalho,

  1. No canto superior esquerdo, clique em ☰ > Gerenciamento de Cluster.

  2. Na página Clusters, vá para o cluster que você deseja fazer upgrade e clique em ⋮ > Editar Configuração.

  3. Na aba Estratégia de Upgrade, insira o Concorrência de Trabalho como um número fixo ou porcentagem. Para obter esse número, você pode pegar o número de nós em seu cluster e subtrair o número máximo de nós indisponíveis durante o upgrade.

  4. Clique em Salvar.

Resultado: O cluster é atualizado para usar a nova estratégia de upgrade.

Habilitando a Drenagem de Nós Durante Upgrades na Interface do Rancher

Por padrão, o RKE cordona cada nó antes de fazer upgrade nele. Drenagem está desativada durante upgrades por padrão. Se a drenagem estiver habilitada na configuração do cluster, o RKE irá tanto cordonar quanto drenar o nó antes de fazer upgrade nele.

Para habilitar a drenagem de cada nó durante um upgrade de cluster,

  1. No canto superior esquerdo, clique em ☰ > Gerenciamento de Cluster.

  2. Na página Clusters, vá para o cluster que você deseja habilitar a drenagem de nós e clique em ⋮ > Editar Configuração.

  3. Clique em ⋮ > Editar.

  4. Na aba Estratégia de Upgrade, vá para o campo Drenar nós e clique em Sim. A drenagem de nós é configurada separadamente para nós de controle e nós de trabalho.

  5. Configure as opções para como os pods são excluídos. Para mais informações sobre cada opção, consulte esta seção.

  6. Opcionalmente, configure um período extra. O período extra é o tempo limite dado a cada pod para limpar as coisas, para que eles tenham a chance de encerrar corretamente. Os pods podem precisar concluir quaisquer solicitações pendentes, reverter transações ou salvar o estado em algum armazenamento externo. Se esse valor for negativo, o valor padrão especificado no pod será usado.

  7. Opcionalmente, configure um tempo limite, que é a quantidade de tempo que a drenagem deve continuar a esperar antes de desistir.

  8. Clique em Salvar.

Resultado: O cluster é atualizado para usar a nova estratégia de atualização.

  • Há um problema conhecido em que a interface do Rancher não mostra o estado do etcd e do plano de controle como drenados, mesmo que estejam sendo drenados.

  • Durante uma atualização, os nós podem ser drenados mesmo quando não há alterações visíveis de YAML para o usuário. Isso pode ocorrer se arquivos de configuração não dinâmicos forem atualizados ou se uma nova system-agent-installer imagem for introduzida. Nesses casos, o Rancher gera um novo plano de atualização, resultando em um novo hash de plano. Quando Upgrade Strategy é definido como Drain nodes, essa mudança de plano pode acionar a drenagem do nó.

Mantendo a Disponibilidade para Aplicações Durante Upgrades

Na esta seção da documentação do RKE,, você aprenderá os requisitos para evitar tempo de inatividade para suas aplicações ao fazer upgrade do cluster.

Configurando a Estratégia de Upgrade no cluster.yml

Opções de configuração da estratégia de upgrade mais avançadas estão disponíveis editando o cluster.yml.

Para detalhes, consulte Configurando a Estratégia de Upgrade na documentação do RKE. A seção também inclui um exemplo cluster.yml para configurar a estratégia de upgrade.

Solução de problemas

Se um nó não iniciar após um upgrade, o comando rke up retorna erro.

Nenhum upgrade será realizado se o número de nós indisponíveis exceder o máximo configurado.

Se um upgrade parar, pode ser necessário corrigir um nó indisponível ou removê-lo do cluster antes que o upgrade possa continuar.

Um nó com falha pode estar em muitos estados diferentes:

  • Desligado

  • Não disponível

  • O usuário drena um nó enquanto o upgrade está em processo, de modo que não há kubelets no nó

  • O próprio upgrade falhou

Se o número máximo de nós indisponíveis for atingido durante um upgrade, os clusters de usuários do Rancher ficarão presos no estado de atualização e não avançarão com o upgrade de quaisquer outros nós do plano de controle. Ele continuará avaliando o conjunto de nós indisponíveis caso um dos nós se torne disponível. Se o nó não puder ser corrigido, você deve remover o nó para continuar o upgrade.