Карта и владельцы

Опишите домены, узлы, базы, хранилища, интеграции и направление данных. Для каждого сервиса укажите владельца аккаунта и способ получить доступ без публикации самих секретов.

Отметьте критичные внешние сервисы, DNS-провайдера, узлы завершения TLS и маршрут доставки почты. Укажите, кто обслуживает каждый из них.

Рабочие инструкции

Нужны процедуры публикации, отката, восстановления копии, продления сертификата и реакции на типовые сигналы. В каждой инструкции укажите необходимые доступы, условия запуска и способ проверить результат.

Команды без объяснения опасны. Укажите ожидаемый эффект и условия, при которых действие нужно остановить.

Поддерживайте актуальность

Обновляйте документ вместе с изменением системы и назначьте владельца раздела. Периодически проходите ключевые инструкции в тестовой среде.

Храните историю решений и известных ограничений отдельно от пошаговых действий. Документация становится частью эксплуатации, а не отчётом после проекта.

Проверяйте инструкции практикой

Попросите специалиста, который не писал документ, выполнить безопасный тест: найти журнал, обновить тестовую среду или восстановить копию. Непонятный шаг и устаревший адрес обнаружатся быстрее, чем при обычном чтении.

Укажите ответственного за каждый раздел и дату последней проверки. После изменения инфраструктуры обновляйте схему и инструкцию в той же задаче. Периодически проверяйте адреса и команды на тестовой среде.

Храните историю изменений, но на первом экране показывайте действующий порядок. Во время сбоя специалисту нужен ясный шаг, а не выбор между устаревшими версиями.