Урок 2 из 10Фундамент

12 мин · теория и практика · Основы

systemd: сервис не запускается

Прочитай причину падения и разберись, чем restart отличается от daemon-reload.

Сможешь проверить unit, журнал и реальное состояние приложения после изменения.

systemd управляет запуском процессов по unit-файлам. Статус failed — итог, а причина обычно находится в журнале или параметрах запуска. Бесконечные рестарты без диагностики только повторяют ту же ошибку.

Прочитай состояние и журнал

systemctl status показывает состояние и часть последних сообщений. journalctl -u выбирает журнал конкретного unit. Ищи первую содержательную ошибку приложения перед сообщением о завершении.

Команды
systemctl status shop-api --no-pager
sudo journalctl -u shop-api -n 60 --no-pager
Пример вывода
Main 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 вместо устранения доступа к ресурсу.

Как доказать восстановление

  1. Проверь effective unit и ожидаемого пользователя.
  2. Получи новый PID после restart.
  3. Убедись, что сервис остаётся активным после первых секунд.
  4. Повтори исходный запрос и проверь свежий журнал.

МИНИ-ИНЦИДЕНТ

Почему 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
  1. Какая строка объясняет повторные рестарты?

    Сверить рассуждение

    Первичная прикладная ошибка — отсутствующий конфигурационный файл. Строка Scheduled restart описывает реакцию manager на exit, а не причину завершения.

  2. Какие свойства unit нужно сравнить с ожиданием приложения?

    Сверить рассуждение

    ExecStart, аргументы, WorkingDirectory, User и путь настройки. Файл может существовать в другом каталоге, поэтому название ошибки ещё не доказывает физическое отсутствие нужных данных.

  3. Как проверить устойчивость после изменения?

    Сверить рассуждение

    Повтори запуск, прочитай свежий журнал, посмотри стабильность PID и выполни реальный запрос. Снимок active между двумя рестартами не доказывает, что цикл закончился.

ПРОВЕРЬ СЕБЯ

Поменял ExecStart и выполнил restart. Почему может использоваться прежняя команда?

Показать объяснение

systemd мог не перечитать unit. Выполни daemon-reload, затем restart и проверь эффективные параметры и журнал.

Документация

Гостевой прогресс хранится отдельно в этом браузере.

ТЕПЕРЬ В КОНСОЛЬ

Закрепи на инциденте

Проверь unit и журнал shop-api, найди причину отказа и восстанови приложение.

ПОМОГЛО РАЗОБРАТЬСЯ?

Как тебе материал?

Оцени статью или напиши, где не хватило объяснения. Это поможет улучшить обучение.

Полезно 0 Не помогло 0

Войди, чтобы оценить статью и оставить комментарий.

Обсуждение

0

Войти в обсуждение →

Пока без комментариев. Поделись первым впечатлением или задай вопрос по теме.