Документация ИТ-инфраструктуры: минимальный чек-лист
Обновлено: октябрь 2026
Инфраструктура, которая живёт в головах, работает до первого ухода, отпуска или болезни — человека, в головах которой она жила. Документация переводит это знание в компанию. В статье — минимальный состав документации небольшой организации: что описывать обязательно, в каком формате и как не дать ей устареть. Чек-лист рассчитан на компанию без выделенного ИТ-отдела — его можно пройти своими силами за пару дней.
ВАШЕЙ ИНФРАСТРУКТУРЫ
Чем документация отличается от описи
Соседняя задача — инвентаризация инфраструктуры — отвечает на вопрос «что у нас есть»: оборудование, лицензии, доступы. Документация отвечает на вопросы уровнем глубже: как это устроено, почему так, и что делать, когда перестаёт работать. Опись без документации сообщает, что у вас есть роутер, но не сообщает, что порт проброшен на камеру, а VPN-подсеть выбрана той, чтобы не пересекаться с домом директора.
Практическая проверка проста: если завтра исполнителю ИТ — сотруднику или подрядчику — придётся уехать на две недели, замена справится или нет? Инфраструктура с документацией переживёт эту паузу; инфраструктура в головах — нет. Тем же проверяется и качество самой документации: человек, не видевший вашей сети, должен понять её по файлу, а не по звонку.
Минимальный состав: восемь разделов
1. Схема сети. Как соединены роутеры, коммутаторы, точки доступа, серверы: что куда воткнуто и что чем обслуживается. Схема может быть простой — главное, чтобы её можно было читать без экскурсии по серверной.
2. Адресный план. Какие диапазоны за кем закреплены: рабочая сеть, гостевая, VPN, техника подрядчиков. План из одной таблицы экономит часы при добавлении любого нового устройства.
3. Журнал оборудования. Серверы, хранилища, сетевые устройства: модель, серийный номер, гарантия, где стоит, кто администрирует. Частично пересекается с описью — не страшно, если это одна и та же таблица.
4. Учётные записи и доступы. Перечень внешних сервисов и админ-доступов: где зарегистрировано, на какую почту, где пароль. Сами пароли — в менеджере паролей с раздельным доступом; документация хранит ссылки, а не секреты.
5. Регламент «если…». Первые шаги для типовых сбоев: пропал интернет, сервер не отвечает, копия не создалась, не открывается учётная система. По абзацу: как выглядит норма, что попробовать до звонка, к кому звонить. Именно этот раздел делает документацию живой — им пользуются.
6. Контакты. Провайдер, подрядчики, поставщики оборудования: кто, за что отвечает, как обращаться, номер договора. Ночь или отпуск — худшее время вспоминать, к кому шло письмо в прошлый раз.
7. Схема копирования. Что копируется, куда, по какому расписанию, где ключи шифрования и как выглядит процедура восстановления — от первого абзаца до контрольной точки. Ссылка на регламент восстановления важнее полных инструкций: они приложатся.
8. Журнал изменений. Дата, что изменилось, кто изменил: новые устройства, сменённые адреса, обновления конфигураций. Это раздел, который превращает документацию из снимка в историю — и отвечает на вопрос «с чего началось», заданный через полгода после изменения.
Где хранить и как не дать устареть
Формат — любой, который переживёт своего автора: страница в внутренней вики, общий документ, папка с файлами по разделам. Честное сравнение: папка с восемью файлами, поддерживаемая два года, бесконечно полезнее корпоративной базы знаний, заведённой на энтузиазме и брошенной через квартал. Начинать стоит с минимального формата и правила «сделал изменение — записал в журнал в тот же день».
Два требования к хранению — и оба про ту же безопасность. Первое: доступ ограничен. Документация — карта сокровищ, и читать её должен тот, кому предстоит администрировать, а не вся компания. Второе: у документации должна быть вторая копия вне основного контура — наравне с резервными копиями. Документация, лежащая только на документируемом сервере, — анекдот, который встречается не как анекдот.
Жизненный цикл простой: ревью раз в полгода — пройтись по разделам, обновить контакты и сроки, вычеркнуть устаревшее; журнал изменений — непрерывно. Ревью удобно совмещать с ежеквартальной сверкой описи: два порядка — один вечер.
Как это выглядит в работе
Схема и адресный план — не абстракция для полки, а рабочий инструмент любого инфраструктурного изменения: расширить сеть, добавить сегмент, переехать в новый офис. В наших инфраструктурных кейсах схема и адресация — обязательная часть описания каждого проекта, от склада с Wi-Fi до переезда на виртуализацию: это тот же минимальный состав из второго раздела, применённый к живым задачам.
Обратная сторона тоже практична: документация — тест на порядок в инфраструктуре. То, что нельзя описать связно, обычно работает по недокументированной причине — и раздел, который не пишется, честно указывает, где в системе бардак, задолго до первого сбоя.
Частые вопросы
Документация устарела год назад — чинить или писать заново?+
Чинить поэтапно, а не переписывать: за один проход обновляются схема, адресный план и контакты — то, что можно проверить за вечер, — а регламенты и журнал заполняются заново, уже по живому процессу «сделал — записал». Попытка дописать старое целиком обычно умирает на середине.
С какого раздела начать?+
С регламента «если…» и контактов: они самые дешёвые в составлении и самые востребованные в первый же сбой. Схема и адресный план — следующий проход; журнал изменений — сразу, с сегодняшнего дня.
Кто должен писать документацию?+
Тот, кто делает изменения, — иначе она расходится с реальностью в первый месяц. Если инфраструктуру ведёт подрядчик, состав и актуальность документации — часть его работы и часть приёмки, а не одолжение.
Не опасно ли хранить всё в одном месте?+
Опасно хранить в одном доступном всем месте. Ограниченный круг доступа плюс копия вне основного контура дают нужный баланс: документация выручает компанию, а не случайного читателя.
Нужна ли специальная система документации?+
На размере небольшой компании — нет: вики, общий документ или аккуратная папка закрывают минимальный состав целиком. Специализированные системы имеют смысл, когда документации становится много и в неё приходят незнакомые с инфраструктурой люди.
Как заставить людей поддерживать документацию?+
Никак «заставить» — работает внедрение в процесс: изменение считается сделанным, когда записано в журнал. Правило одно и стоит минуты, в отличие от разового «написать всю документацию», которое никогда не наступает.
Связанные материалы
Документация и опись — часть картины, которую даёт независимый осмотр инфраструктуры: что есть, как устроено, где риски и что делать в первую очередь. Это направление IT-аудита инфраструктуры, и состав аудита во многом повторяет чек-лист выше — уже выполненный посторонним взглядом.