Documentation informatique : un outil souvent sous-estimé

Lorsqu'un incident survient, retrouver rapidement les informations sur l'infrastructure peut faire une vraie différence. Pourtant, les schémas réseau, les procédures et les inventaires sont parfois incomplets ou dispersés dans plusieurs documents.
Quelles informations conserver ?
Une documentation utile décrit les équipements, leurs fonctions, leurs adresses, les services hébergés et les principales dépendances. Elle peut également inclure les contacts techniques, les contrats associés et les dates de renouvellement importantes.
Des procédures faciles à suivre
Les opérations courantes méritent d'être décrites : ajouter un utilisateur, vérifier une sauvegarde, redémarrer un service ou déclarer un incident. Les consignes doivent être suffisamment précises pour être comprises par une autre personne que leur auteur.
Une documentation utile est celle que l'on peut retrouver et comprendre au moment où l'on en a besoin.
Mettre à jour au fil des changements
Un document qui ne suit pas les évolutions de l'infrastructure peut devenir trompeur. Il est donc préférable de mettre à jour les informations après chaque modification importante et de désigner un responsable de leur suivi.
Cette discipline facilite les interventions, les audits et la transmission des connaissances. Elle est particulièrement utile lorsque plusieurs personnes ou prestataires interviennent sur le même environnement.
Commentaires (3)
Très bon retour d'expérience. Le coup du `pg_advisory_lock` au lieu du `sleep`, c'est tellement vrai. On a eu le même souci sur un projet Django.
Merci Thomas ! Oui, on a mis du temps à comprendre pourquoi le `sleep` bloquait nos workers de façon aléatoire. Depuis, on ne jure que par l'idempotence.
Est-ce que vous recommandez Wazuh pour une infra de moins de 10 serveurs ? Ou c'est trop lourd à maintenir ?
