Скрипт Python как сервис rc в операционной системе 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, я получаю

Starting 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, похоже, не поддерживает самодемонизацию. Обычно это происходит при указании параметра командной строки. Ваш основной тест для этого: можете ли вы запустить ваше приложение из командной строки и заставить его отсоединиться от консоли самостоятельно?

Если вы хотите чистый способ на Python для этого, то посмотрите на 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/daemon, и вы найдете гораздо больше примеров онлайн, специально для использования с веб-проектами на Python.