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.

Guia de migração

Contexto

A partir do Rancher v2.13, SUSE® Rancher Prime Cluster API é instalado como parte do Rancher, eliminando a necessidade de uma implantação separada. Antes de fazer upgrade para o Rancher v2.13, os usuários devem seguir este guia para garantir um processo de upgrade tranquilo.

Migração

Siga os passos abaixo na ordem, antes de fazer upgrade para o Rancher v2.13:

  1. Certifique-se de fazer upgrade de SUSE® Rancher Prime Cluster API para a versão v0.24.3. Este passo é importante porque todos os lançamentos de patch para v0.24 preparam o cluster para fazer upgrade para o Rancher v2.13.

  2. Desinstale SUSE® Rancher Prime Cluster API. Isso é necessário porque a partir do Rancher v2.13, SUSE® Rancher Prime Cluster API não é mais um complemento opcional, mas um componente do sistema Rancher. Assim, o Rancher o instala em um namespace diferente do anterior e, portanto, a versão instalada anteriormente precisa ser desinstalada manualmente primeiro. Desinstalar a versão v0.24.3 de SUSE® Rancher Prime Cluster API remove o próprio provedor CAPI kernel, mas mantém os CRDs CAPI kernel. Durante a migração, o controlador CAPI kernel não estará em execução no cluster de gerenciamento, mas quaisquer clusters CAPI downstream devem continuar a funcionar normalmente e não serem afetados.

  3. Execute os seguintes comandos kubectl:

    kubectl patch crd capiproviders.turtles-capi.cattle.io --type=json -p='[{"op": "add", "path": "/metadata/annotations/meta.helm.sh~1release-namespace", "value": "cattle-turtles-system"}]'
kubectl patch crd clusterctlconfigs.turtles-capi.cattle.io --type=json -p='[{"op": "add", "path": "/metadata/annotations/meta.helm.sh~1release-namespace", "value": "cattle-turtles-system"}]'

Esses comandos irão aplicar um patch nos CRDs capiprovider e clusterctlconfig para que sejam adotados por SUSE® Rancher Prime Cluster API quando instalados como parte do Rancher v2.13.

Observe que a migração descrita acima é necessária para usuários que executam versões SUSE® Rancher Prime Cluster API ≤ v0.24.3. Novos usuários que estão instalando o Rancher v2.13 não precisam realizar nenhuma migração.