From 0ffe644b210f204debe406565323dfd8cb929cb6 Mon Sep 17 00:00:00 2001 From: bolbol Date: Tue, 16 Jun 2026 08:04:28 +0000 Subject: [PATCH] add: PROTOCOL-INFRA.md - regles infra + registre services actifs --- common/PROTOCOL-INFRA.md | 58 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 common/PROTOCOL-INFRA.md diff --git a/common/PROTOCOL-INFRA.md b/common/PROTOCOL-INFRA.md new file mode 100644 index 0000000..caef0f6 --- /dev/null +++ b/common/PROTOCOL-INFRA.md @@ -0,0 +1,58 @@ +# 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 +