Jak przygotować dokumentację IT
od zera?

Dokumentacja infrastruktury IT jest jednym z tych elementów, o których większość firm przypomina sobie dopiero podczas awarii, zmiany dostawcy IT lub odejścia administratora.

Przez lata wszystko działa poprawnie, więc temat schodzi na dalszy plan. W pewnym momencie okazuje się jednak, że nikt nie wie: jakie serwery działają w firmie, gdzie znajdują się backupy, kto ma dostęp do kluczowych systemów ani jak odtworzyć środowisko po awarii.

Dobra wiadomość jest taka, że nawet jeśli dziś nie posiadasz żadnej dokumentacji, możesz ją zbudować stopniowo i bez paraliżowania codziennej pracy.

Jeśli wolisz, żeby zajął się tym ktoś inny, budowanie i utrzymanie dokumentacji jest stałym elementem naszej stałej opieki informatycznej.

Dlaczego dokumentacja IT jest tak ważna?

Wiele firm traktuje dokumentację jako dodatkowy obowiązek administracyjny. W praktyce jest to jedno z najważniejszych narzędzi ograniczających ryzyko biznesowe. Dobrze przygotowana dokumentacja:

• › skraca czas usuwania awarii
• › przyspiesza wdrażanie nowych pracowników
• › ogranicza zależność od pojedynczych osób
• › ułatwia migracje i modernizacje
• › wspiera audyty bezpieczeństwa
• › zwiększa wartość firmy podczas sprzedaży lub inwestycji

Im bardziej rozbudowana infrastruktura, tym większe znaczenie ma uporządkowana wiedza o środowisku.

Najczęstszy błąd: próba udokumentowania wszystkiego naraz

To właśnie dlatego wiele projektów dokumentacyjnych kończy się niepowodzeniem. Firma postanawia opisać całą infrastrukturę, tworzy ogromny plan, a po kilku tygodniach projekt zostaje porzucony.

Znacznie lepszym podejściem jest rozpoczęcie od elementów krytycznych dla działania biznesu. Nie potrzebujesz od razu setek stron dokumentacji - potrzebujesz informacji, które pozwolą utrzymać ciągłość działania firmy.

Krok 1: Wykonaj inwentaryzację infrastruktury

Pierwszym krokiem jest ustalenie, co faktycznie znajduje się w środowisku. Warto przygotować listę obejmującą:

• › serwery fizyczne
• › maszyny wirtualne
• › komputery użytkowników
• › urządzenia sieciowe
• › systemy backupowe
• › usługi chmurowe
• › domeny internetowe
• › licencje i subskrypcje

Na tym etapie nie skupiaj się jeszcze na szczegółach technicznych. Najważniejsze jest stworzenie kompletnego obrazu środowiska.

Krok 2: Zidentyfikuj systemy krytyczne

Nie wszystkie elementy infrastruktury mają takie samo znaczenie. Zastanów się:

• › bez czego firma nie może pracować przez godzinę
• › bez czego firma nie może pracować przez dzień
• › które systemy generują przychody
• › które systemy są wymagane do produkcji lub obsługi klientów

Najczęściej będą to: system ERP, poczta elektroniczna, serwery plików, kontrolery domeny, systemy produkcyjne i systemy backupowe. To właśnie od nich warto zacząć dokumentowanie.

Krok 3: Opisz architekturę sieci

Jednym z najcenniejszych elementów dokumentacji jest aktualny schemat sieci. Powinien on pokazywać:

• › segmenty sieci i VLAN-y
• › połączenia między lokalizacjami
• › urządzenia sieciowe
• › połączenia z Internetem
• › kluczowe zależności

Nie musi być idealny. Nawet prosty diagram jest lepszy niż jego całkowity brak.

Krok 4: Udokumentuj dostęp i uprawnienia

To obszar szczególnie często pomijany. Dokumentacja powinna zawierać informacje dotyczące:

• › administratorów systemów
• › kont serwisowych
• › dostępu do chmury
• › dostępu do domen
• › dostępu do systemów backupowych

Nie chodzi o przechowywanie haseł w dokumentacji. Chodzi o wskazanie, gdzie są przechowywane oraz kto ma do nich dostęp. Brak tej wiedzy jest jednym z głównych problemów podczas przejmowania infrastruktury po poprzednim dostawcy.

Krok 5: Opisz backup i procedury odtwarzania

Wiele firm posiada backup, ale niewiele potrafi odpowiedzieć na pytanie: jak dokładnie odtworzyć system po awarii? Dla każdego kluczowego systemu warto opisać:

• › gdzie znajdują się kopie zapasowe
• › jak często są wykonywane
• › kto odpowiada za ich kontrolę
• › jak wygląda procedura odtworzenia

To jeden z najważniejszych elementów całej dokumentacji.

Krok 6: Stwórz podstawowe procedury operacyjne

Nie wszystko trzeba opisywać szczegółowo. Warto jednak przygotować instrukcje dla najczęściej wykonywanych czynności, na przykład:

• › dodawanie użytkownika
• › reset hasła
• › przywracanie danych z backupu
• › restart usług
• › obsługa awarii Internetu
• › aktualizacja systemów

Takie procedury znacząco skracają czas reakcji podczas problemów.

Jakiego narzędzia używać?

Najważniejsza zasada: używaj narzędzia, które będzie aktualizowane. Popularne rozwiązania:

O tym, jak NetBox sprawdza się jako centralne repozytorium wiedzy o infrastrukturze, piszemy w artykule o NetBox jako source of truth.

Jak utrzymać dokumentację aktualną?

To najtrudniejsza część całego procesu. Najlepsza dokumentacja po roku może stać się bezużyteczna, jeśli nikt jej nie aktualizuje. Dobre praktyki obejmują:

• › aktualizację po każdej większej zmianie
• › kwartalny przegląd dokumentacji
• › przypisanie właściciela dokumentacji
• › powiązanie dokumentacji z procesem zarządzania zmianami
• › regularne audyty kompletności

Dokumentacja powinna być traktowana jak część infrastruktury, a nie jednorazowy projekt.

Najczęstsze błędy podczas tworzenia dokumentacji

Podczas audytów najczęściej spotykamy:

• › brak aktualizacji po zmianach
• › przechowywanie dokumentacji na prywatnych komputerach
• › zbyt techniczne opisy niezrozumiałe dla innych osób
• › brak informacji o backupach
• › brak schematów sieci
• › brak procedur awaryjnych

W efekcie dokumentacja istnieje, ale nie pomaga podczas rzeczywistych problemów.

Podsumowanie

Przygotowanie dokumentacji IT od zera nie wymaga wielomiesięcznego projektu ani setek stron opisów. Najważniejsze jest rozpoczęcie od elementów krytycznych dla działania firmy i konsekwentne rozwijanie dokumentacji wraz z rozwojem infrastruktury.

Dobrze prowadzona dokumentacja skraca czas usuwania awarii, zwiększa bezpieczeństwo i pozwala uniknąć sytuacji, w której cała wiedza o środowisku znajduje się w głowie jednej osoby.

Jeżeli dziś nie posiadasz żadnej dokumentacji, najlepszy moment na rozpoczęcie jej tworzenia jest właśnie teraz. Nawet kilka godzin poświęconych na uporządkowanie podstawowych informacji może oszczędzić dziesiątki godzin pracy podczas przyszłych awarii, migracji i zmian organizacyjnych.