Objectif

Managed Rancher Service par OVHcloud vous permet d'orchestrer vos clusters Kubernetes.

Dans ce guide, vous allez utiliser Rancher pour sauvegarder et restaurer un cluster Kubernetes, prendre un instantané (snapshot) et enregistrer les snapshots etcd récurrents dans un bucket Object Storage OVHcloud.

Prérequis

• Un projet Public Cloud dans votre compte OVHcloud
• Un Managed Rancher Service OVHcloud (consultez le guide Créer un Managed Rancher Service pour plus d'informations)
• Un accès à l'interface Rancher pour l'utiliser (consultez le guide Se connecter à l'interface Rancher pour plus d'informations)
• Un cluster Kubernetes créé ou importé dans Rancher

---

Accès à la console OVHcloud

• Lien direct : Projets
• Pour accéder à vos services : Public Cloud > Sélectionnez votre projet > Stockage > Object Storage

---

Instructions

Dans l'interface Rancher, la sauvegarde et la restauration de l'etcd d'un cluster Kubernetes se réalisent facilement.

Nous vous recommandons de configurer des snapshots etcd récurrents pour tous les clusters de production. Vous pouvez également prendre des snapshots ponctuels.

Les snapshots de la base de données etcd sont pris et enregistrés soit localement sur les nœuds etcd, soit sur une cible compatible S3¹ comme notre Object Storage OVHcloud.

L'avantage de configurer un Object Storage est que si tous les nœuds etcd sont perdus, votre snapshot est enregistré à distance et peut servir à restaurer le cluster.

Créer une sauvegarde sur un Object Storage OVHcloud

Vous devez d'abord disposer d'un bucket Object Storage S3. Si vous n'en avez pas encore, suivez le guide « Premiers pas avec Object Storage ».

Dans ce guide, notre bucket Object Storage est nommé etcd-rancher et sa région est GRA.

Dans l'onglet Conteneurs de la page Object Storage, cliquez sur le nom de votre bucket : l'onglet Vue d'ensemble s'affiche. L'endpoint est affiché dans le champ Endpoint de la section Détails de connexion.

Activer les snapshots de sauvegarde etcd récurrents vers un Object Storage sur un cluster Kubernetes existant

Connectez-vous à l'interface de votre Managed Rancher Service.

Cliquez sur Cluster Management dans le menu.

Pour le cluster choisi, cliquez sur le bouton à trois points, puis sur le bouton Edit Config.

Dans la section Cluster Configuration, cliquez sur l'onglet etcd.
Dans Automatic Snapshots, faites passer le bouton radio de Disable à Enable et modifiez le Cron Schedule selon vos besoins.

Avec cette configuration des snapshots etcd automatiques, vous obtiendrez un snapshot toutes les heures à hh:35 et vous conserverez les 5 derniers snapshots par nœud.

Dans Backup Snapshots to Object Storage, faites passer le bouton radio de Disable à Enable.

Dans la liste Authentication, sélectionnez Create a S3-Compatible Auth Secret. Renseignez l'Object Storage Access Key, l'Object Storage Secret Key et le nom du bucket. Renseignez également la Region (en minuscules).

Renseignez l'endpoint s3.gra.io.cloud.ovh.net :

Enfin, cochez la case Accept any certificate (insecure) et cliquez sur le bouton Enregistrer.

Vérifier les snapshots etcd

Dans Cluster Management, cliquez sur votre cluster.

Pour consulter et récupérer les snapshots de sauvegarde, cliquez sur l'onglet Snapshots.

Le nom du snapshot est généré automatiquement : il repose sur le type (selon que le snapshot est manuel, on-demand, ou récurrent, etcd-snapshot). La convention de nommage est la suivante :

<name>-<node>-<timestamp>

Vous pouvez également vérifier dans la console OVHcloud que les snapshots ont bien été enregistrés : cliquez sur Object Storage sous Stockage dans le menu de gauche de votre projet Public Cloud, cliquez sur le nom de votre bucket dans l'onglet Conteneurs, puis ouvrez son onglet Objets.

Créer un snapshot ponctuel

En complément des snapshots récurrents, vous pouvez souhaiter prendre un snapshot « ponctuel ».

Cela peut être utile, par exemple, avant de mettre à jour la version de Kubernetes d'un cluster ou la version du Service Mesh d'un cluster. De manière générale, il est recommandé de sauvegarder l'état du cluster afin de se prémunir contre un échec de mise à jour.

Dans la vue Cluster Management de l'interface Rancher, cochez la case située à côté de votre cluster Kubernetes et cliquez sur le bouton Take Snapshot.

Restaurer depuis un snapshot

Dans l'onglet Snapshots de votre cluster Kubernetes, dans l'interface Rancher, cliquez sur le bouton Restaurer.

Dans Rancher, vous pouvez choisir différents types de restauration :

• etcd uniquement
• Version de Kubernetes et etcd
• Configuration du cluster, version de Kubernetes et etcd

Dans la fenêtre Restore Snapshot, cliquez sur le type de restauration souhaité, puis sur le bouton Restaurer.

Après un clic sur le bouton, la restauration depuis le snapshot est en cours.

La restauration d'un cluster peut prendre quelques minutes.

Problèmes connus

Failed to test for existence of bucket xxx: Access Denied

Si vous obtenez le message d'erreur suivant : failed to test for existence of bucket etcd-rancher: Access Denied., il se peut que l'endpoint de l'Object Storage soit erroné.

Supprimez le schéma https:// de l'URL de l'endpoint et vérifiez l'URL de l'endpoint de votre bucket Object Storage OVHcloud.

Un endpoint Object Storage correct doit être de la forme s3.gra.io.cloud.ovh.net.

Aller plus loin

• Consultez la documentation officielle Rancher pour en savoir plus sur la sauvegarde et la restauration.

• Pour obtenir une vue d'ensemble de Managed Rancher Service OVHcloud, consultez la page Managed Rancher Service OVHcloud.

• Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

• Notre équipe reste disponible sur notre chaîne Discord dédiée, n'hésitez pas à nous y rejoindre : https://discord.gg/ovhcloud. Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l'équipe qui développe nos services Container et Orchestration.

• Échangez avec notre communauté d'utilisateurs.

¹ : S3 est une marque déposée appartenant à Amazon Technologies, Inc. Les services OVHcloud ne sont pas sponsorisés, approuvés, ou affiliés de quelque manière que ce soit.