Mise à niveau vers Chaos Mesh 2.0
Cette page a été traduite par PageTurner AI (bêta). Non approuvée officiellement par le projet. Vous avez trouvé une erreur ? Signaler un problème →
Ce document fournit des instructions détaillées pour mettre à niveau Chaos Mesh de la version 1.x à la 2.0. Chaos Mesh 2.0 introduit de nouvelles fonctionnalités et corrige de nombreux problèmes. En raison de la refonte partielle du code dans cette version, des actions supplémentaires sont nécessaires pour effectuer la mise à niveau.
Outils de mise à niveau
Les définitions CRD ayant changé dans Chaos Mesh 2.0, les fichiers YAML d'expériences des versions antérieures ne sont plus exécutables. Pour continuer à les utiliser, vous devez les exporter, les mettre à jour, puis les réimporter après la mise à niveau de Chaos Mesh.
Pour simplifier ce processus, Chaos Mesh 2.0 fournit les outils suivants :
-
migrate.sh: exporte et met à niveau automatiquement les fichiers YAML, met à jour les CRD, et importe les fichiers YAML mis à jour. -
schedule-migration: convertit les fichiers YAML antérieurs vers le nouveau format.
Pour obtenir ces outils, il est recommandé de cloner le projet Chaos Mesh dans votre dépôt local et d'exécuter la commande make schedule-migration.tar.gz. Vous pouvez également télécharger l'archive depuis https://mirrors.chaos-mesh.org/v2.0.0/schedule-migration.tar.gz. Après le téléchargement du package tar.gz, exécutez la commande suivante pour obtenir les deux outils de mise à niveau :
tar xvf ./schedule-migration.tar.gz
L'outil schedule-migration de ce package fonctionne exclusivement sur Linux x86_64. Pour d'autres systèmes d'exploitation ou architectures, vous devrez compiler le code vous-même.
Étape 1 : Exporter et mettre à niveau une expérience
Utilisez l'outil migrate.sh pour exporter et mettre à niveau automatiquement vos expériences. Vérifiez au préalable que vous disposez des droits nécessaires pour accéder au cluster.
Si migrate.sh est dans le répertoire courant, placez-y également schedule-migration. Exécutez ensuite la commande suivante :
bash migrate.sh -e
Des fichiers YAML sont générés dans le répertoire courant. Il s'agit des expériences exportées, automatiquement mises à niveau.
Vous pouvez également utiliser schedule-migration pour mettre à niveau des fichiers YAML spécifiques :
./schedule-migration <path-to-old-yaml> <path-to-new-yaml>
Les fichiers mis à niveau sont disponibles dans le chemin spécifié. Supprimez les anciennes ressources, puis appliquez les nouveaux fichiers YAML pour finaliser la mise à jour.
Étape 2 : Mettre à niveau les CRD
Avant la mise à niveau de Chaos Mesh via Helm, exécutez cette commande pour mettre à jour manuellement les CRD et augmenter les chances de succès :
bash migrate.sh -c
Vous constaterez que les CRD sont supprimées puis réajoutées.
Étape 3 : Mettre à niveau Chaos Mesh
Chaos Mesh 2.0 comporte de nombreuses modifications par rapport à la 1.x. Nous recommandons de désinstaller complètement la version 1.x avant d'installer la 2.0. Pour les étapes d'installation, référez-vous à Installer avec Helm (recommandé pour les environnements de production).
Étape 4 : Importer une expérience
Chaos Mesh 2.0 modifie la définition des expériences. Vous devez impérativement mettre à niveau vos fichiers d'expérience avant de les réutiliser.
Dans le répertoire contenant les fichiers exportés, exécutez cette commande pour importer l'expérience :
bash migrate.sh -i
Signaler des problèmes
Si vous rencontrez des difficultés lors de la mise à niveau, partagez les logs de commande sur Slack ou créez une issue GitHub. Merci pour votre retour ! L'équipe Chaos Mesh se fera un plaisir de vous aider.