supervisor 安装
supervisor 的安装可以说非常简单。它是使用 python 开发的,所以如果你熟悉 python 的包管理器 (pip) 那么自然可以使用 sudo pip install supervisor
进行安装。由于我使用的是 CentOS7 所以我使用了 sudo yum install supervisor
。对于 Ubuntu 则可以使用 apt-get 包管理器来安装。
supervisor 配置
安装完成后默认的主配置文件位于 /etc/supervisord.conf
打开如下 (引用这篇文章) 里的配置说明:
- [unix_http_server]
- file=/tmp/supervisor.sock ; UNIX socket 文件,supervisorctl 会使用
- ;chmod=0700 ; socket 文件的 mode,默认是 0700
- ;chown=nobody:nogroup ; socket 文件的 owner,格式: uid:gid
-
- ;[inet_http_server] ; HTTP 服务器,提供 web 管理界面
- ;port=127.0.0.1:9001 ; Web 管理后台运行的 IP 和端口,如果开放到公网,需要注意安全性
- ;username=user ; 登录管理后台的用户名
- ;password=123 ; 登录管理后台的密码
-
- [supervisord]
- logfile=/tmp/supervisord.log ; 日志文件,默认是 $CWD/supervisord.log
- logfile_maxbytes=50MB ; 日志文件大小,超出会 rotate,默认 50MB
- logfile_backups=10 ; 日志文件保留备份数量默认 10
- loglevel=info ; 日志级别,默认 info,其它: debug,warn,trace
- pidfile=/tmp/supervisord.pid ; pid 文件
- nodaemon=false ; 是否在前台启动,默认是 false,即以 daemon 的方式启动
- minfds=1024 ; 可以打开的文件描述符的最小值,默认 1024
- minprocs=200 ; 可以打开的进程数的最小值,默认 200
-
- ; the below section must remain in the config file for RPC
- ; (supervisorctl/web interface) to work, additional interfaces may be
- ; added by defining them in separate rpcinterface: sections
- [rpcinterface:supervisor]
- supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
-
- [supervisorctl]
- serverurl=unix:///tmp/supervisor.sock ; 通过 UNIX socket 连接 supervisord,路径与 unix_http_server 部分的 file 一致
- ;serverurl=http://127.0.0.1:9001 ; 通过 HTTP 的方式连接 supervisord
-
- ; 包含其他的配置文件
- [include]
- files = supervisord.d/*.ini ; 可以是 *.conf 或 *.ini
supervisor 添加自定义程序
如果我们要运行一个我们自己的脚本那么要如何操作呢?把所有的配置文件都放在 supervisord.conf 并不是个好主意,一旦管理的进程过多,就很麻烦。所以一般都会新建一个目录来专门放置进程的配置文件,然后通过 include 的方式来获取这些配置信息。所以我们看到主配置文件中最后一行,它引入了 supervisord.d 目录下的所有.ini 文件。那么我们只需要在这个目录下创建一个我们自己的配置文件就会非常的方便。创建的配置如下
- [program:ping]
- directory = /home/vagrant //程序运行的目录
- command = php ping.php //运行此程序执行的命令,这里的(php)最好是绝对路径
- user = vagrant //以什么用户运行此程序
- autostart = true //supervisor启动时是否启动此程序
- autorestart = true //程序异常退出后自动重启
- startretries = 3 //启动失败自动重试次数,默认是 3
- stdout_logfile_maxbytes = 20MB //产生最大日志大小
- stdout_logfile_backups = 5 //保留日志文件个数
- stdout_logfile = /home/vagrant/supervisor/ping.log //日志文件路径 (如果是多级目录请自行创建)
首先 program 定义了我们自定义程序的名称。这个很重要,其他参数可以看注释说明
下面是 web 界面的管理图
supervisorctl 交互界面命令介绍
更新新的配置到 supervisord
- //根据最新的配置文件,启动新配置或有改动的进程,配置没有改动的进程不会受影响而重启;
- supervisorctl update
重新启动配置中的所有程序
- //载入最新的配置文件,停止原来的所有进程并按新的配置启动管理所有进程
- supervisorctl reload
启动某个进程 (program_name = 你配置中写的程序名称)
- supervisorctl start program_name
停止某一进程 (program_name = 你配置中写的程序名称)
- supervisorctl stop program_name
只载入新的配置文件
- // 只载入最新的配置文件, 并不重启任何进程;
- supervisorctl reread
查看正在守候的进程 (同时进入到交互式界面)
- supervisorctl
停止全部进程
- supervisorctl stop all
注意:显式用 stop 停止掉的进程,用 reload 或者 update 都不会自动重启。
这篇文件 (http://liyangliang.me/posts/2015/06/using-supervisor/) 写的很详细,基本上都覆盖了。