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.

Restaurer un cluster à partir d’une sauvegarde

La sauvegarde et la récupération d’etcd pour les clusters Kubernetes lancés par Rancher peuvent être facilement effectuées. Les instantanés de la base de données etcd sont pris et sauvegardés soit localement sur les nœuds etcd, soit vers une cible compatible S3. Les avantages de la configuration de S3 sont que si tous les nœuds etcd sont perdus, votre instantané est sauvegardé à distance et peut être utilisé pour restaurer le cluster.

Rancher recommande d’activer la capacité à configurer des instantanés récurrents d’etcd, mais les instantanés uniques peuvent également être facilement effectués. Rancher permet la restauration à partir de instantanés sauvegardés.

Les clusters peuvent également être restaurés à une version Kubernetes antérieure et à une configuration de cluster.

Affichage des instantanés disponibles

La liste de tous les instantanés disponibles pour le cluster est accessible.

  1. Dans le coin supérieur gauche, cliquez sur ☰ > Gestion des clusters.

  2. Dans la page Clusters, allez au cluster où vous souhaitez voir les instantanés et cliquez sur le nom du cluster.

  3. Cliquez sur l’onglet Instantanés. Les instantanés listés incluent un horodatage de leur création.

Restaurer un cluster à partir d’un instantané

Si votre cluster Kubernetes est endommagé, vous pouvez restaurer le cluster à partir d’un instantané.

Les instantanés sont composés des données du cluster dans etcd, de la version Kubernetes et de la configuration du cluster dans le cluster.yml. Ces composants vous permettent de choisir parmi les options suivantes lors de la restauration d’un cluster à partir d’un instantané :

  • Restaurer uniquement le contenu d’etcd: Cette restauration est similaire à la restauration à partir des instantanés dans Rancher avant la version v2.4.0.

  • Restaurer la version etcd et Kubernetes: Cette option doit être utilisée si une mise à niveau de Kubernetes est la raison pour laquelle votre cluster échoue, et que vous n’avez apporté aucun changement à la configuration du cluster.

  • Restaurer les versions etcd, Kubernetes et la configuration du cluster: Cette option doit être utilisée si vous avez changé à la fois la version de Kubernetes et la configuration du cluster lors de la mise à niveau.

Lors du retour à une version Kubernetes antérieure, les options de stratégie de mise à niveau sont ignorées. Les nœuds de travail ne sont pas isolés ou vidés avant d’être rétablis à l’ancienne version de Kubernetes, afin qu’un cluster non sain puisse être restauré plus rapidement à un état sain.

Condition préalable :

Pour restaurer des instantanés depuis S3, le cluster doit être configuré pour prendre des instantanés récurrents sur S3.

  1. Dans le coin supérieur gauche, cliquez sur ☰ > Gestion des clusters.

  2. Dans la page Clusters, allez au cluster où vous souhaitez voir les instantanés et cliquez sur le nom du cluster.

  3. Cliquez sur l’onglet Snapshots pour voir la liste des instantanés enregistrés.

  4. Allez à l’instantané que vous souhaitez restaurer et cliquez sur ⋮ > Restaurer.

  5. Sélectionnez un Type de restauration.

  6. Cliquez sur Restaurer.

Résultat : Le cluster passera en état updating et le processus de restauration des nœuds etcd à partir de l’instantané commencera. Le cluster est restauré lorsqu’il revient à un état active.

Restaurer un cluster à partir d’un instantané lorsque le plan de contrôle/etcd sont complètement indisponibles.

Dans un scénario de récupération après sinistre, le plan de contrôle et les nœuds etcd gérés par Rancher dans un cluster en aval peuvent ne plus être disponibles ou fonctionner. Le cluster peut être reconstruit en ajoutant à nouveau des nœuds de plan de contrôle et etcd, suivi de la restauration à partir d’un instantané disponible.

Si vous avez une défaillance complète du cluster, vous devez supprimer tous les nœuds/machines etcd de votre cluster avant de pouvoir ajouter un "nouveau" nœud etcd pour la restauration.

Si vous utilisez instantanés locaux, il est TRÈS important de vous assurer que vous sauvegardez l’instantané correspondant que vous souhaitez restaurer à partir du dossier /var/lib/rancher/<k3s/rke2>/server/db/snapshots/ sur le nœud etcd que vous allez supprimer. Vous pouvez copier l’instantané sur votre nouveau nœud dans le dossier /var/lib/rancher/<k3s/rke2>/server/db/snapshots/. De plus, si vous utilisez des instantanés locaux et que vous restaurez sur un nouveau nœud, la restauration ne peut pas être effectuée via l’interface utilisateur pour le moment.

  1. Supprimez tous les nœuds etcd de votre cluster.

    1. Dans le coin supérieur gauche, cliquez sur ☰ > Gestion des clusters.

    2. Dans la page Clusters, allez au cluster où vous souhaitez supprimer des nœuds.

    3. Dans l’onglet Machines, cliquez sur ⋮ > Supprimer sur chaque nœud que vous souhaitez supprimer. Au départ, vous verrez les nœuds suspendus dans un état deleting, mais une fois que tous les nœuds etcd sont en cours de suppression, ils seront supprimés ensemble. Cela est dû au fait que Rancher voit tous les nœuds etcd en cours de suppression et procède à "court-circuiter" la logique de suppression sécurisée d’etcd.

  2. Après que tous les nœuds etcd aient été supprimés, ajoutez le nouveau nœud etcd à partir duquel vous prévoyez de restaurer. Attribuez au nouveau nœud le rôle de all (etcd, plan de contrôle et worker).

    • Si le nœud était précédemment dans un cluster, nettoyez le nœud d’abord.

    • Pour les clusters personnalisés, allez à l’onglet Inscription et cochez la case pour etcd, controlplane, and worker. Ensuite, copiez et exécutez la commande d’inscription sur votre nœud.

    • Pour les clusters de pilotes de nœuds, un nouveau nœud est provisionné automatiquement.

      À ce stade, Rancher indiquera qu’une restauration à partir d’un instantané etcd est requise.

  3. Restaurez à partir d’un instantané etcd.

    Comme le nœud etcd est un nœud propre, vous devrez peut-être créer manuellement le chemin /var/lib/rancher/<k3s/rke2>/server/db/snapshots/.

    • Pour les instantanés S3, restaurez en utilisant l’interface utilisateur.

      1. Cliquez sur l’onglet Snapshots pour voir la liste des instantanés enregistrés.

      2. Allez à l’instantané que vous souhaitez restaurer et cliquez sur ⋮ > Restaurer.

      3. Sélectionnez un Type de restauration.

      4. Cliquez sur Restaurer.

    • Pour les instantanés locaux, la restauration via l’interface utilisateur n’est pas disponible.

      1. Dans le coin supérieur droit, cliquez sur ⋮ > Modifier YAML.

      2. L’exemple YAML ci-dessous peut être ajouté sous votre rkeConfig pour configurer la restauration etcd :

          ...
  rkeConfig:
    etcdSnapshotRestore:
      name: <string> # This field is required. Refers to the filename of the associated etcdsnapshot object.
  ...

  4. Après une restauration réussie, vous pouvez augmenter le nombre de vos nœuds etcd jusqu’à la redondance souhaitée.