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.

Mises à niveau

Les instructions suivantes vous guideront à travers la mise à niveau d’un serveur Rancher qui a été installé sur un cluster Kubernetes avec Helm. Ces étapes s’appliquent également aux installations isolées physiquement avec Helm.

Pour les instructions de mise à niveau de Rancher installé avec Docker, référez-vous à xref:[cette page.]

Conditions préalables

Accès à kubeconfig

Helm doit être exécuté depuis le même emplacement que votre fichier kubeconfig, ou le même emplacement où vous exécutez vos commandes kubectl.

Si vous avez installé Kubernetes avec RKE2/K3s, le Kubeconfig est stocké dans le répertoire /etc/rancher/rke2/rke2.yaml ou /etc/rancher/k3s/k3s.yaml selon la distribution choisie.

Le kubeconfig peut également être ciblé manuellement pour le cluster prévu avec le tag --kubeconfig (voir : https://helm.sh/docs/helm/helm/)

Examiner les problèmes connus

Consultez la liste des problèmes connus pour chaque version de Rancher, qui peut être trouvée dans les notes de version sur GitHub et sur les forums Rancher.

Version de Helm

Les instructions de mise à niveau supposent que vous utilisez Helm 3.

Pour les installations isolées physiquement : Peupler le registre privé.

Pour les installations isolées physiquement uniquement, collectez et remplissez les images pour la nouvelle version du serveur Rancher. Suivez le guide pour remplir votre registre privé avec les images pour la version de Rancher vers laquelle vous souhaitez mettre à niveau.

Pour les mises à niveau avec cert-manager antérieur à 0.8.0

Let’s Encrypt bloquera les instances de cert-manager antérieures à 0.8.0 à partir du 1er novembre 2019. Mettez à niveau cert-manager vers la dernière version en suivant ces instructions.

Aperçu de la mise à niveau

Suivez les étapes pour mettre à niveau le serveur Rancher :

1. Sauvegardez votre cluster Kubernetes qui exécute le serveur Rancher

Utilisez l’application de sauvegarde pour sauvegarder Rancher.

Vous utiliserez la sauvegarde comme point de restauration si quelque chose ne va pas pendant la mise à niveau.

2. Mettez à jour le dépôt de graphiques Helm

  1. Mettez à jour le cache de votre dépôt Helm local.

    helm repo update

  2. Obtenez le nom du dépôt que vous avez utilisé pour installer Rancher.

    helm repo list

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

  3. Récupérez le dernier graphique pour installer Rancher à partir du dépôt de graphiques Helm.

    Cette commande téléchargera les derniers graphiques et les enregistrera dans le répertoire actuel sous forme de fichier .tgz.

     helm fetch rancher-prime/rancher

    Vous pouvez récupérer le graphique pour la version spécifique à laquelle vous mettez à niveau en ajoutant le tag --version=. Par exemple :

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

3. Examinez les versions des graphiques de fonctionnalités de Rancher avant la mise à niveau

Les graphiques de fonctionnalités de Rancher suivent des lignes de publication spécifiques qui s’alignent sur les versions de Rancher. Les versions majeures des graphiques de fonctionnalités correspondent aux versions mineures de Rancher et suivent un schéma de versionnement défini.

Avant de mettre à niveau Rancher, examinez tous les graphiques de fonctionnalités de Rancher installés et mettez-les à jour vers la dernière version disponible dans leur ligne de publication de graphique actuelle. Cela aide à garantir la compatibilité et évite les problèmes potentiels pendant ou après la mise à niveau de Rancher.

Pour examiner les graphiques de fonctionnalités installés :

  1. Dans l’interface utilisateur de Rancher, allez à Apps & Marketplace.

  2. Sélectionnez Applications installées.

  3. Examinez les versions des graphiques et mettez à jour vers la dernière version de correctif dans la même version majeure de graphique si nécessaire.

Pour plus d’informations, consultez le Graphiques Helm dans Rancher – Schéma de versionnement.

4. Mettre à niveau Rancher

Cette section décrit comment mettre à niveau les installations normales (connectées à Internet) ou isolées physiquement de Rancher avec Helm.

Instructions pour l’isolation physique :

Si vous installez Rancher dans un environnement isolé physiquement, ignorez le reste de cette page et générez le modèle Helm en suivant les instructions sur cette page.
Mise à niveau depuis Rancher v2.13.1

Dans Rancher v2.13.2, le nom du graphique Helm est revenu de rancher-prime à rancher. Si vous mettez à niveau depuis v2.13.1, la ressource Ingress existante créée par le graphique précédent entre en conflit avec le nouveau, ce qui entraîne l’échec de la mise à niveau avec une erreur similaire à :

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

Pour prévenir ou résoudre ce problème, vous devez supprimer manuellement l’ancien Ingress avant de terminer la mise à niveau :

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

Obtenez les valeurs, qui ont été passées avec --set, à partir du graphique Helm Rancher actuel qui est installé.

helm get values rancher -n cattle-system

hostname: rancher.my.org

Il y aura plus de valeurs qui seront listées avec cette commande. Ceci est juste un exemple d’une des valeurs.

Votre nom de déploiement peut varier ; par exemple, si vous déployez Rancher via le Marketplace AWS, le nom de déploiement est 'rancher-prime'. Ainsi :

helm get values rancher-prime -n cattle-system

hostname: rancher.my.org

Si vous mettez à niveau cert-manager vers la dernière version depuis v1.5 ou inférieure, suivez les documents de mise à niveau de cert-manager pour apprendre comment mettre à niveau cert-manager sans avoir besoin de désinstaller ou de réinstaller Rancher. Sinon, suivez les étapes pour mettre à niveau Rancher ci-dessous.

Étapes pour mettre à niveau Rancher

Mettez à niveau Rancher vers la dernière version avec tous vos paramètres.

Prenez toutes les valeurs de l’étape précédente et ajoutez-les à la commande en utilisant --set key=value.

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

Ce qui précède est un exemple, il peut y avoir plus de valeurs de l’étape précédente qui doivent être ajoutées.

Si vous déployez Rancher via le Marketplace AWS, le nom de déploiement est 'rancher-prime'. Ainsi :

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

Alternativement, il est possible d’exporter les valeurs actuelles vers un fichier et de référencer ce fichier lors de la mise à niveau. Par exemple, pour ne changer que la version de Rancher :

  1. Exportez les valeurs actuelles vers un fichier :

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

  2. Mettez à jour uniquement la version de Rancher :

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

5. Vérifiez la mise à niveau

Connectez-vous à Rancher pour confirmer que la mise à niveau a réussi.

Problèmes de mise à niveau connus

Une liste des problèmes connus pour chaque version de Rancher peut être trouvée dans les notes de version sur GitHub et sur les forums de Rancher.