Runbook MEP
À quoi sert cet écran
Un runbook est la suite ordonnée d’étapes qui met une release en production. Plutôt que quelqu’un travaillant de mémoire ou depuis une page de wiki, le runbook s’exécute dans Fenwave : il a un statut, il consigne chaque exécution, et n’importe qui peut voir jusqu’où il est allé.
Le runbook MEP s’atteint depuis une release, et existe aussi comme page autonome pour être ouvert directement pendant une exécution.
Avant de commencer
| Pour faire ceci | Il vous faut |
|---|---|
| Consulter une release et son runbook | deployment-manager.release.view.details |
| Agir sur un runbook | deployment-manager.release.view.details.quick-actions |
La release doit exister au préalable — voir Releases.
Ouvrir l’écran
- Autonome :
/deployment-manager/mep/:releaseId - Intégré : l’onglet Execution History d’une release
Les deux affichent le même contenu. La page autonome ajoute l’en-tête, ce qui en fait la meilleure à garder ouverte sur un second écran pendant l’exécution.
L’interface
📸 Capture d’écran : La page Runbook MEP pendant une exécution. Repères : (1) le nom du runbook, (2) le statut, (3) la liste des étapes avec leur progression, (4) l’historique d’exécution.
| # | Élément | Ce qu’il fait | Quand l’utiliser |
|---|---|---|---|
| 1 | Nom du runbook | Identifie ce runbook | Toujours |
| 2 | Statut | Son état courant, dont in progress | La première chose à lire |
| 3 | Étapes | Les étapes ordonnées et leur progression | Pendant l’exécution |
| 4 | Historique d’exécution | Les exécutions précédentes | Pour répondre à « cela a-t-il déjà été tenté ? » |
Tant que le statut est in progress, la page interroge le serveur et se met à jour seule. Inutile de recharger — et recharger pendant une exécution est le meilleur moyen de perdre le fil.
Procédures
Exécuter une release
Nécessite deployment-manager.release.view.details.quick-actions.
- Ouvrez la release, allez dans Execution History, ou ouvrez la page autonome du runbook.
- Démarrez le runbook.
- Suivez les étapes. La page se met à jour d’elle-même tant qu’elle est en cours.
- À la fin, vérifiez le résultat face à Production.
Abandonner une exécution
Abandonnez depuis les mêmes contrôles. L’abandon arrête le runbook ; il n’annule pas les étapes déjà effectuées. Traitez un abandon comme un « on s’arrête ici », puis décidez délibérément quoi faire de ce qui a déjà eu lieu.
Vérifier si cela a déjà été tenté
Ouvrez le runbook et lisez l’historique d’exécution. Une release exécutée, abandonnée puis relancée raconte une histoire que le statut seul ne dit pas.
Scénario
Un runbook s’est arrêté en cours de route, à 2 h du matin, et vous venez de prendre le relais.
- Ouvrez la page autonome du runbook de la release. Lisez d’abord le statut : in progress, abandonné ou en échec sont trois situations différentes.
- Lisez les étapes. Trouvez la dernière qui s’est terminée. C’est elle, et non le message d’erreur, qui vous dit dans quel état se trouve réellement le système.
- Lisez l’historique d’exécution. Si cette release a déjà été exécutée, la tentative précédente peut expliquer sur quoi bute la tentative en cours.
- Consultez l’onglet Deployments de la release — ce qui est réellement parti avant l’arrêt.
- Vérifiez face à l’onglet Events de Production. La réalité et le runbook devraient concorder ; là où ce n’est pas le cas, croyez l’environnement et notez l’écart.
- Décidez : reprendre, ou abandonner et revenir en arrière. Faites-le via le runbook, pour que l’enregistrement reste exact pour la personne qui prendra le relais après vous.
L’étape 2 est celle à retenir. À 2 h du matin, l’instinct est de lire l’erreur et d’agir dessus ; c’est la dernière étape terminée qui vous dit où vous en êtes.
En cas de problème
| Symptôme | Cause | Comment vérifier | Solution |
|---|---|---|---|
| La page ne propose rien à exécuter | Aucun runbook n’a été créé pour cette release | L’onglet Execution History de la release | Créez le runbook depuis la release |
| Le statut ne se met pas à jour | Le runbook n’est pas en cours, l’interrogation s’est donc arrêtée | Le statut | Comportement attendu — l’interrogation n’a lieu qu’en cours d’exécution |
| Impossible de démarrer ou d’abandonner | Il manque release.view.details.quick-actions |
Access Explorer | Demandez-la ; la consultation seule ne suffit pas |
| Abandonné, mais les changements sont toujours en ligne | L’abandon arrête le runbook, il n’annule pas les étapes terminées | La liste des étapes et l’onglet Deployments | Revenez en arrière délibérément ; l’abandon n’est pas un rollback |
| Le runbook dit terminé, l’environnement dit non | Quelqu’un a agi hors du runbook | Les Events de Production | Réconciliez, et consignez ce qui a été fait |
Pour aller plus loin
- Releases — la release exécutée par ce runbook
- Production — là où le résultat atterrit