nas-runbooks/common/PROTOCOL-INFRA.md

PROTOCOL-INFRA — Regles operationnelles infra

Protocole post-deployement (OBLIGATOIRE)

Apres tout deployement reussi ou probleme resolu, avant de cloturer la mission :

1. Creer un runbook dans le repo Gitea bolbol/nas-runbooks

   • Ecrire UNIQUEMENT dans le dossier hermes-[identite]/
   • Utiliser le template /opt/data/RUNBOOK-TEMPLATE.md
   • La section "Ce qui NE fonctionne PAS" est OBLIGATOIRE

2. Poster une note NyoraNotes

   • Tags : [infra, runbook]
   • Contenu : resume du probleme, solution, lien runbook Gitea

3. Mettre a jour _INDEX.md dans nas-runbooks

   • Ajouter l entree dans le tableau de l instance

4. git add . && git commit && git push vers Gitea

Regle de contribution

• Ecriture : chaque instance ecrit UNIQUEMENT dans son dossier hermes-[nom]/
• Lecture : tous les dossiers sont accessibles en lecture
• Le runbook sans les echecs n a pas de valeur — toujours documenter les tentatives infructueuses

Acces Gitea nas-runbooks

URL clone : http://192.168.100.33:3232/bolbol/nas-runbooks.git Dossier local suggere : /opt/data/workspace/nas-runbooks/

---

REGISTRE DES SERVICES — Mise a jour obligatoire

Le fichier /volume1/docker/ports-registry.md est la source de verite de l'etat du NAS. Il contient deux sections distinctes a maintenir en permanence :

1. SERVICES ACTIFS (en tete du fichier)

Mise a jour OBLIGATOIRE a chaque installation OU desinstallation :

• Installation : ajouter la ligne avec statut ACTIF, port, domaine, notes
• Desinstallation : changer le statut en "DESINSTALLE JJ/MM/AAAA", liberer le port
• Ne JAMAIS supprimer une ligne — les services desinstalles restent visibles avec leur date

2. Historique des modifications (fin du fichier)

Ajouter une ligne datee pour CHAQUE action :

• Format : | AAAA-MM-JJ | ACTION | Port | Service |
• Actions a documenter : Deploiement, DESINSTALLATION, Migration, Changement de port

Verification avant documentation

Avant de marquer un service comme DESINSTALLE, TOUJOURS verifier : curl --max-time 4 http://172.17.0.1: -o /dev/null -w "HTTP %{http_code}" Si le port repond → le service est encore actif → NE PAS marquer DESINSTALLE

Chemin du fichier

• Copie locale NAS : /volume1/docker/ports-registry.md
• Copie nas-runbooks : /volume1/docker/nas-runbooks/common/ports-registry.md
• Les deux doivent rester synchronisees (copier l'un vers l'autre apres modification)
• Push Gitea obligatoire apres toute modification