diff --git a/RUNBOOK-TEMPLATE.md b/RUNBOOK-TEMPLATE.md new file mode 100644 index 0000000..c97a13b --- /dev/null +++ b/RUNBOOK-TEMPLATE.md @@ -0,0 +1,75 @@ +# [Titre du runbook] + +**Instance auteur** : hermes-[tt|nyora|perso] +**Date** : YYYY-MM-DD +**Tags** : [domaine, technologie, ...] +**Statut** : [valide | en-cours | obsolete] + +--- + +## Probleme + +> Decris le probleme rencontre. Sois specifique : symptomes, messages d'erreur exacts, +> contexte (version DSM, kernel, container, etc.) + +--- + +## Contexte et contraintes + +> Particularites de l'environnement qui conditionnent la solution : +> - Version DSM / kernel +> - Limitations specifiques au NAS Synology +> - Dependances existantes + +--- + +## Ce qui NE fonctionne PAS + +> Section OBLIGATOIRE. Sans elle, le runbook n'a pas de valeur reelle. + +| Tentative | Erreur obtenue | Raison de l'echec | +|-----------|----------------|-------------------| +| Solution officielle X | `erreur exacte` | incompatibilite kernel Y | +| Approche Y | `erreur exacte` | manque de dependance Z | + +--- + +## Solution validee + +> La solution qui fonctionne. Commandes exactes, dans l'ordre. + +```bash +# Etape 1 +commande_exacte + +# Etape 2 +commande_exacte +``` + +--- + +## Verification + +> Comment confirmer que ca fonctionne vraiment. + +```bash +# Test de validation +commande_test +# Resultat attendu : xxx +``` + +--- + +## Pieges specifiques DSM / NAS + +> Points d'attention pour toute replication future. + +- Piege 1 +- Piege 2 + +--- + +## References + +- [Lien doc officielle] +- [Lien issue GitHub]