L'exemple suivi dans ce wiki vit dans un dépôt Git privé, documenté à chaque étape depuis son
premier incrément — pas reconstruit après coup pour les besoins de ce wiki. Cette page décrit sa
structure et ses conventions, pour que tu puisses reproduire le même modèle sur ton propre
projet, sans qu'un lien de clonage soit nécessaire ni fourni ici.
mon-homelab/
├── docs/ # Documentation technique, complète, non anonymisée
│ ├── 00-plateformes.md # Vue d'ensemble : quelle machine fait quoi
│ ├── 01-... # Un chapitre par sujet, numéroté dans l'ordre
│ ├── ...
│ ├── 99-troubleshooting.md # Synthèse des pannes rencontrées -- un runbook vivant
│ └── sprints/ # Journal de bord au fil de l'eau (voir M8)
│ ├── backlog.md
│ ├── sprint-01.md
│ └── ...
├── stacks/ # Un compose.yaml par service
│ ├── npm.yml
│ ├── portainer.yml
│ ├── uptime-kuma.yml
│ └── monitoring.yml
├── outils/ # Scripts de vérification et d'automatisation du dépôt lui-même
├── .gitignore # *.env, secrets/, certs/ -- jamais versionnés (M7)
└── README.md
docs/ : la documentation technique complèteChaque fichier docs/NN-sujet.md couvre un sujet précis, avec la notion générale et la mise en
œuvre réelle (chemins, choix effectifs) — cette couche reste privée, contrairement à un wiki
public comme celui-ci, qui n'en garde que la notion anonymisée. C'est cette séparation qui
permet d'avoir une documentation technique complète en interne, sans jamais avoir à choisir
entre précision et confidentialité.
docs/sprints/ : le journal de bordUn fichier par période de travail, avec les décisions prises, leur « pourquoi », les pièges
rencontrés et ce qui reste à faire — exactement la pratique recommandée en
M8 — Journal de bord, appliquée depuis le
premier incrément de ce projet plutôt que découverte après coup.
stacks/ : un fichier par serviceChaque service a son propre compose.yaml, suivant systématiquement les mêmes conventions
détaillées en M4 : tag figé, bind
mount vers un chemin explicite, réseau partagé déclaré en externe, port publié en local sauf
besoin explicite.
/srv/docker/...), les noms de domaine .internal, les adresses IP —docs/ + docs/sprints/ + stacks/, indépendante des services précis choisis.compose.yaml (tag figé, bind mount, réseau externe, port en local).Cette formation est proposée par Deladev, studio web de Loïc D. — création de sites et d'applications, accompagnement et formation sur mesure.
Les projets réalisés · Prestations et tarifs · Le blog tech · Me contacter
Écrite par Loïc D. avec l'assistance de Claude (Anthropic) — un travail à deux.
© 2026 Deladev — publiée sous licence CC BY-NC-ND 4.0. Vous pouvez la lire, y renvoyer par un lien, la partager et la citer en créditant la source. La revendre, l'utiliser dans une prestation ou une formation payante, la republier même partiellement ailleurs, en diffuser une version modifiée ou l'exploiter pour entraîner un modèle d'IA nécessitent une autorisation écrite — pour un usage interne en entreprise, c'est souvent oui, il suffit de demander.