Полгода не заходил в photo-index, потом понадобилось обновить сертификат. На сервере нашлись unit-файл, старый compose и три каталога с похожими именами. Через десять минут стало понятно: прежде чем что-то трогать, надо оставить себе одну нормальную записку.

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

Сервис: photo-index
Узел: apps-01
Адрес: https://photos.example.test
Конфигурация: /srv/photo-index/config
Данные: /data/photos, /data/index
Копия: nightly/photos, тест <YYYY-MM-DD>
Проверка: открыть альбом и найти файл по имени
Остановка: см. /srv/photo-index/STOP.md
Зависимости: PostgreSQL, каталог /data/photos

Команды копируют из действующей конфигурации, а не пишут по памяти. Если запуском управляет контейнерный оркестратор или панель, карточка ведёт прямо к нужному проекту и называет текущий способ развертывания.

Особенно полезна строка проверки. «Страница открывается» подтверждает только веб-сервер. Поиск фотографии, создание заметки или получение письма проверяет тот путь, ради которого сервис существует. Отдельная проверка восстановления даёт дату для строки о копии.

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