supervisord是一个进程管理工具，用来启动、停止、重启和监测进程，当程序挂掉后supervisor能够重新启动进程。

注意： Supervisor只能管理非daemon的进程，也就是说Supervisor不能管理守护进程。否则提示Exited too quickly (process log may have details)异常。

安装

这里使用yum安装，supervisor没有发布在标准的CentOS源里，需要安装epel源。

  • 默认配置文件：/etc/supervisord.conf

  • 进程管理配置文件放到：/etc/supervisord.d/

1
yum install -y epel-release supervisor

supervisor安装完成后会生成三个执行程序，它们分别是：

  • supervisortd：supervisor的守护进程服务（用于接收进程管理命令）

  • supervisorctl：客户端（用于和守护进程通信，发送管理进程的指令）

  • echo_supervisord_conf：生成初始配置文件程序

启动Supervisor服务

1
supervisord -c /etc/supervisord.conf

配置管理进程文件

使用yum安装的supervisor默认的主配置文件是/etc/supervisord.conf。

在实际环境中，不建议将进程管理配置参数写到这个主配置文件中，应该给每个进程单独写一个配置文件，默认主配置文件引入的文件是/etc/supervisord.d/*.ini。

下面是Nginx配置进程的一个例子，注意配置文件名的后缀

1
2
3
4
5
6
7
8
9
10
11
12
13
[program:nginx]
process_name=%(program_name)s_%(process_num)02d
command=/sbin/nginx                                   ; 程序路径
autostart=true
autorestart=true                                      ; 自动重启
priority=999                                          ; 优先级
startsecs=1                                           ; 重启前等待时间
startretries=100                                      ; 最大重启次数
user=www
numprocs=8
redirect_stderr=true                                  ; 如果为true，则stderr的日志会被写入stdout日志文件中默认为false，非必须设置
stdout_logfile=/path/app.log                          ; 输出日志
stderr_logfile=/path/app.log                          ; 错误日志

一定要将被supervisor所管理的进程在前台运行，如果进程正在运行，请先关闭。

重载配置

1
supervisorctl reread && supervisorctl update

执行完上面的命令，可以看到控制台会输出如下结果

1
2
nginx: available
nginx: added process group

至此使用 supervisord 管理nginx进程已经OK。

终端管理进程

终端交互

supervisord启动成功后，可以通过supervisorctl客户端控制进程，启动、停止、重启。

运行supervisorctl命令，不加参数，会进入supervisor客户端的交互终端，并会列出当前所管理的所有进程。

1
2
3
4
5
6
7
8
9
10
[root@localhost ~]# supervisorctl
nginx                            RUNNING   pid 4423, uptime 0:00:02
supervisor> help

default commands (type help <topic>):
=====================================
add    clear  fg        open  quit    remove  restart   start   stop  update
avail  exit   maintail  pid   reload  reread  shutdown  status  tail  version

supervisor>

图中nginx就是上面在配置文件中第一行[program:nginx]指定。

这么多的命令不知道怎么使用可以使用help [命令名称]，例如：help stop，则会有更详细的命令解释。

Bash终端命令

1
2
3
4
5
6
supervisorctl status
supervisorctl stop nginx
supervisorctl start nginx
supervisorctl restart nginx
supervisorctl reread # 有新的配置文件加入到配置目录`/etc/supervisord.d/`使用命令重新读取配置。
supervisorctl update # 配合reread使用

WEB管理界面

默认配置没有开启WEB管理界面，需要修改主配置文件supervisord.conf配置文件中打开,并修改如下内容。

1
2
3
4
;[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))

修改为：

1
2
3
4
[inet_http_server]         ; inet (TCP) server disabled by default
port=0.0.0.0: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))

  • port：绑定访问IP和端口，这里是绑定的是本地IP和9001端口

  • username：登录管理后台的用户名

  • password：登录管理后台的密码

配置开机启动Supervisor服务

添加systemctl服务和添加service服务二者选其一即可。

添加systemctl服务

1、创建supervisor.service文件

进入/lib/systemd/system目录，并创建supervisor.service文件，文件内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
[Unit]
Description=supervisor
After=network.target

[Service]
Type=forking
ExecStart=/usr/bin/supervisord -c /etc/supervisord.conf
ExecStop=/usr/bin/supervisorctl $OPTIONS shutdown
ExecReload=/usr/bin/supervisorctl $OPTIONS reload
KillMode=process
Restart=on-failure
RestartSec=42s

[Install]
WantedBy=multi-user.target
2、修改文件权限
1
chmod 766 supervisor.service
3、设置开机启动
1
2
3
systemctl enable supervisor.service
systemctl daemon-reload
systemctl start/restart/stop supervisor.service
4、验证是否开机自启动
1
systemctl is-enabled supervisor

添加service服务

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
#!/bin/bash
#
# supervisord   This scripts turns supervisord on
#
# Author:       Mike McGrath <mmcgrath@redhat.com> (based off yumupdatesd)
#
# chkconfig:    - 95 04
#
# description:  supervisor is a process control utility.  It has a web based
#               xmlrpc interface as well as a few other nifty features.
# processname:  supervisord
# config: /etc/supervisor/supervisord.conf
# pidfile: /var/run/supervisord.pid
#

# source function library
. /etc/rc.d/init.d/functions

RETVAL=0

start() {
    echo -n $"Starting supervisord: "
    daemon "supervisord -c /etc/supervisord.conf "
    RETVAL=$?
    echo
    [ $RETVAL -eq 0 ] && touch /var/lock/subsys/supervisord
}

stop() {
    echo -n $"Stopping supervisord: "
    killproc supervisord
    echo
    [ $RETVAL -eq 0 ] && rm -f /var/lock/subsys/supervisord
}

restart() {
    stop
    start
}

case "$1" in
  start)
    start
    ;;
  stop)
    stop
    ;;
  restart|force-reload|reload)
    restart
    ;;
  condrestart)
    [ -f /var/lock/subsys/supervisord ] && restart
    ;;
  status)
    status supervisord
    RETVAL=$?
    ;;
  *)
    echo $"Usage: $0 {start|stop|status|restart|reload|force-reload|condrestart}"
    exit 1
esac

exit $RETVAL

将上面的代码内容保存到/etc/rc.d/init.d/supervisor文件并将文件权限修改为755，并设置开机自启动。

1
2
chmod 755 /etc/rc.d/init.d/supervisor
chkconfig supervisor on

其它Linux发行版开机启动脚本：https://github.com/Supervisor/initscripts

参考地址

许可协议

本文采用 署名-非商业性使用-相同方式共享 4.0 国际 许可协议，转载请注明出处。