Скрипт на Python как 𝚛𝚌 служба в операционной системе FreeBSD

У меня есть скрипт на Python, который я хотел бы запустить в тюрьме FreeNAS. Он работает без демона сервиса, но я хотел бы запустить его как сервис. Я создал следующий скрипт сервиса /etc/rc.d/attendance

#!/bin/sh

# PROVIDE: attendance
# REQUIRE: DAEMON
# KEYWORD: shutdown

. /etc/rc.subr

name=attendance
rcvar=attendance_enable

load_rc_config $name

: ${attendance_enable="NO"}

pidfile="/var/run/${name}.pid"
command="/root/Zkteco/app.py"
command_interpreter=/usr/local/bin/python
run_rc_command "$1"

Я также добавил attendance_enable="YES" в /etc/rc.conf.

Когда я запускаю service attendance start, я получаю

Запуск attendance
limits: /root/Zkteco/app.py: Нет такого файла или каталога
/etc/rc.d/attendance: WARNING: не удалось запустить attendance

Хотя каталог существует, я попытался переместить его из /etc/rc.d/attendance в /usr/local/etc/rc.d/attendance, и, похоже, это сработало, но он снова не уходит в фоновый процесс, и мне нужно нажимать Ctrl+C, чтобы остановить его.

Есть ли какие-то рекомендации? Скрипт является веб-приложением, использующим FastAPI и Uvicorn, есть ли связь с этим? Как я могу увидеть логи ошибок сервиса, пытающегося запуститься.

Что я пробовал

Я создал бинарный файл с помощью pyinstaller --onefile из скрипта. И изменил

#!/bin/sh
.
.
.
command="/usr/local/bin/app"
run_rc_command "$1"

Это изменение заставило сервис запуститься, но опять же, он никогда не уходит в фон.

Файлы в /etc/rc.d считаются частью операционной системы и управляются ею. Вы должны только работать с /usr/local/etc/rc.d. Обратите внимание, что это местоположение также предназначено для rc-скриптов всех пакетов.

rc.d – это фреймворк управления сервисами. Но он ничего не делает для создания “сервиса” или, точнее, “демонизации процесса”. Он предназначен для обеспечения единого способа обработки “сервисов”.

Вы заметили, что ваше приложение не уходит в фон, как вы ожидали, и вам нужно было нажимать CTRL-C. Ваши ожидания не соответствуют тому, что должно происходить. Ответственность за демонизацию лежит на вашем скрипте/программе/приложении (уйти в фон и т.д.). Скрипт rc – это всего лишь оболочка вокруг вашего приложения.

Я не знаю ваше приложение и uvicorn очень хорошо. Но из документации uvicorn, похоже, не поддерживает демонизацию. Это обычно происходит при указании параметра командной строки. Ваш базовый тест на это: Можете ли вы запустить свое приложение из командной строки и заставить его отсоединиться от консоли самостоятельно?

Если вы хотите чисто питоновский способ сделать это, обратите внимание на PEP 3143 – стандартная библиотека процессов-демонов.

Простой подход FreeBSD состоит в том, чтобы использовать daemon(8). Очень простой пример был бы следующим:

#!/bin/sh

# REQUIRE: LOGIN

. /etc/rc.subr

name=attendance
rcvar=`set_rcvar`
pidfile="/var/run/${name}.pid"
attendance_user="somenotrootuser"
command="/usr/sbin/daemon"
command_args="-c -f -P ${pidfile} -u ${attendance_user} -r /usr/local/bin/app"

load_rc_config $name
run_rc_command "$1"

(См. Есть ли простой способ создать скрипт rc для FreeBSD? и Скрипт FreeBSD rc.d не стартует как демон)

Я замечаю, что вы разместили свое приложение в /root. Это наводит на мысль, что вы запускаете вещи от имени root. Хорошей практикой является запуск вещей от имени непривилегированного пользователя.

Это должно работать для вашего простого случая. Если это полноценный развертывание в производстве, вам нужно сделать больше, но это связано с uvicorn, а не с FreeBSD. Если вы прочитаете о https://www.uvicorn.org/deployment/, вы заметите, что в производстве вы часто будете использовать gunicorn и, возможно, nginx тоже.

Вышеуказанное – это “правильный” способ делать вещи в FreeBSD. Если вам нравится использовать FreeBSD, это полезно учить и с чем работать.

Но если вы больше программист на Python/веб-программист и находите настройку gunicorn и т.д. трудной, то вам может быть легче установить supervisord. Он легко устанавливается как пакет sysutils/py-supervisor/. Это можно рассматривать как альтернативу rc/демону, и вы найдете много примеров онлайн, специально для использования с проектами веб на Python.