Unix中怎么安装与配置Supervisor

共计 6868 个字符，预计需要花费 18 分钟才能阅读完成。

这篇文章主要介绍了 Unix 中怎么安装与配置 Supervisor 的相关知识，内容详细易懂，操作简单快捷，具有一定借鉴价值，相信大家阅读完这篇 Unix 中怎么安装与配置 Supervisor 文章都会有所收获，下面我们一起来看看吧。

supervisor（）是用 python 开发的一个 client/server 服务，是 linux/unix 系统下的一个进程管理工具，不支持 windows 系统。它可以很方便的监听、启动、停止、重启一个或多个进程。用 supervisor 管理的进程，当一个进程意外被杀死，supervisort 监听到进程死后，会自动将它重新拉起，很方便的做到进程自动恢复的功能，不再需要自己写 shell 脚本来控制。

因为 supervisor 是 python 开发的，安装前先检查一下系统否安装了 python2.4 以上版本。下面以 centos7，python2.7 版本环境下，介绍 supervisor 的安装与配置步聚：

1、安装 python 包管理工具（）

easy_install 是 setuptools 包里带的一个命令，使用 easy_install 实际上是在调用 setuptools 来完成安装模块的工作, 所以安装 setuptools 即可。

wget --no-check-certificate https://bootstrap.pypa.io/ez_setup.py -o - | sudo python

2、安装 supervisor

easy_install supervisor

supervisor 安装完成后会生成三个执行程序：supervisortd、supervisorctl、echo_supervisord_conf，分别是 supervisor 的守护进程服务（用于接收进程管理命令）、客户端（用于和守护进程通信，发送管理进程的指令）、生成初始配置文件程序。

3、配置

运行 supervisord 服务的时候，需要指定 supervisor 配置文件，如果没有显示指定，默认在以下目录查找：

$cwd/supervisord.conf
$cwd/etc/supervisord.conf
/etc/supervisord.conf
/etc/supervisor/supervisord.conf (since supervisor 3.3.0)
../etc/supervisord.conf (relative to the executable)
../supervisord.conf (relative to the executable)

$cwd 表示运行 supervisord 程序的目录。

可以通过运行 echo_supervisord_conf 程序生成 supervisor 的初始化配置文件，如下所示：

mkdir /etc/supervisor
echo_supervisord_conf   /etc/supervisor/supervisord.conf

4、配置文件参数说明

supervisor 的配置参数较多，下面介绍一下常用的参数配置，详细的配置及说明，请参考介绍。
注：分号（;）开头的配置表示注释

