教程方向: 快速上手, 解决使用中遇到的一些问题
使用环境: Centos7.2

安装:

yum install supervisor

配置

安装好后在/etc/会生成一个supervisord.conf文件及一个supervisord.d文件目录

Supervisord.conf是一些默认配置，可自行参考一些配置文件教程修改

我们主要修改 /etc/supervisord.conf 文件的最后一行:

[include]
files = relative/directory/*.ini    ;可以指定一个或多个以.ini结束的配置文件

这里配置的是引入型配置, 会自动引入配置的目录下的配置文件

注意：[include]默认配置是制定*.ini，因个人习惯命名为*.conf文件，因此修改配置如下：

我们将配置目录改为自己想要的目录下后, 在目录下建立配置文件, 以frpc 为例.

/root/supervisord_conf/frpc.ini
[program:frpc]
command=/home/vagrant/frp/frp/frpc -c /home/vagrant/frp/frp/frpc.ini
user=root
autostart=true
autorestart=true
stderr_logfile=/home/vagrant/frp/frp/err.log
stdout_logfile=/home/vagrant/frp/frp/out.log

其他配置文件对应参考注释:

[program:usercenter]
directory = /home/Leon/projects/usercenter ; 程序的启动目录
command = gunicorn -w 8 -b 0.0.0.0:17510 wsgi:app  ; 启动命令
autostart = true     ; 在 supervisord 启动的时候也自动启动
Startsecs = 5        ; 启动 5 秒后没有异常退出，就当作已经正常启动了
autorestart = true   ; 程序异常退出后自动重启
Startretries = 3     ; 启动失败自动重试次数，默认是 3
user = Leon          ; 用哪个用户启动
redirect_stderr = true  ; 把 stderr 重定向到 stdout，默认 false
stdout_logfile_maxbytes = 20MB  ; stdout 日志文件大小，默认 50MB
stdout_logfile_backups = 20     ; stdout 日志文件备份数
; stdout 日志文件，需要注意当指定目录不存在时无法正常启动，所以需要手动创建目录（supervisord 会自动创建日志文件）
stdout_logfile = /data/logs/usercenter_stdout.log

注意: 配置中所指向的文件需要提前存在,否则会遇到错误.

启动并运行

  • 执行:
    supervisord -c /etc/supervisord.conf
    启动supervisord服务端

    查看 supervisord 是否在运行：
    ps aux | grep supervisord

    可能会碰到的错误:

    • python 不推荐使用的包

            /usr/lib/python2.7/site-packages/supervisor/options.py:383: PkgResourcesDeprecationWarning: Parameters to load are deprecated.  Call .resolve and .require separately.
return pkg_resources.EntryPoint.parse("x="+spec).load(False)

      这个打印并不影响使用,如果想解决这个错误可以参考 github issues

    • 重复启动错误
      supervisorctl unix:///var/run/supervisor.sock refused connection
      说明 已经启动 需要执行 supervisorctl shutdown终止进程再启动

  • 开启了supervisord后需要使用 supervisorctl 管理
    开启所有进程守护
    supervisorctl start all
    再执行 supervisorctl status
    会看到:

        [root@localhost supervisord_conf]# supervisorctl status
frpc                             RUNNING   pid 7989, uptime 0:10:15

  • 其他命令

    $ supervisorctl status
$ supervisorctl stop frpc
$ supervisorctl start frpc
$ supervisorctl restart frpc
$ supervisorctl reread
$ supervisorctl update

解释:
> status    # 查看程序状态
> stop usercenter   # 关闭 usercenter 程序
> start usercenter  # 启动 usercenter 程序
> restart usercenter    # 重启 usercenter 程序
> reread    ＃ 读取有更新（增加）的配置文件，不会启动新添加的程序
> update    ＃ 重启配置文件修改过的程序

参考资料
http://supervisord.org/index.html
http://liyangliang.me/posts/2015/06/using-supervisor/
https://www.cnblogs.com/haw2106/p/9872125.html
https://thief.one/2018/06/01/1/