安装

pip install supervisor

1. 自定义服务配置文件

   echo_supervisord_conf > /etc/supervisord.conf

配置文件的大概内容

[unix_http_server]
file=/tmp/supervisor.sock   ; the path to the socket file
;chmod=0700                 ; socket file mode (default 0700)
;chown=nobody:nogroup       ; socket file uid:gid owner
;username=user              ; default is no username (open server)
;password=123               ; default is no password (open server)

[supervisord]
logfile=/tmp/supervisord.log ; main log file; default $CWD/supervisord.log
logfile_maxbytes=50MB        ; max main logfile bytes b4 rotation; default 50MB
logfile_backups=10           ; # of main logfile backups; 0 means none, default 10
loglevel=info                ; log level; default info; others: debug,warn,trace
pidfile=/tmp/supervisord.pid ; supervisord pidfile; default supervisord.pid

[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL  for a unix socket
;serverurl=http://127.0.0.1:9001 ; use an http:// url to specify an inet socket
;username=chris              ; should be same as in [*_http_server] if set
;password=123                ; should be same as in [*_http_server] if set
;prompt=mysupervisor         ; cmd line prompt (default "supervisor")
;history_file=~/.sc_history  ; use readline history if available

;[program:theprogramname]
;command=/bin/cat              ; the program (relative uses PATH, can take args)

;[group:thegroupname]
;programs=progname1,progname2  ; each refers to 'x' in [program:x] definitions
;priority=999                  ; the relative start priority (default 999)

;[include]
;files = relative/directory/*.ini

对于上述配置参数，可以按照具体的需求进行自定义，大多数参数可以保持默认设置。但是为了方便多个项目的统一管理，需要启用 [include] 参数。该参数用于将指定文件包含到配置中，通过这种方式来 "扩展" 服务配置文件。

创建配置目录，并修改 files 参数 :

mkdir /etc/supervisord.d

[include]
files = /etc/supervisord.d/*.ini

2. 自定义应用配置文件
   假设现在有一个测试项目 (test)，里面有个 test.py 脚本需要持久化运行。现在切换到项目目录 (/root/test)，并按照以下格式创建应用配置文件。

   {porject_name}.ini

   配置项目的进程启动参数 :

   ; /root/test/test.ini
   [program:test]
   command=python -u ./test.py          ; 运行命令
   directory=/root/test/                ; 运行目录
   redirect_stderr=true                 ; 将 stderr 重定向到 stdout
   stdout_logfile=/root/test/test.log   ; 日志文件输出路径
   
   autorestart=true                     ; 用于控制是否在 supervisord 进程启动时同时启动 (默认为 true)
   startsecs=3                          ; 是与自动重启相关的另一个配置参数。其作用是用于判断进程是否启动成功，只有当目标进程运行时间大于该配置时，才会判断成成功。
   startretries=3                       ; 参数需要与 startsecs 参数配合使用，用于控制目标进程的重启尝试次数，并且每次重试花费的时间间隔越来越长。可以通过以下代码测试一下：
   stdout_logfile=/supervisor/log/win_server.out.log   ; 指定标准输出流的日志文件路径。
   stderr_logfile=/supervisor/log/win_server.err.log   ; 错误日志文件输出路径
   stdout_logfile_maxbytes=2MB          ; 单个日志文件的最大字节数，当超过该值时将对日志进行切分。
   stderr_logfile_maxbytes=2MB          ; 错误日志文件最大2MB
   user=root                            ; 使用什么用户运行
   priority=999                         ; 优先级，数值越小越先启动
   numprocs=1                           ; 用于指定运行时的进程实例数量，需要与 process_name 参数配合使用。
   process_name=%(program_name)s_%(process_num)02d

使用

# 宝塔面板中：
# 使用软链接链接到user/bin下面，这样可以在命令行直接使用
ln -s /www/server/panel/pyenv/bin/supervisorctl /usr/bin/supervisorctl

# 进入到管理界面
supervisorctl

# 查看所有子进程状态
status
# 查看单个子进程的状态
status 子进程

# 关闭单个子进程
stop 子进程

# 关闭所有子进程
stop all

# 启动单个子进程
start 子进程

# 启动所有子进程
start all

# 重启单个子进程
restart 子进程