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.

Upgrades

As instruções a seguir o guiarão na atualização de um servidor Rancher que foi instalado em um cluster Kubernetes com Helm. Esses passos também se aplicam a instalações air-gapped com Helm.

Para as instruções de atualização do Rancher instalado com Docker, consulte xref:[esta página.]

Pré-requisitos

Acesso ao kubeconfig

O Helm deve ser executado do mesmo local que o seu arquivo kubeconfig, ou do mesmo local onde você executa seus comandos kubectl.

Se você instalou o Kubernetes com RKE2/K3s, o Kubeconfig é armazenado no diretório /etc/rancher/rke2/rke2.yaml ou /etc/rancher/k3s/k3s.yaml, dependendo da distribuição escolhida.

O kubeconfig também pode ser direcionado manualmente para o cluster pretendido com a tag --kubeconfig (veja: https://helm.sh/docs/helm/helm/)

Revisar Problemas Conhecidos

Revise a lista de problemas conhecidos para cada versão do Rancher, que pode ser encontrada nas notas de lançamento em GitHub e nos fóruns do Rancher.

Versão do Helm

As instruções de atualização assumem que você está usando o Helm 3.

Para instalações air-gapped: Popule o registro privado.

Para instalações air-gapped apenas, colete e preencha as imagens para a nova versão do servidor Rancher. Siga o guia para popular seu registro privado com as imagens da versão do Rancher para a qual você deseja atualizar.

Para atualizações com cert-manager anterior a 0.8.0

O Let’s Encrypt bloqueará instâncias do cert-manager anteriores a 0.8.0 a partir de 1º de novembro de 2019. Atualize o cert-manager para a versão mais recente seguindo estas instruções.

Roteiro de Atualização

Siga os passos para atualizar o servidor Rancher:

1. Faça backup do seu cluster Kubernetes que está executando o servidor Rancher

Use o aplicativo de backup para fazer backup do Rancher.

Você usará o backup como um ponto de restauração se algo der errado durante a atualização.

2. Atualize o repositório do Helm chart

  1. Atualize o cache do repositório local do Helm.

    helm repo update

  2. Obtenha o nome do repositório que você usou para instalar o Rancher.

    helm repo list

NAME                     URL
rancher-prime          <helm-chart-repo-url>

  3. Busque o chart mais recente para instalar o Rancher a partir do repositório do Helm chart.

    Este comando irá baixar os charts mais recentes e salvá-los no diretório atual como um arquivo .tgz.

     helm fetch rancher-prime/rancher

    Você pode buscar o chart para a versão específica para a qual está atualizando adicionando a tag --version=. Por exemplo:

     helm fetch rancher-prime/rancher --version={current-patch-version}

3. Revise as versões dos charts de recursos do Rancher antes da atualização

Os charts de recursos do Rancher seguem linhas de lançamento específicas que se alinham com as versões do Rancher. As versões principais dos charts de recursos correspondem às versões menores do Rancher e seguem um esquema de versionamento definido.

Antes de atualizar o Rancher, revise quaisquer charts de recursos do Rancher instalados e atualize-os para a versão mais recente disponível dentro de sua linha de lançamento atual. Isso ajuda a garantir a compatibilidade e evita problemas potenciais durante ou após a atualização do Rancher.

Para revisar os charts de recursos instalados:

  1. Na interface do Rancher, vá para Apps & Marketplace.

  2. Selecione Aplicativos Instalados.

  3. Revise as versões dos charts e faça upgrade para a versão mais recente do patch dentro da mesma versão principal do chart, se necessário.

Para mais informações, consulte o Esquema de Versionamento dos Helm Charts no Rancher.

4. Atualizar o Rancher

Esta seção descreve como atualizar instalações normais (conectadas à Internet) ou instalações air-gapped do Rancher com o Helm.

Instruções para Air Gap:

Se você estiver instalando o Rancher em um ambiente air-gapped, pule o restante desta página e gere o template do Helm seguindo as instruções em esta página.
Atualizando do Rancher v2.13.1

No Rancher v2.13.2, o nome do chart do Helm voltou de rancher-prime para rancher. Se você estiver atualizando do v2.13.1, o recurso Ingress existente criado pelo chart anterior conflita com o novo, causando a falha da atualização com um erro semelhante a:

Error: UPGRADE FAILED: failed to create resource: admission webhook "validate.nginx.ingress.kubernetes.io" denied the request: host "rancher.my.org" and path "/" is already defined in ingress cattle-system/rancher-rancher-prime

Para prevenir ou resolver esse problema, você deve excluir manualmente o antigo Ingress antes de completar a atualização:

kubectl delete ingress rancher-rancher-prime -n cattle-system

Obtenha os valores que foram passados com --set, do chart do Helm do Rancher que está instalado atualmente.

helm get values rancher -n cattle-system

hostname: rancher.my.org

Haverá mais valores listados com este comando. Este é apenas um exemplo de um dos valores.

O nome da sua implantação pode variar; por exemplo, se você estiver implantando o Rancher através do AWS Marketplace, o nome da implantação é 'rancher-prime'. Assim:

helm get values rancher-prime -n cattle-system

hostname: rancher.my.org

Se você estiver atualizando o cert-manager para a versão mais recente a partir da v1.5 ou anterior, siga a documentação de atualização do cert-manager para aprender como atualizar o cert-manager sem precisar desinstalar ou reinstalar o Rancher. Caso contrário, siga os passos para atualizar o Rancher abaixo.

Passos para Atualizar o Rancher

Atualize o Rancher para a versão mais recente com todas as suas configurações.

Pegue todos os valores da etapa anterior e anexe-os ao comando usando --set key=value.

helm upgrade rancher rancher-prime/rancher \
  --namespace cattle-system \
  --set hostname=rancher.my.org

O acima é um exemplo, pode haver mais valores da etapa anterior que precisam ser anexados.

Se você implantar o Rancher através do AWS Marketplace, o nome da implantação é 'rancher-prime'. Assim:

helm upgrade rancher-prime rancher-prime/rancher \
  --namespace cattle-system \
  --set hostname=rancher.my.org

Alternativamente, é possível exportar os valores atuais para um arquivo e referenciar esse arquivo durante a atualização. Por exemplo, para mudar apenas a versão do Rancher:

  1. Exporte os valores atuais para um arquivo:

     helm get values rancher -n cattle-system -o yaml > values.yaml

  2. Atualize apenas a versão do Rancher:

     helm upgrade rancher rancher-prime/rancher \
   --namespace cattle-system \
   -f values.yaml \
   --version={current-patch-version}

5. Verifique a atualização

Faça login no Rancher para confirmar que a atualização foi bem-sucedida.

Problemas conhecidos de atualização

Uma lista de problemas conhecidos para cada versão do Rancher pode ser encontrada nas notas de lançamento em GitHub e nos fóruns do Rancher.