Observação:

Este tutorial está disponível em um ambiente de laboratório gratuito fornecido pela Oracle.
Ele usa valores de exemplo para credenciais, tenancy e compartimentos do Oracle Cloud Infrastructure. Ao concluir seu laboratório, substitua esses valores por valores específicos do seu ambiente de nuvem.

Fazer Upgrade da Versão do Kubernetes no Oracle Cloud Native Environment

Introdução

As melhores práticas recomendam fazer upgrade do cluster do Kubernetes assim que possível após uma nova release. Os motivos para atualizar o mais rápido possível incluem:

Aplicar as correções de segurança mais recentes
Estabilidade de acesso e melhorias de desempenho
Acesse novos recursos, APIs e funcionalidades

Este tutorial demonstra como fazer upgrade da versão do Kubernetes usada no cluster do Oracle CNE.

Para obter mais informações sobre o Oracle CNE, consulte o site atual da Documentação da Versão.

Objetivos

Neste tutorial, você aprenderá a:

Fazer upgrade da versão do Kubernetes implantada em todo o cluster

Pré-requisitos

Mínimo de uma instância do Oracle Linux
Cada sistema deve ter o Oracle Linux instalado e configurado com:
- Uma conta de usuário da Oracle (usada durante a instalação) com acesso sudo
- SSH baseado em chave, também conhecido como SSH sem senha, entre os hosts
- Um ambiente libvirt KVM de trabalho.

Implantar Ambiente Nativo do Oracle Cloud

Observação: Se estiver em execução em sua própria tenancy, leia o projeto linux-virt-labs GitHub README.md e conclua os pré-requisitos antes de implantar o ambiente de laboratório.

Abra um terminal no Luna Desktop.

Clone o projeto linux-virt-labs GitHub.

git clone https://github.com/oracle-devrel/linux-virt-labs.git

Altere para o diretório de trabalho.
```
cd linux-virt-labs/ocne2
```

Instale as coleções necessárias.

ansible-galaxy collection install -r requirements.yml

Implante o ambiente de laboratório.
```
ansible-playbook create_instance.yml -e localhost_python_interpreter="/usr/bin/python3.6" -e install_ocne_rpm=true
```
O ambiente de laboratório gratuito requer a variável extra local_python_interpreter, que define ansible_python_interpreter para execuções em execução no localhost. Essa variável é necessária porque o ambiente instala o pacote RPM do SDK para Python do Oracle Cloud Infrastructure, localizado nos módulos python3.6.

A forma de implantação padrão usa a CPU AMD e o Oracle Linux 8. Para usar uma CPU Intel ou Oracle Linux 9, adicione -e instance_shape="VM.Standard3.Flex" ou -e os_version="9" ao comando de implantação.

Importante: Aguarde a execução bem-sucedida do playbook e atinja a tarefa de pausa. Nesta etapa do manual, a instalação do Oracle CNE está concluída e as instâncias estão prontas. Tome nota da reprodução anterior, que imprime os endereços IP públicos e privados dos nós que ele implanta e qualquer outra informação de implantação necessária durante a execução do laboratório.

Iniciar um Cluster do Kubernetes

Usaremos um único plano de controle e cluster de nó de trabalho com base no Kubernetes v1.30, com planos de upgrade para a versão 1.31.

Abra um terminal e conecte-se via SSH à instância ocne.
```
ssh oracle@<ip_address_of_node>
```

Inicie o cluster.

ocne cluster start --version 1.30 -n 1 -w 1 -u false

Defina a variável de ambiente kubeconfig para seu novo cluster.
```
export KUBECONFIG=$(ocne cluster show -C ocne)
```
Onde ocne é o nome padrão de um cluster, a menos que especificado. Em seguida, você pode usar kubectl get nodes para mostrar os dois nós e verificar se eles estão executando a versão 1.30.

Atualizar o Kubernetes

O Kubernetes exige que você atualize uma versão de cada vez; portanto, se precisar fazer upgrade de mais de uma versão, você precisará repetir essas etapas para cada versão.

Preparar a próxima versão do Kubernetes.
```
ocne cluster stage -v 1.31
```
Obtenha uma lista dos nós do cluster.
```
kubectl get nodes
```
Verifique se há atualizações disponíveis.
```
watch ocne cluster info
```
Monitore até ver nós com atualizações disponíveis: 2 reportados na saída. Digite Ctrl-c para sair do comando watch.
Atualize o nó do plano de controle.

Você deve primeiro atualizar todos os nós do plano de controle dentro do cluster.
```
ocne node update -N ocne-control-plane-1
```
A atualização pode levar alguns minutos para ser concluída após o término do comando. Você pode usar kubectl get nodes para verificar a versão do nó do plano de controle.
Atualize o nó de trabalho.
```
ocne node update -N ocne-worker-1 --delete-emptydir-data
```
Repita o comando se você receber uma advertência de que um upgrade está indisponível ou se o cluster não puder executá-lo. Esse pequeno cluster pode levar alguns minutos para se estabilizar antes de atualizar o nó de trabalho.

O nó de trabalho requer a opção --delete-emptydir-data porque o Pod ui usa um volume emptyDir para compartilhar conteúdo entre seus contêineres em execução.
Verifique a versão dos nós do cluster.
```
kubectl get nodes
```
Repita o comando até que a saída mostre que cada nó está na versão esperada.

Próximas Etapas

Saber como manter a versão mais recente do Kubernetes implantada no cluster do Oracle CNE garante que o cluster permaneça atualizado com todas as correções de segurança e estabilidade mais recentes.

Mais Recursos de Aprendizagem

Explore outros laboratórios em docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal Oracle Learning YouTube. Além disso, visite education.oracle.com/learning-explorer para se tornar um Oracle Learning Explorer.

Para obter a documentação do produto, visite o Oracle Help Center.

Título e Informações de Copyright

Upgrade the Kubernetes Version on Oracle Cloud Native Environment

G32057-01