Najważniejsze wnioski
- Dokumentacja powinna opisywać stan faktyczny, nie planowane rozwiązania.
- Najważniejsze są zależności, dostęp, kopie i procedury awaryjne.
- Hasła przechowuj w menedżerze sekretów, nie w zwykłym dokumencie.
- Każda zmiana infrastruktury powinna aktualizować odpowiedni wpis.
Co dokumentować?
Infrastruktura
Serwery, sieci, VLAN, adresacja, urządzenia i lokalizacje.
Usługi
Systemy, właściciele, zależności, licencje i dostawcy.
Dostęp
Role, konta administracyjne, MFA i sposób zatwierdzania zmian.
Awaria
Kontakty, kolejność odtwarzania, backup i procedury eskalacji.
Jak przechowywać dokumentację?
Wybierz jedno kontrolowane miejsce z wersjonowaniem i ograniczonym dostępem. Rozdziel informacje ogólne od sekretów. Ustal właściciela dokumentacji, częstotliwość przeglądów i sposób oznaczania nieaktualnych wpisów.
Dokumentacja nie jest kopią zapasową
Pliki opisujące środowisko również powinny mieć backup i kopię poza głównym systemem.
Najczęstsze błędy
- Brak daty aktualizacji i właściciela wpisu.
- Trzymanie haseł w arkuszach i wiadomościach.
- Brak schematu sieci i listy dostawców.
- Dokumentowanie tylko nowych, a nie istniejących systemów.
- Brak testu procedury awaryjnej.
Plan uporządkowania dokumentacji
- Zbierz istniejące materiały.
- Sprawdź stan faktyczny.
- Ustal strukturę i właścicieli.
- Uzupełnij braki krytyczne.
- Zabezpiecz dostęp i kopie.
- Wprowadź przegląd po zmianach.
Lista kontrolna
- Jest aktualny schemat sieci.
- Znamy systemy i właścicieli.
- Licencje i dostawcy są zapisani.
- Procedura awarii ma kontakty.
- Sekrety są przechowywane bezpiecznie.
- Dokumentacja ma kopię i historię zmian.
Najczęstsze pytania
Czy mała firma potrzebuje rozbudowanej dokumentacji?
Nie. Powinna mieć przede wszystkim informacje potrzebne do codziennej pracy i odtworzenia usług.
Jak często aktualizować dokumenty?
Po każdej istotnej zmianie oraz podczas zaplanowanych przeglądów, co najmniej raz w roku.
Czy dokumentacja może być w chmurze?
Tak, pod warunkiem kontroli dostępu, wersjonowania i niezależnej kopii.
Potrzebujesz uporządkować wiedzę o swoim IT?
Możemy pomóc zebrać informacje, wskazać braki i przygotować strukturę dokumentacji.
Porozmawiajmy o Twoim IT