En administration système et DevOps, ne rien documenter, c’est se condamner à réinventer la roue à chaque incident ou réinstallation. Dès mon BTS SIO et tout au long de mon alternance au MEAE, j’ai pris le réflexe de consigner méthodiquement mes configurations, mes mémos de commandes et mes retours d’expérience.
Ce wiki personnel me sert de second cerveau technique au quotidien : il me permet de retrouver une procédure en quelques secondes et de la partager facilement avec mes collègues.
Organisation du contenu
Le wiki regroupe plusieurs catégories claires :
- Systèmes & Réseaux : fiches mémo Linux (Debian, Arch), segmentation VLAN, règles de pare-feu et configurations réseau.
- Conteneurs & Cloud : guides de déploiement Docker Compose, manifests Kubernetes / K3s et recettes d’infrastructures.
- Supervision & Sécurité : instrumentation Prometheus, dashboards Grafana et durcissement des accès (SSH, 2FA, CrowdSec).
- Projets personnels : retours d’expérience sur mon homelab et notes personnelles (organisation, escalade, course à pied).
Moteur et automatisation
Pour garder un système rapide, pérenne et sans base de données à administrer, j’ai fait le choix de MkDocs Material :
- Rédaction en Markdown : chaque page est un simple fichier texte versionné dans un dépôt Git privé. La rédaction se fait directement dans mon éditeur de code favori.
- Recherche instantanée : MkDocs intègre un moteur d’indexation côté client ultra-rapide, sans nécessiter de serveur de recherche dédié.
- Pipeline CI/CD : à chaque commit sur le dépôt, un workflow GitHub Actions valide la syntaxe, compile les pages statiques et construit une image conteneurisée.
- Hébergement sécurisé : le conteneur tourne sur mon serveur derrière le reverse-proxy Traefik avec gestion automatique du certificat SSL Let’s Encrypt.
Accès
La documentation publique est consultable à cette adresse : https://docs.rocheralexandre.com