[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，如果设成 0，表示不限制大小
logfile_backups=10 ; 日志文件保留备份数量默认 10，设为 0 表示不备份
loglevel=info ; 日志级别，默认 info，其它: debug,warn,trace
pidfile=/tmp/supervisord.pid ;pid  文件
nodaemon=false ; 是否在前台启动，默认是 false，即以  daemon  的方式启动
minfds=1024 ; 可以打开的文件描述符的最小值，默认  1024
minprocs=200 ; 可以打开的进程数的最小值，默认  200
[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ; 通过 unix socket 连接 supervisord，路径与 unix_http_server 部分的 file 一致
;serverurl=http://127.0.0.1:9001 ;  通过 http 的方式连接 supervisord
; [program:xx]是被管理的进程配置参数，xx 是进程的名称
[program:xx]
command=/opt/apache-tomcat-8.0.35/bin/catalina.sh run ;  程序启动命令
autostart=true ;  在 supervisord 启动的时候也自动启动
startsecs=10 ;  启动 10 秒后没有异常退出，就表示进程正常启动了，默认为 1 秒
autorestart=true ;  程序退出后自动重启, 可选值：[unexpected,true,false]，默认为 unexpected，表示进程意外杀死后才重启
startretries=3 ;  启动失败自动重试次数，默认是 3
user=tomcat ;  用哪个用户启动进程，默认是 root
priority=999 ;  进程启动优先级，默认 999，值小的优先启动
redirect_stderr=true ;  把 stderr 重定向到 stdout，默认 false
stdout_logfile_maxbytes=20mb ; stdout  日志文件大小，默认 50mb
stdout_logfile_backups = 20 ; stdout  日志文件备份数，默认是 10
; stdout  日志文件，需要注意当指定目录不存在时无法正常启动，所以需要手动创建目录（supervisord  会自动创建日志文件）stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.out
stopasgroup=false ; 默认为 false, 进程被杀死时，是否向这个进程组发送 stop 信号，包括子进程
killasgroup=false ; 默认为 false，向进程组发送 kill 信号，包括子进程
; 包含其它配置文件
[include]
files = relative/directory/*.ini ; 可以指定一个或多个以.ini 结束的配置文件

include 示例：

[include]
files = /opt/absolute/filename.ini /opt/absolute/*.ini foo.conf config??.ini

5、配置管理进程

进程管理配置参数，不建议全都写在 supervisord.conf 文件中，应该每个进程写一个配置文件放在 include 指定的目录下包含进 supervisord.conf 文件中。

1 创建 /etc/supervisor/config.d 目录，用于存放进程管理的配置文件

2 修改 /etc/supervisor/supervisord.conf 中的 include 参数，将 /etc/supervisor/conf.d 目录添加到 include 中

[include]
files = /etc/supervisor/config.d/*.ini

下面是配置 tomcat 进程的一个例子：

[program:tomcat]
command=/opt/apache-tomcat-8.0.35/bin/catalina.sh run
stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.out
autostart=true
autorestart=true
startsecs=5
priority=1
stopasgroup=true
killasgroup=true

5、启动 supervisor 服务

supervisord -c /etc/supervisor/supervisord.conf

6、控制进程

6.1 交互终端

supervisord 启动成功后，可以通过 supervisorctl 客户端控制进程，启动、停止、重启。运行 supervisorctl 命令，不加参数，会进入 supervisor 客户端的交互终端，并会列出当前所管理的所有进程。

上图中的 tomcat 就是我们在配置文件中 [program:tomcat] 指定的名字。

输入 help 可以查看可以执行的命令列表，如果想看某个命令的作用，运行 help 命令名称，如：help stop

stop tomcat //  表示停止 tomcat 进程
stop all //  表示停止所有进程
// ...

6.2 bash 终端

supervisorctl status
supervisorctl stop tomcat
supervisorctl start tomcat
supervisorctl restart tomcat
supervisorctl reread
supervisorctl update

6.3 web 管理界面

出于安全考虑，默认配置是没有开启 web 管理界面，需要修改 supervisord.conf 配置文件打开 http 访权限，将下面的配置：

;[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))

修改成：

[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：登录管理后台的密码

7、开机启动 supervisor 服务

7.1 配置 systemctl 服务

1 进入 /lib/systemd/system 目录，并创建 supervisor.service 文件

[unit]
description=supervisor
after=network.target
[service]
type=forking
execstart=/usr/bin/supervisord -c /etc/supervisor/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 设置开机启动

systemctl enable supervisor.service
systemctl daemon-reload

3、修改文件权限为 766

chmod 766 supervisor.service

7.2 配置 service 类型服务

#!/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/supervisor/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
exit $retval

将上述脚本内容保存到 /etc/rc.d/init.d/supervisor 文件中，修改文件权限为 755，并设置开机启动

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

注意：修改脚本中 supervisor 配置文件路径为你的 supervisor 的配置文件路径

注意：

supervisor 只能管理非 daemon 的进程，也就是说 supervisor 不能管理守护进程。否则提示 exited too quickly (process log may have details)异常。例子中的 tomcat 默认是以守护进程启动的，所以我们改成了 catalina.sh run，以前台进程的方式运行。

yum 方式安装

yum install epel-release
yum install -y supervisor

supervisor 没有发布在标准的 centos 源在，需要安装 epel 源。这种方式安装的可能不是最新版本，但比较方便，安装完成之后，配置文件会自动帮你生成。

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

进程管理配置文件放到：/etc/supervisord.d/ 目录下即可

默认日志文件：/tmp/supervisord.log，可以查看进程的启动信息

关于“Unix 中怎么安装与配置 Supervisor”这篇文章的内容就介绍到这里，感谢各位的阅读！相信大家对“Unix 中怎么安装与配置 Supervisor”知识都有一定的了解，大家如果还想学习更多知识，欢迎关注丸趣 TV 行业资讯频道。