Dokumentácia & runbooky: minimum pre prevádzkovateľnú infra

Dokumentácia a runbooky nie sú „papierovanie“. Sú to artefakty, ktoré umožňujú stabilnú prevádzku, auditovateľné zmeny a znižujú závislosť od jednotlivcov.

Cieľ nie je byrokracia – cieľ je rýchla orientácia, jasné rozhodnutia a opakovateľné postupy (triage → akcia → rollback → eskalácia).

Otázky, ktoré si treba zodpovedať

Kde je zdroj pravdy (repo/wiki/CMDB) a kto je zaň zodpovedný?
Máte runbooky pre incidenty, zmeny a obnovu?
Je onboarding nového človeka možný bez dlhého shadowingu?
Sú konfigurácie a postupy verziované?
Je dokumentácia udržiavaná a používaná, alebo jej nikto neverí?

Typické dopady, keď dokumentácia chýba

Incident trvá dlhšie: triage je pomalý a chýbajú overené kroky.
Rizikové zmeny: zmeny sa robia bez dohľadateľnosti a rollbacku.
Single point of knowledge: infra je závislá na 1–2 ľuďoch.
Neauditovateľnosť: ťažko sa preukazuje kto a prečo zasiahol.

Súvisiace: