add: PROTOCOL-INFRA.md - regles infra + registre services actifs
This commit is contained in:
parent
540d6d833b
commit
0ffe644b21
|
|
@ -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:<PORT> -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
|
||||||
|
|
||||||
Loading…
Reference in New Issue