> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/fr/operations/sop-update.md). # Guide de mise à jour de version VergeOS Ce guide fournit les meilleures pratiques pour mettre à jour en toute sécurité un système VergeOS vers une nouvelle version ponctuelle. Il met l’accent sur la sécurité des données et la résilience du système grâce à une approche méthodique. {% hint style="info" %} **Vue d'ensemble** La mise à jour de votre système VergeOS nécessite une planification et une exécution minutieuses afin de garantir une perturbation minimale de vos services. Ce guide décompose le processus en grandes phases : 1. **Préparation** - Étapes à suivre avant votre fenêtre de maintenance planifiée 2. **Vérification préalable à la mise à jour** - Vérifications finales immédiatement avant de commencer la mise à jour 3. **Exécution de la mise à jour** - Le processus d’installation de la mise à jour 4. **Vérification après la mise à jour** - S’assurer que la mise à jour a réussi {% endhint %} {% hint style="info" %} **Exigences spécifiques à l'environnement** Ce guide présente les meilleures pratiques générales. Vous devrez peut-être adapter ces étapes à votre environnement et à vos exigences spécifiques. {% endhint %} ## Prérequis * Accès administrateur au système VergeOS * Accès IPMI à tous les nœuds du cluster * Connectivité réseau pour les téléchargements de mise à jour * **Temps estimé :** 1 à 2 heures selon la taille du cluster et la complexité de la mise à jour ## Phase de préparation Effectuez ces étapes bien avant votre fenêtre de maintenance planifiée : ### Préparation du système * [ ] Assurez-vous que la rétention des instantanés du système est suffisante pour un éventuel retour arrière * [ ] Définissez des critères précis de réussite et de vérification pour vos charges de travail * [ ] Identifier les cohortes de VM, services, etc. requises pour votre cas d’utilisation particulier {% hint style="info" %} **Exemples de cas d’utilisation** La VDI peut comporter plusieurs images distinctes ou pools de ressources. La VPS peut se concentrer davantage sur les fonctionnalités réseau et la connectivité. {% endhint %} * [ ] Cartographier les événements système et invités sensibles au temps qui doivent continuer à fonctionner ### Documentation et planification * [ ] Mettre à jour la documentation de la plateforme avec la fenêtre de maintenance planifiée * [ ] Examiner les mises à jour/mises à niveau synergiques qui pourraient devoir être exécutées * Évitez de combiner des mises à jour inutiles * [ ] Consultez les notes de version et prévoyez tout impact spécifique * [ ] Documenter la configuration actuelle du système comme référence pour le retour arrière * [ ] Planifiez le calendrier de communication pour les utilisateurs concernés ### Vérification des ressources * [ ] Vérifiez l’utilisation des ressources du cluster * Assurez-vous que votre système dispose de suffisamment de ressources libres pour perdre son plus gros nœud * [ ] Confirmer les chemins réseau entre les hôtes * Sur chaque nœud : Diagnostics du nœud -> Configuration Fabric (tous les chemins de tous les nœuds doivent être « confirmed:true ») * [ ] Si la redondance réseau n’a pas été testée récemment, planifiez un test avant la mise à jour * [ ] Confirmer l’accès IPMI à tous les hôtes via une méthode permettant l’accès à la console en cas d’urgence ### Préparation de la mise à jour 1. Dans VergeOS, accédez à **Système > Mises à jour** 2. Cliquez sur **Rechercher des mises à jour** 3. Téléchargez la mise à jour (elle ne démarrera pas tant que vous n’aurez pas cliqué sur « Installer ») 4. Enregistrer la version actuelle et la version cible pour la documentation ## Vérification préalable à la mise à jour Effectuez ces vérifications le jour de la maintenance planifiée, avant de commencer la mise à jour : ### Vérification de l'état actuel * [ ] Confirmer que la version en cours d’exécution est bien celle attendue * [ ] Vérifier les journaux pour détecter les erreurs récentes * Noter tout problème non critique * Annuler si des erreurs critiques sont détectées * [ ] Vérifier que la disponibilité des ressources répond aux exigences N+1 * Confirmer que l’utilisation de la RAM permet aux charges de travail de s’exécuter avec un nœud hors ligne * [ ] Vérifier que les snapshots système sont récents et disponibles * Définir l’expiration du snapshot le plus récent à plusieurs jours dans le futur pour une rétention supplémentaire * [ ] Confirmer que la synchronisation multi-site est fonctionnelle et à jour * [ ] Vérifiez que tous les niveaux vSAN sont en bon état (statut vert) * [ ] Confirmez qu’aucun nœud n’attend un redémarrage * [ ] Enregistrer la base de référence des performances du système pour la comparaison après la mise à jour ### Vérification de la mise à jour * [ ] Confirmez votre mise à jour préparée dans **Système > Mises à jour** * [ ] Rechercher à nouveau des mises à jour * S’il existe une autre mise à jour, évaluez-la soigneusement avant de continuer * [ ] Vérifier que l’espace disque est suffisant pour le processus de mise à jour * [ ] Confirmer que tous les nœuds sont accessibles et réactifs ## Phase d'exécution ### Installation de la mise à jour Le processus de mise à jour proprement dit : 1. Accédez à **Système > Mises à jour** 2. Cliquez sur **Installation** pour commencer le processus de mise à jour 3. **Surveiller le nœud 1** pendant qu’il : * Se met automatiquement en mode maintenance * Redémarre et applique la mise à jour * Revient en service 4. **Observer les nœuds suivants** pendant que le système continue à mettre à jour et à redémarrer les nœuds 5. **Surveiller les charges de travail** et l’utilisation des ressources système tout au long du processus 6. **Suivre la progression** - chaque nœud se mettra à jour séquentiellement pour maintenir la disponibilité du service {% hint style="success" %} **Suivi de la mise à jour** Pendant le processus de mise à jour, vous pouvez suivre la progression dans la section Système > Mises à jour. Chaque nœud affichera son statut actuel et sa progression à travers les étapes de la mise à jour. {% endhint %} {% hint style="warning" %} **Ne pas interrompre** N’éteignez pas les nœuds et n’interrompez pas le processus de mise à jour une fois qu’il a commencé. Laissez chaque nœud terminer naturellement son cycle de mise à jour. {% endhint %} ## Vérification après la mise à jour Une fois la mise à jour terminée, vérifiez que le système fonctionne correctement : ### Confirmation de la version * [ ] Confirmer la version attendue dans **Système > Mises à jour** * Vérifiez que les paquets suivants sont à la version attendue : * **osm** (données OpenStreetMap) * **yb** (pile logicielle cloud Verge.io) * **yb-help** (aide et documentation intégrées) * **ybos** (système d’exploitation Verge.io) ### Vérifications de l'état du système * [ ] Confirmer que la tuile « Nodes Updated » dans **Système > Mises à jour** est verte et que tous les nœuds ont terminé * [ ] S’assurer que tous les niveaux vSAN affichent un statut vert * [ ] Vérifier que tous les nœuds affichent un statut vert « Running » * Confirmer que les nœuds n’ont aucun redémarrage en attente * [ ] Testez/confirmez les systèmes invités selon les besoins et conformément à vos critères de réussite * [ ] Prendre un snapshot manuel avec plusieurs jours de rétention * [ ] Vérifiez les journaux pour détecter tout événement nouveau ou inattendu * [ ] Vérifiez tous les critères de réussite définis dans vos étapes de préparation * [ ] Confirmer que les performances du système correspondent à la base de référence ou la dépassent ### Tests de fonctionnalité * [ ] Tester les opérations critiques des VM (démarrage, arrêt, migration) * [ ] Vérifier la connectivité et les performances du réseau * [ ] Confirmer que les opérations de sauvegarde et de snapshot fonctionnent * [ ] Tester toute intégration ou automatisation personnalisée ## Dépannage ### Problèmes courants **Le processus de mise à jour se bloque sur un nœud** * Vérifier l’accessibilité du nœud via IPMI * Consulter les journaux système pour les messages d’erreur * Vérifier la connectivité réseau vers le nœud bloqué * Contacter le support si le nœud reste non réactif **Incohérence de version après la mise à jour** * Accorder du temps supplémentaire pour que tous les composants se synchronisent * Vérifier si des installations de paquets ont échoué * Vérifiez la connectivité réseau entre les nœuds * Consulter les journaux de mise à jour pour des erreurs spécifiques **Dégradation des performances après la mise à jour** * Comparer avec la base de référence d’avant mise à jour * Vérifier l’apparition de nouvelles contraintes de ressources * Examiner l’état et les performances des niveaux vSAN * Surveiller pendant 24 à 48 heures pour établir une nouvelle base de référence **Les VM ne parviennent pas à démarrer après la mise à jour** * Vérifier la compatibilité de la configuration des VM * Vérifier l’accessibilité du niveau de stockage * Consulter les journaux spécifiques à la VM pour détecter des erreurs * Tester individuellement les opérations des VM ## Procédure de retour arrière {% hint style="warning" %} **Considérations sur le retour arrière** Si des problèmes surviennent, l’approche la plus sûre consiste à faire une pause, à enquêter sur le comportement inattendu, puis à reprendre avec une compréhension claire du problème. Les mises à jour VergeOS sont conçues pour être compatibles vers l’avant, et le retour arrière n’est pas toujours possible. {% endhint %} ### Si des problèmes surviennent 1. **Documenter le problème** en détail avec des captures d’écran et des journaux 2. **Isoler le problème** - déterminer s’il affecte tous les nœuds ou seulement des composants spécifiques 3. **Contactez le support** avant d’essayer toute procédure de retour arrière 4. **Préserver l’état du système** pour l’analyse de dépannage 5. **Suivre les recommandations du support** pour la résolution ou les procédures de retour arrière ## Étapes suivantes Après la réussite de la mise à jour : * [ ] Mettre à jour la documentation du système avec les nouvelles informations de version * [ ] Planifier une surveillance de routine pour garantir la stabilité * [ ] Examiner les nouvelles fonctionnalités ou modifications introduites dans la mise à jour * [ ] Planifier les futures mises à jour en fonction des calendriers de publication * [ ] Mettre à jour les procédures de sauvegarde et de reprise après sinistre si nécessaire {% hint style="danger" %} **Support d'urgence** Si vous rencontrez des problèmes avec votre mise à jour logicielle VergeOS, veuillez contacter [notre équipe support](/overview/fr/support-and-services.md) pour une assistance immédiate. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/fr/operations/sop-update.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.