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.

Rollbacks

Esta página descreve como fazer rollback do Rancher para uma versão anterior após um upgrade.

  • This is only possible by restoring to a previous version from a backup instance. Changing versions using kubectl or Helm is not supported.

  • When rolling back, ensure the version being restored is under active support. Rolling back to versions that are end-of-life is not supported. Refer to SUSE’s Product Support Lifecycle page to verify key lifecycle dates for your given version.

Siga as instruções desta página quando:

  • A instância do Rancher em execução foi atualizada para uma versão mais recente após o backup ter sido feito.

  • O cluster local é o mesmo de onde o backup foi feito.

Para fazer rollback do Rancher para uma versão anterior, use o aplicativo Rancher Backups e restaure o Rancher a partir do backup.

O Rancher deve ser iniciado com a versão anterior após um rollback.

Uma restauração é realizada criando um recurso personalizado de Restauração.

Passos Alternativos para Cenários Especiais

Passos alternativos precisam ser realizados para rollbacks nos seguintes cenários:

  • Fazendo rollback da versão v2.14.0 e posteriores para uma versão anterior da v2.13.x.

No Rancher v2.13.0, os Rancher Turtles se tornaram o gerenciador padrão para recursos CAPI, substituindo os controladores cluster-api incorporados anteriormente, e no Rancher v2.14.0, o cluster-api incorporado foi removido completamente. Como resultado, se você fizer rollback do Rancher v2.14.0 e posteriores para uma versão anterior do Rancher v2.13.x e não pretende continuar usando os Rancher Turtles para gerenciar recursos CAPI, etapas manuais adicionais podem ser necessárias para usar os controladores cluster-api incorporados. A partir do Rancher v2.14.0, os Rancher Turtles são o único gerenciador suportado para recursos CAPI.

No Rancher v2.14.0, o módulo cluster-api é atualizado da versão v1.10.6 para v1.12.2. O cluster-api v1.12.2, por sua vez, atualiza as apiVersions de suas definições de recursos personalizados (CRDs) de cluster.x-k8s.io/v1beta1 para cluster.x-k8s.io/v1beta2. Os arquivos de backup do Rancher incluem CRDs do Cluster API. Ao restaurar dados de backup do Rancher v2.13.x para um cluster local após a atualização para v2.14.0, o aplicativo Rancher Backup primeiro restaura os CRDs v1beta1. Isso falha porque a versão v1beta2 não pode ser removida dos CRDs enquanto recursos personalizados v1beta2 estão presentes no cluster.

Importante:

  • Siga as instruções desta página para restaurar o Rancher no mesmo cluster de onde foi feito o backup. Para migrar o Rancher para um novo cluster, siga os passos para migrar o Rancher.

  • Ao restaurar o Rancher na mesma configuração, a implantação do Rancher é escalonada para baixo manualmente antes do início da restauração, e então o operador a escalonará para cima novamente assim que a restauração for concluída. Como resultado, o Rancher e sua interface não estarão disponíveis até que a restauração seja concluída. Enquanto a interface não estiver disponível, use o kubeconfig do cluster original com o arquivo YAML de restauração: kubectl create -f restore.yaml.

Etapa 1: Crie o Recurso Personalizado de Restauração

  1. Clique em ☰ > Gerenciamento de Cluster.

  2. Vá para o cluster local e clique em Explorar.

  3. Na barra de navegação à esquerda, clique em Backups do Rancher  Restaurar.

Se o aplicativo Backups do Rancher não estiver visível, você precisará instalá-lo na página de Charts em Apps. Consulte aqui para mais informações.

  1. Clique em Criar.

  2. Crie a Restauração com o formulário ou com YAML. Para ajuda na criação do recurso de Restauração usando o formulário online, consulte a referência de configuração e os exemplos.

  3. Para usar o editor YAML, você pode clicar em Criar  Criar a partir do YAML. Insira o YAML da Restauração. O seguinte é um exemplo de recurso personalizado de Restauração:

     apiVersion: resources.cattle.io/v1
 kind: Restore
 metadata:
   name: restore-migration
 spec:
   backupFilename: backup-b0450532-cee1-4aa1-a881-f5f48a007b1c-2020-09-15T07-27-09Z.tar.gz
   encryptionConfigSecretName: encryptionconfig
   storageLocation:
     s3:
       credentialSecretName: s3-creds
       credentialSecretNamespace: default
       bucketName: rancher-backups
       folder: rancher
       region: us-west-2
       endpoint: s3.us-west-2.amazonaws.com

    Para ajuda na configuração da Restauração, consulte a referência de configuração e os exemplos.

  4. Clique em Criar.

Resultado: O arquivo de backup é criado e atualizado para o local de armazenamento de destino. Os recursos são restaurados nesta ordem:

  1. Definições de Recursos Personalizados (CRDs)

  2. Recursos com escopo de cluster

  3. Recursos com escopo de namespace

Para verificar como a restauração está progredindo, você pode verificar os logs do operador. Siga estas etapas para obter os logs:

kubectl get pods -n cattle-resources-system
kubectl logs -n cattle-resources-system -f

Etapa 2: Fazer rollback para uma versão anterior do Rancher

O Rancher pode fazer rollback usando o Helm CLI. Para fazer rollback para a versão anterior:

helm rollback rancher -n cattle-system

Se a revisão anterior não for o alvo pretendido, você pode especificar uma revisão para fazer rollback. Para ver o histórico de implantações:

helm history rancher -n cattle-system

Quando a revisão alvo for determinada, execute o rollback. Este exemplo fará rollback para a revisão 3:

helm rollback rancher 3 -n cattle-system