systemd управляет запуском процессов по unit-файлам. Статус failed — итог, а причина обычно находится в журнале или параметрах запуска. Бесконечные рестарты без диагностики только повторяют ту же ошибку.
Прочитай состояние и журнал
systemctl status показывает состояние и часть последних сообщений. journalctl -u выбирает журнал конкретного unit. Ищи первую содержательную ошибку приложения перед сообщением о завершении.
systemctl status shop-api --no-pager
sudo journalctl -u shop-api -n 60 --no-pagerMain process exited, code=exited, status=1/FAILUREЭта строка сообщает о неуспешном завершении. Причину — например, отсутствующий файл — ищи раньше в журнале.
Проверь эффективный unit
systemctl cat выводит исходный unit и drop-in-файлы. Проверь ExecStart, User, WorkingDirectory и EnvironmentFile. Приложение запускается от указанного пользователя и может видеть другие права и переменные, чем твоя консоль.
systemctl cat shop-api
systemctl show shop-api -p ExecStart -p User -p WorkingDirectoryНе публикуй содержимое EnvironmentFile: там могут храниться секреты. Для диагностики обычно достаточно проверить путь и наличие нужного параметра.
Примени нужный тип изменения
После изменения unit-файла нужен daemon-reload: он перечитывает определения systemd. Затем restart запускает процесс заново. Изменение обычного конфига приложения не всегда требует daemon-reload — способ перечитывания определяется приложением.
sudo systemctl daemon-reload
sudo systemctl restart shop-api
systemctl is-active shop-api
curl -sS -i --max-time 5 http://localhost:8080/healthКоманды изменения относятся к ситуации, когда unit уже исправлен. active означает состояние unit; запрос к приложению проверяет пользовательский результат.
Проверь зависимости и повторный старт
В кейсе shop-api журнал выводит причину остановки, но исправление может находиться вне unit: например, на заполненном разделе данных. Исправляй подтверждённый ресурс, затем запускай штатный сервис, сохраняя его пользователя и настройки.
После restart получи свежий PID, новое состояние и последние строки журнала. Если процесс снова упал спустя несколько секунд, возвращайся к новой ошибке: статус active сразу после запуска был промежуточным наблюдением.
systemctl show shop-api -p MainPID -p ActiveState -p SubState
sudo journalctl -u shop-api -n 20 --no-pagerОт симптома к проверке
| Наблюдение | Следующая проверка | Как читать результат |
|---|---|---|
| status=1/FAILURE | Предыдущие строки journalctl | Это результат выхода; ищи прикладную причину перед ним. |
| Файл unit исправлен, поведение прежнее | daemon-reload, effective unit и PID | Изменение на диске могло ещё не стать параметром нового процесса. |
| active, но запрос падает | Журнал и бизнес-маршрут | Жизнь процесса не доказывает полезную работу. |
Типовые ошибки
- Бесконечно выполнять restart без чтения первой ошибки.
- Проверять конфиг другого сервиса или старый PID.
- Перевести сервис на root вместо устранения доступа к ресурсу.
Как доказать восстановление
- Проверь effective unit и ожидаемого пользователя.
- Получи новый PID после restart.
- Убедись, что сервис остаётся активным после первых секунд.
- Повтори исходный запрос и проверь свежий журнал.
МИНИ-ИНЦИДЕНТ
Почему restart не применил ExecStart?
В файле новая команда, но systemctl show продолжает показывать старую. Как проверить, какой слой ещё не обновился?
unit file: ExecStart=/opt/app/new-api
effective ExecStart: /opt/app/old-apiРазобрать ход диагностики
Сначала перечитай определения systemd, проверь cat/show, затем выполни контролируемый restart и проверь новый PID. Отдельно убедись, что редактировал нужный unit, а не файл, перекрытый drop-in.
ПРАКТИКУМ
Практикум: объясни данные и выбери действие
Приложение запускается, но через секунду завершается. Прочитай хронологию, а не только последний статус.
14:10:00 Started shop-api
14:10:01 app: configuration file not found
14:10:01 Main process exited, status=1
14:10:02 Scheduled restart jobКакая строка объясняет повторные рестарты?
Сверить рассуждение
Первичная прикладная ошибка — отсутствующий конфигурационный файл. Строка Scheduled restart описывает реакцию manager на exit, а не причину завершения.
Какие свойства unit нужно сравнить с ожиданием приложения?
Сверить рассуждение
ExecStart, аргументы, WorkingDirectory, User и путь настройки. Файл может существовать в другом каталоге, поэтому название ошибки ещё не доказывает физическое отсутствие нужных данных.
Как проверить устойчивость после изменения?
Сверить рассуждение
Повтори запуск, прочитай свежий журнал, посмотри стабильность PID и выполни реальный запрос. Снимок active между двумя рестартами не доказывает, что цикл закончился.
ПРОВЕРЬ СЕБЯ
Поменял ExecStart и выполнил restart. Почему может использоваться прежняя команда?
Показать объяснение
systemd мог не перечитать unit. Выполни daemon-reload, затем restart и проверь эффективные параметры и журнал.
Пока без комментариев. Поделись первым впечатлением или задай вопрос по теме.