centos上使用进程管理工具supervisor教程

我们在项目中经常会有服务需要常驻的需求，最近服务总是莫名其妙自己挂了，为了让服务可以异常挂掉后自动重启，可以使用supervisor（类似工具还有systemd）。

1：介绍

supervisord是python开发的一套通用的进程管理工具，能将一个普通的命令行进程变为后台daemon，并监控状态，还提供了web页面管理，能对进程进行自动重启等操作。

优点：1：可以页面管理进程； 2：单配置文件可控制多个程序；3：可以控制进程数量；4：进程资源控制能力比较强

缺点：1：不能管理后台运行程序；    2：对多进程服务，不能使用kill关闭； 3：supervisord本身需要被监控；4：开机自启依赖其他程序；5：不能跨主机

2：安装

平台要求：Supervisor已经过测试，可以在Linux（Ubuntu 9.10），Mac OS X（10.4 / 10.5 / 10.6）和Solaris（10 for Intel）和FreeBSD 6.1上运行。它可能在大多数UNIX系统上都能正常工作。在任何版本的Windows下，Supervisor 都不会运行。Supervisor 可以使用Python 2.4或更高版本，但不能在任何版本的Python 3下使用。

我使用的安装方法是pip安装：

1：安装：  

pip install supervisord  

2：查看是否安装成功：执行 supervisord -v   看到输出版本号代表成功了，我的输出了4.2.0

3：生成配置文件：

mkdir /etc/supervisor

echo_supervisord_conf > /etc/supervisor/supervisord.conf

4：启动：supervisord -c /etc/supervisor/supervisord.conf

5：查看是否启动成功：ps -ef | grep supervisord   找到就代表启动成功了

6：配置子配置文件

修改supervisord.conf的[include]配置，把注释符”;“符号去掉，将files项改为"/etc/supervisor/conf.d/*.conf"

Tips:[include]这一行的注释也记得去掉，我忘记去掉了，导致排查了好一会

3：卸载

简单粗暴：运行pip uninstall命令就可以了

4：使用示例

在这里我使用nginx来做演示。

1：首先找到nginx路径和配置文件，输入：which nginx，会输出nginx路径 我的是/etc/bin/nginx/sbin/nginx，我们先把nginx   kill掉。

2：设置nginx不以后台模式运行，修改nginx.conf   在头部worker_processes下一行输入“daemon off;”，然后重启nginx  (如果配的是php，在php-fpm.conf找到daemonize,设置为daemonize=no)

3：在/etc/supervisor/conf.d/文件夹增加子进程配置文件  nginx.conf,文件内容如下：

[program:nginx]command=/etc/bin/nginx/sbin/nginx -c /etc/bin/nginx/conf/nginx.conf                 ; nginx路径

directory=/tmp                                        ; 切换到目录

user=root                                               ; 执行程序的用户

autorestart=true                                     ; 自动重启

priority=999                                            ; 优先级

startsecs=1                                             ; 重启前等待时间

startretries=100                                      ; 最大重启次数

stdout_logfile=/tmp/supervisor/nginx/nginx.log        ; 日志文件

stdout_logfile_maxbytes=10MB                          ; 日志文件最大容量

stderr_logfile=/tmp/supervisor/nginx/nginx_err.log    ; 错误日志文件

stderr_logfile_maxbytes=1MB                          ; 错误日志文件最大容量

4：把刚刚设置里面的stdout_logfile和stderr_logfile相关日志目录创建好，并设置权限  

mkdir -p /tmp/supervisor/nginx

chown -R www:www /tmp/supervisor/nginx

5：重新读取supervisord配置：执行： supervisorctl reread   会输出：nginx: available

6：更新子进程组：执行：supervisorctl update     会输出 :  nginx:added process group

7：这时nginx应该已经被supervisord带起来了，我们ps -ef | grep nginx  查看一下，如果找到了，那么恭喜，代表配置成功了。 然后我们kill掉nginx主进程，再次ps -ef | grep nginx，可以看到一个新的nginx又会被supervisord创建出来。

5：查看子进程运行情况

可以输入“supervisorctl”命令，我的输出如下：

nginx                            RUNNING  pid 25182, uptime 1:46:57

php                              RUNNING  pid 2203, uptime 0:03:56

idgen                          RUNNING  pid 24074, uptime 2:01:09

6：配置web界面：

在supervisord.cond注释掉inet_http_server,变为：

[inet_http_server] ; inet (TCP) server disabled by default

port=127.0.0.1:9001        ; ip_address:port specifier, *:port for all iface

username=user              ; default is no username (open server)

password=123              ; default is no password (open server)

然后重启主进程，输入：supervisorctl reload

这时候我们打开浏览器，访问http:你的服务器ip地址:9001,根据弹窗提示输入配置文件内的账号和密码，这是我们就可以看到页面如下，我们可以方便的在页面查看进程状态，对他们进行重启，停止等操作。

7：设置开机自启：

echo "supervisord -c /etc/supervisord.conf" >> /etc/rc.local

8：子进程配置文件详解：

;*为必须填写项

;*[program:应用名称][program:cat]

;*命令路径,如果使用python启动的程序应该为 python /home/test.py, 

;不建议放入/home/user/, 对于非user用户一般情况下是不能访问command=/bin/cat

;当numprocs为1时,process_name=%(program_name)s

;当numprocs>=2时,%(program_name)s_%(process_num)02dprocess_name=%(program_name)s

;进程数量numprocs=1

;执行目录,若有/home/supervisor_test/test1.py

;将directory设置成/home/supervisor_test

;则command只需设置成python test1.py

;否则command必须设置成绝对执行目录directory=/tmp

;掩码:--- -w- -w-, 转换后rwx r-x w-xumask=022

;优先级,值越高,最后启动,最先被关闭,默认值999priority=999

;如果是true,当supervisor启动时,程序将会自动启动autostart=true

;*自动重启autorestart=true

;启动延时执行,默认1秒startsecs=10;启动尝试次数,默认3次startretries=3

;当退出码是0,2时,执行重启,默认值0,2exitcodes=0,2

;停止信号,默认TERM;中断:INT(类似于Ctrl+C)(kill -INT pid),退出后会将写文件或日志(推荐)

;终止:TERM(kill -TERM pid);挂起:HUP(kill -HUP pid),注意与Ctrl+Z/kill -stop pid不同

;从容停止:QUIT(kill -QUIT pid);KILL, USR1, USR2其他见命令(kill -l),说明1stopsignal=TERMstopwaitsecs=10

;*以root用户执行user=root

;重定向redirect_stderr=false

stdout_logfile=/a/path

stdout_logfile_maxbytes=1MB

stdout_logfile_backups=10

stdout_capture_maxbytes=1MB

stderr_logfile=/a/path

stderr_logfile_maxbytes=1MB

stderr_logfile_backups=10

stderr_capture_maxbytes=1MB

;环境变量设置environment=A="1",B="2"

serverurl=AUTO

参考文章：

http://www.supervisord.org/running.html#adding-a-program

https://www.cnblogs.com/52fhy/p/10161253.html

https://www.cnblogs.com/hubery/p/5653007.html