Este documento pode estar desatualizado
Este documento possui uma data de atualização mais antiga que o documento original. Portanto, este conteúdo pode estar desatualizado. Se você lê inglês, veja a versão em inglês para acessar a versão mais atualizada: kubeadm upgrade
kubeadm upgrade
kubeadm upgrade é um comando amigável que envolve uma lógica de atualização complexa por trás de um comando, com suporte para planejar e executar de fato uma atualização.
Guia do kubeadm upgrade
As etapas para realizar uma atualização usando kubeadm estão descritas neste documento. Para versões mais antigas do kubeadm, consulte os conjuntos de documentação mais antigos do site Kubernetes.
Você pode usar kubeadm upgrade diff para ver as alterações que seriam aplicadas aos manifestos de Pod estático.
No Kubernetes v1.15.0 e posteriores, o kubeadm upgrade apply e kubeadm upgrade node também renovarão automaticamente os certificados gerenciados pelo kubeadm neste nó, incluindo aqueles armazenados nos arquivos do kubeconfig.
É possível optar por não renovar usando a flag --certificate-renewal=false.
Para mais detalhes sobre a renovação dos certificados, consulte a documentação de gerenciamento de certificados.
Nota:
Os comandoskubeadm upgrade apply e kubeadm upgrade plan tem uma flag legada --config que possibilita reconfigurar o cluster enquanto realiza o planejamento ou a atualização do nó específico da camada de gerenciamento.
Esteja ciente de que o fluxo de trabalho da atualização não foi projetado para este cenário e existem relatos de resultados inesperados.kubeadm upgrade plan
Verifique quais versões estão disponíveis para atualizar e verifique se o seu cluster atual é atualizável. Para pular a verificação da Internet, passe o parâmetro opcional [versão]
Sinopse
Verifique quais versões estão disponíveis para atualizar e verifique se o seu cluster atual é atualizável. Para pular a verificação da Internet, passe o parâmetro opcional [versão]
kubeadm upgrade plan [versão] [flags]
Opções
| --allow-experimental-upgrades | |
Exibe as versões instáveis do Kubernetes como uma alternativa de atualização e permite a atualização para versões alfa/beta/release candidate do Kubernetes. | |
| --allow-release-candidate-upgrades | |
Exibe as versões candidatas a lançamento do Kubernetes como uma alternativa de atualização e permite a atualização para versões candidatas a lançamento do Kubernetes. | |
| --config string | |
Caminho para um arquivo de configuração kubeadm. | |
| --feature-gates string | |
Um conjunto de pares chave=valor que descreve feature gates para várias funcionalidades. As opções são: | |
| -h, --help | |
ajuda para plan | |
| --ignore-preflight-errors strings | |
Uma lista de verificações para as quais erros serão exibidos como avisos. Exemplos: 'IsPrivilegedUser,Swap'. O valor 'all' ignora erros de todas as verificações. | |
| --kubeconfig string Padrão: "/etc/kubernetes/admin.conf" | |
O arquivo kubeconfig a ser usado para se comunicar com o cluster. Se a flag não estiver definida, um conjunto de locais predefinidos pode ser pesquisado por um arquivo kubeconfig existente. | |
| -o, --output string Padrão: "text" | |
EXPERIMENTAL: Formato de saída. Opções válidas: text|json|yaml. | |
| --print-config | |
Especifica se o arquivo de configuração que será usado na atualização deve ser exibido ou não. | |
| --show-managed-fields | |
Se verdadeiro, mantém os managedFields ao exibir os objetos no formato JSON ou YAML. | |
Opções herdadas de comandos superiores
| --rootfs string | |
[EXPERIMENTAL] O caminho para o sistema de arquivos raiz 'real' do host. | |
kubeadm upgrade apply
Atualiza o cluster Kubernetes para uma versão específica
Sinopse
Atualiza o cluster Kubernetes para uma versão específica
kubeadm upgrade apply [versão]
Opções
| --allow-experimental-upgrades | |
Exibe as versões instáveis do Kubernetes como uma alternativa de atualização e permite a atualização para versões alfa/beta/release candidate do Kubernetes. | |
| --allow-release-candidate-upgrades | |
Exibe as versões candidatas a lançamento do Kubernetes como uma alternativa de atualização e permite a atualização para versões candidatas a lançamento do Kubernetes. | |
| --certificate-renewal Padrão: true | |
Executa a renovação dos certificados usados pelo componente alterado durante as atualizações. | |
| --config string | |
Caminho para um arquivo de configuração do kubeadm. | |
| --dry-run | |
Não aplica as modificações; apenas exibe as alterações que seriam efetuadas. | |
| --etcd-upgrade Padrão: true | |
Atualiza o etcd. | |
| --feature-gates string | |
Um conjunto de pares chave=valor que descreve feature gates para várias funcionalidades. As opções são: | |
| -f, --force | |
Força a atualização, embora alguns requisitos possam não estar sendo atendidos. Isso também implica o modo não interativo. | |
| -h, --help | |
ajuda para apply | |
| --ignore-preflight-errors strings | |
Uma lista de verificações para as quais erros serão exibidos como avisos. Exemplos: 'IsPrivilegedUser,Swap'. O valor 'all' ignora erros de todas as verificações. | |
| --kubeconfig string Padrão: "/etc/kubernetes/admin.conf" | |
O arquivo kubeconfig a ser usado para se comunicar com o cluster. Se a flag não estiver definida, um conjunto de locais predefinidos pode ser pesquisado por um arquivo kubeconfig existente. | |
| --patches string | |
Caminho para um diretório contendo arquivos nomeados no padrão "target[suffix][+patchtype].extension". Por exemplo, "kube-apiserver0+merge.yaml" ou somente "etcd.json". "target" pode ser um dos seguintes valores: "kube-apiserver", "kube-controller-manager", "kube-scheduler", "etcd", "kubeletconfiguration". "patchtype" pode ser "strategic", "merge" ou "json" e corresponde aos formatos de patch suportados pelo kubectl. O valor padrão para "patchtype" é "strategic". "extension" deve ser "json" ou "yaml". "suffix" é uma string opcional utilizada para determinar quais patches são aplicados primeiro em ordem alfanumérica. | |
| --print-config | |
Especifica se o arquivo de configuração que será usado na atualização deve ser exibido ou não. | |
| -y, --yes | |
Executa a atualização e não solicita um prompt de confirmação (modo não interativo). | |
Opções herdadas de comandos superiores
| --rootfs string | |
[EXPERIMENTAL] O caminho para o sistema de arquivos raiz 'real' do host. | |
kubeadm upgrade diff
Mostra quais diferenças serão aplicadas aos manifestos dos Pods estáticos existentes. Veja também: kubeadm upgrade apply --dry-run
Sinopse
Mostra quais diferenças serão aplicadas aos manifestos dos Pods estáticos existentes. Veja também: kubeadm upgrade apply --dry-run
kubeadm upgrade diff [versão] [flags]
Opções
| --api-server-manifest string Padrão: "/etc/kubernetes/manifests/kube-apiserver.yaml" | |
Caminho para o manifesto do servidor da API | |
| --config string | |
Caminho para um arquivo de configuração do kubeadm. | |
| -c, --context-lines int Padrão: 3 | |
Quantidade de linhas de contexto do diff | |
| --controller-manager-manifest string Padrão: "/etc/kubernetes/manifests/kube-controller-manager.yaml" | |
Caminho para o manifesto do controlador de gerenciadores | |
| -h, --help | |
Ajuda para diff | |
| --kubeconfig string Padrão: "/etc/kubernetes/admin.conf" | |
O arquivo kubeconfig a ser usado para se comunicar com o cluster. Se a flag não estiver definida, um conjunto de locais predefinidos pode ser pesquisado por um arquivo kubeconfig existente. | |
| --scheduler-manifest string Padrão: "/etc/kubernetes/manifests/kube-scheduler.yaml" | |
Caminho para o manifesto do escalonador | |
Opções herdadas de comandos superiores
| --rootfs string | |
[EXPERIMENTAL] O caminho para o sistema de arquivos raiz 'real' do host. | |
kubeadm upgrade node
Comando para atualização de um nó no cluster
Sinopse
Comando para atualização de um nó no cluster
O comando "node" executa as seguintes fases:
preflight Executa as verificações de pré-atualização do nó
control-plane Atualiza a instância da camada de gerenciamento implantada neste nó, se houver
kubelet-config Atualiza a configuração do kubelet para este nó
kubeadm upgrade node [flags]
Opções
| --certificate-renewal Padrão: true | |
Executa a renovação dos certificados usados pelo componente alterado durante as atualizações. | |
| --dry-run | |
Não aplica as modificações; apenas exibe as alterações que seriam efetuadas. | |
| --etcd-upgrade Padrão: true | |
Atualiza o etcd. | |
| -h, --help | |
ajuda para node | |
| --ignore-preflight-errors strings | |
Uma lista de verificações para as quais erros serão exibidos como avisos. Exemplos: 'IsPrivilegedUser,Swap'. O valor 'all' ignora erros de todas as verificações. | |
| --kubeconfig string Padrão: "/etc/kubernetes/admin.conf" | |
O arquivo kubeconfig a ser usado para se comunicar com o cluster. Se a flag não estiver definida, um conjunto de locais predefinidos pode ser pesquisado por um arquivo kubeconfig existente. | |
| --patches string | |
Caminho para um diretório contendo arquivos nomeados no padrão "target[suffix][+patchtype].extension". Por exemplo, "kube-apiserver0+merge.yaml" ou somente "etcd.json". "target" pode ser um dos seguintes valores: "kube-apiserver", "kube-controller-manager", "kube-scheduler", "etcd", "kubeletconfiguration". "patchtype" pode ser "strategic", "merge" ou "json" e corresponde aos formatos de patch suportados pelo kubectl. O valor padrão para "patchtype" é "strategic". "extension" deve ser "json" ou "yaml". "suffix" é uma string opcional utilizada para determinar quais patches são aplicados primeiro em ordem alfanumérica. | |
| --skip-phases strings | |
Lista de fases a serem ignoradas | |
Opções herdadas de comandos superiores
| --rootfs string | |
[EXPERIMENTAL] O caminho para o sistema de arquivos raiz 'real' do host. | |
Próximos passos
- kubeadm config se você inicializou seu cluster usando kubeadm v1.7.x ou inferior, para configurar seu cluster para
kubeadm upgrade