Ce document a été traduit à l'aide d'une technologie de traduction automatique. Bien que nous nous efforcions de fournir des traductions exactes, nous ne fournissons aucune garantie quant à l'exhaustivité, l'exactitude ou la fiabilité du contenu traduit. En cas de divergence, la version originale anglaise prévaut et fait foi.

Retours à l’état initial

Cette page décrit comment revenir à une version précédente de Rancher après une mise à jour.

  • 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.

Suivez les instructions de cette page lorsque :

  • L’instance de Rancher en cours d’exécution a été mise à niveau vers une version plus récente après la sauvegarde.

  • Le cluster en amont (local) est le même que celui où la sauvegarde a été effectuée.

Pour revenir à une version antérieure de Rancher, utilisez l’application Rancher Backups et restaurez Rancher à partir de la sauvegarde.

Rancher doit être démarré avec la version antérieure après un retour à l’état initial.

Une restauration est effectuée en créant une ressource personnalisée de restauration.

Étapes alternatives pour des scénarios spéciaux

Des étapes alternatives doivent être effectuées pour les retours à l’état initial dans les scénarios suivants :

  • Revenir de v2.14.0 et versions ultérieures à une version antérieure de v2.13.x.

Dans Rancher v2.13.0, Rancher Turtles est devenu le gestionnaire par défaut pour les ressources CAPI, remplaçant les contrôleurs cluster-api précédemment intégrés, et dans Rancher v2.14.0, le cluster-api intégré a été complètement supprimé. En conséquence, si vous revenez de Rancher v2.14.0 et versions ultérieures à une version antérieure de Rancher v2.13.x et que vous n’avez pas l’intention de continuer à utiliser Rancher Turtles pour gérer les ressources CAPI, des étapes manuelles supplémentaires peuvent être nécessaires pour utiliser les contrôleurs cluster-api intégrés. À partir de Rancher v2.14.0, Rancher Turtles est le seul gestionnaire pris en charge pour les ressources CAPI.

Dans Rancher v2.14.0, le module cluster-api est mis à niveau de v1.10.6 à v1.12.2. Le cluster-api v1.12.2, à son tour, met à jour les apiVersions de ses définitions de ressources personnalisées (CRDs) de cluster.x-k8s.io/v1beta1 à cluster.x-k8s.io/v1beta2. Les fichiers de sauvegarde de Rancher incluent les CRDs de Cluster API. Lors de la restauration des données de sauvegarde de Rancher v2.13.x vers une grappe locale après une mise à jour vers v2.14.0, l’application Rancher Backup restaure d’abord les CRDs v1beta1. Cela échoue car la version v1beta2 ne peut pas être supprimée des CRDs tant que des ressources personnalisées v1beta2 sont présentes dans le cluster.

Important :

  • Suivez les instructions de cette page pour restaurer Rancher sur le même cluster d’où il a été sauvegardé. Pour migrer Rancher vers un nouveau cluster, suivez les étapes pour migrer Rancher.

  • Lors de la restauration de Rancher sur la même configuration, le déploiement de Rancher est réduit manuellement avant le début de la restauration, puis l’opérateur le remettra à l’échelle une fois la restauration terminée. En conséquence, Rancher et son interface utilisateur seront indisponibles jusqu’à ce que la restauration soit complète. Pendant que l’interface utilisateur est indisponible, utilisez le kubeconfig du cluster d’origine avec le fichier YAML de restauration : kubectl create -f restore.yaml.

Étape 1 : Créer la Ressource Personnalisée de Restauration

  1. Cliquez sur ☰ > Gestion des clusters.

  2. Allez sur la grappe locale et cliquez sur Explorer.

  3. Dans la barre de navigation à gauche, cliquez sur Rancher Backups  Restaurer.

Si l’application Rancher Backups n’est pas visible, vous devrez l’installer depuis la page Charts dans Apps. Référez-vous à ici pour plus d’informations.

  1. Cliquez sur Create.

  2. Créez la restauration avec le formulaire ou avec YAML. Pour obtenir de l’aide pour créer la ressource de restauration à l’aide du formulaire en ligne, référez-vous à la référence de configuration et aux exemples.

  3. Pour utiliser l’éditeur YAML, vous pouvez cliquer sur Créer  Créer à partir de YAML. Entrez le YAML de restauration. Voici un exemple de ressource personnalisée de restauration :

     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

    Pour obtenir de l’aide sur la configuration de la restauration, référez-vous à la référence de configuration et aux exemples.

  4. Cliquez sur Create.

Résultat : Le fichier de sauvegarde est créé et mis à jour vers l’emplacement de stockage cible. Les ressources sont restaurées dans cet ordre :

  1. Définitions de ressources personnalisées (CRDs)

  2. Ressources à portée de cluster

  3. Ressources d’espace de noms

Pour vérifier comment la restauration progresse, vous pouvez consulter les journaux de l’opérateur. Suivez ces étapes pour obtenir les journaux :

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

Étape 2 : Revenir à une version précédente de Rancher

Rancher peut être restauré à l’aide du Helm CLI. Pour revenir à la version précédente :

helm rollback rancher -n cattle-system

Si la révision précédente n’est pas la cible souhaitée, vous pouvez spécifier une révision à laquelle revenir. Pour voir l’historique des déploiements :

helm history rancher -n cattle-system

Lorsque la révision cible est déterminée, effectuez le retour à l’état initial. Cet exemple reviendra à la révision 3 :

helm rollback rancher 3 -n cattle-system