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.

Fazendo upgrade em um ambiente air-gapped

Estas instruções assumem que você já seguiu as instruções para fazer upgrade do Kubernetes nesta esta página, incluindo os pré-requisitos, até o passo 3. Fazer upgrade do Rancher.

Opções para fazer upgrade do Rancher via Helm

Para fazer upgrade com o Helm, aplique as mesmas opções que você usou ao instalar o Rancher. Consulte a tabela de referência abaixo para substituir cada marcador de posição. O Rancher precisa ser configurado para usar o registro privado, a fim de provisionar quaisquer clusters Kubernetes lançados pelo Rancher ou suas ferramentas.

Com base na escolha que você fez durante a instalação, complete um dos procedimentos abaixo.

Marcador Descrição

<VERSION>

O número da versão do arquivo tarball de saída.

<RANCHER.YOURDOMAIN.COM>

O nome DNS que você apontou para seu balanceador de carga.

<REGISTRY.YOURDOMAIN.COM:PORT>

O nome DNS para seu registro privado.

<CERTMANAGER_VERSION>

Versão do cert-manager em execução no cluster k8s.

Opção A: Certificado autoassinado padrão

helm upgrade rancher ./rancher-<VERSION>.tgz \
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set certmanager.version=<CERTMANAGER_VERSION> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Defina um registro privado padrão a ser usado no Rancher
    --set useBundledSystemChart=true # Use os gráficos de sistema do Rancher empacotados

Resolvendo o erro UPGRADE FAILED

Se você encontrar a mensagem de erro, Error: UPGRADE FAILED: "rancher" has no deployed releases, o Rancher pode ter sido instalado via o comando helm template. Para fazer upgrade do Rancher com sucesso, use o seguinte comando em vez disso:

helm template rancher ./rancher-<VERSION>.tgz --output-dir . \
    --no-hooks \ # prevent files for Helm hooks from being generated
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set certmanager.version=<CERTMANAGER_VERSION> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
    --set useBundledSystemChart=true # Use the packaged Rancher system charts

Após executar o comando Helm, aplique o template renderizado:

kubectl -n cattle-system apply -R -f ./rancher

Opção B: Certificados a partir de arquivos usando segredos do Kubernetes

helm upgrade rancher ./rancher-<VERSION>.tgz \
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set ingress.tls.source=secret \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
    --set useBundledSystemChart=true # Use the packaged Rancher system charts

Se você estiver usando um certificado assinado por uma CA Privada, adicione --set privateCA=true após --set ingress.tls.source=secret:

helm upgrade rancher ./rancher-<VERSION>.tgz \
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set ingress.tls.source=secret \
    --set privateCA=true \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
    --set useBundledSystemChart=true # Use the packaged Rancher system charts

Verifique a atualização

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

Está tendo problemas de rede após o upgrade?

Veja xref:[Restaurando a Rede do Cluster].

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.