Supervisor安装与配置(linux/unix进程管理工具) Supervisor（Supervisor: A Process Control System）是用Python开发的一个client/server服务，是Linux/Unix系统下的一个进程管理工具，不支持Windows系统。它可以很方便的监听、启动、停止、重启一个或多个进程。用Supervisor管理的进程，当一个进程意外被杀死，supervisort监听到进程死后，会自动将它重新拉起，很方便的做到进程自动恢复的功能，不再需要自己写shell脚本来控制。
因为Supervisor是Python开发的,安装前先检查一下系统否安装了Python2.4以上版本。下面以CentOS7.6,Python2.7.5版本环境下,介绍Supervisor的安装与配置步聚
一、实验环境
1、系统
root@localhost:/data# cat /etc/redhat-release
CentOS Linux release 7.7.1908 (Core)
2、Python版本
root@localhost:/data# python -V
Python 2.7.5
如果python版本低于2.6请升级，下面贴出一个安装python3.6.8的安装示例
yum install zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel gdbm-devel db4-devel libpcap-devel xz-devel -y libffi-devel
wget https://www.python.org/ftp/python/3.6.8/Python-3.6.8.tar.xz
tar xf Python-3.6.8.tar.xz
cd Python-3.6.8
./configure --prefix=/usr/local/python368
make && make install
echo 'export PATH=/usr/local/python368/bin:$PATH' >> /etc/profile
source /etc/profile
python3 -V
二、安装 Supervisor
安装 Supervisor的方法很多，以下介绍三种，我这里所采用的为第三种
1、easy_install 安装 supervisor
安装Python包管理工具(easy_install) easy_install是setuptools包里带的一个命令,使用easy_install实际上是在调用setuptools来完成安装模块的工作,所以安装setuptools即可:
wget https://pypi.io/packages/source/s/setuptools/setuptools-33.1.1.zip
unzip setuptools-33.1.1.zip
cd setuptools-33.1.1
python setup.py install
easy_install supervisor
2、pip 安装 supervisor
使用 pip 来安装，前提要保证pip版本大于2.6
pip install supervisor
3、yum epel-release 安装 supervisor
yum install -y epel-release && yum install -y supervisor
三、superviso命令
supervisor安装完成后会生成三个执行程序:supervisortd、supervisorctl、echo_supervisord_conf:
•supervisortd：用于管理supervisor本身服务
•supervisorctl：用于管理我们需要委托给superviso工具的服务
•echo_supervisord_conf：用于生成superviso的配置文件
•supervisor的守护进程服务(用于接收进程管理命令)
•客户端(用于和守护进程通信,发送管理进程的指令)
root@localhost:/data# which supervisord
/bin/supervisord
root@localhost:/data# which supervisorctl
/bin/supervisorctl
root@localhost:/data# which echo_supervisord_conf
/bin/echo_supervisord_conf
四、配置Supervisor
1、通过运行echo_supervisord_conf程序生成supervisor的初始化配置文件
如果使用yum安装则此步骤省略，直接进行修改配置文件步骤
mkdir /etc/supervisord.d
echo_supervisord_conf > /etc/supervisord.conf
2、修改配置文件
supervisor的配置文件内容有很多，不过好多都不需要修改就行使用，我这里只修改了以下两项
#修改socket文件的mode，默认是0700
sed -i 's/;chmod=0700/chmod=0766/g' /etc/supervisord.conf
#在配置文件最后添加以下两行内容来包含/etc/supervisord目录
sed -i '$a [include] \
files = /etc/supervisord.d/*.conf' /etc/supervisord.conf
五、编写需要被Supervisor管理的进程
1、SMProxy被Supervisor管理
说明:
SMProxy一个基于 MySQL 协议，Swoole 开发的MySQL数据库连接池。
它的原理是将数据库连接作为对象存储在内存中，当用户需要访问数据库时，首次会建立连接，后面并非建立一个新的连接，而是从连接池中取出一个已建立的空闲连接对象。 使用完毕后，用户也并非将连接关闭，而是将连接放回连接池中，以供下一个请求访问使用。而连接的建立、断开都由连接池自身来管理。同时，还可以通过设置连接池的参数来控制连接池中的初始连接数、连接的上下限数以及每个连接的最大使用次数、最大空闲时间等等。 也可以通过其自身的管理机制来监视数据库连接的数量、使用情况等。超出最大连接数会采用协程挂起，等到有连接关闭再恢复协程继续操作。
特性
- 支持读写分离
- 支持数据库连接池，能够有效解决 PHP 带来的数据库连接瓶颈
- 支持 SQL92 标准
- 采用协程调度
- 支持多个数据库连接，多个数据库，多个用户，灵活搭配
- 遵守 MySQL 原生协议，跨语言，跨平台的通用中间件代理
- 支持 MySQL 事务
- 支持 HandshakeV10 协议版本
- 完美兼容 MySQL5.5 - 8.0
- 兼容各大框架，无缝提升性能
官方网站：SMProxy
想要我们的SMProxy被Supervisor管理，就需要在/etc/supervisord.d目录下编写配置文件，SMProxy案例如下：
root@localhost:/data# cat /etc/supervisord.d/smproxy.conf
[program:smproxy]
directory=/data/SMProxy
command=/usr/local/php/bin/php /data/SMProxy/SMProxy start --console
autostart=true
startsecs=3
autorestart=true
startretries=3
user=root
priority=1
stopsignal=INT
redirect_stderr=true
stdout_logfile_maxbytes=200MB
stdout_logfile_backups = 100
stdout_logfile=/data/SMProxy/logs/catalina.out
stopasgroup=false
killasgroup=false
说明：
#程序唯一名称
[program:smproxy]
#程序路径
directory=/data/SMProxy
#运行程序的命令
command=/usr/local/php/bin/php /data/SMProxy/SMProxy start --console
#是否在supervisord启动后tomcat也启动
autostart=true
#启动3秒后没有异常退出，就表示进程正常启动了，默认为1秒
startsecs=3
#程序退出后自动重启,可选值：[unexpected,true,false]，默认为unexpected，表示进程意外杀死后才重启；意思为如果不是supervisord来关闭的该进程则认为不正当关闭，supervisord会再次把该进程给启动起来，只能使用该supervisorctl来进行关闭、启动、重启操作
autorestart=true
#启动失败自动重试次数，默认是3
startretries=3
#用哪个用户启动进程，默认是root
user=root
#进程启动优先级，默认999，假如Supervisord需要管理多个进程，那么值小的优先启动
priority=999
stopsignal=INT
#把stderr重定向到stdout标准输出，默认false
redirect_stderr=true
#stdout标准输出日志文件大小，日志文件大小到200M后则进行切割，切割后的日志文件会标示为catalina.out1,catalina.out2,catalina.out3...，默认50MB
stdout_logfile_maxbytes=200MB
#stdout标准输出日志文件备份数，保存100个200MB的日志文件，超过100个后老的将被删除，默认为10保存10个
stdout_logfile_backups = 100
#标准日志输出位置，如果输出位置不存在则会启动失败
stdout_logfile=/data/SMProxy/logs/catalina.out
#默认为false,进程被杀死时，是否向这个进程组发送stop信号，包括子进程
stopasgroup=false
#默认为false，向进程组发送kill信号，包括子进程
killasgroup=false
启动进程 使用supervisord管理启动后，当你使用/usr/local/php/bin/php /data/SMProxy/SMProxy stop或者kill $PID的时候，supervisord都会认为是意外关闭，会自动再次把进程拉起，除非是使用supervisord命令关闭。
#启动supervisord进程，我们在配置文件中设置了 autostart=true 参数，在supervisord启动的时候 smproxy也随之启动
root@localhost:/data# supervisord -c /etc/supervisord.conf
root@localhost:/data#
程序管理
supervisorctl status smproxy #smproxy状态
supervisorctl stop smproxy #停止smproxy
supervisorctl start smproxy #启动smproxy
supervisorctl restart smproxy #重启smproxy
supervisorctl reoload smproxy
程序管理例子
root@localhost:/data# supervisorctl status smproxy
smproxy RUNNING pid 7098, uptime 0:41:20
root@localhost:/data# supervisorctl stop smproxy
smproxy: stopped
root@localhost:/data# supervisorctl start smproxy
smproxy: started
root@localhost:/data# /data/SMProxy/SMProxy status
SMProxy[v1.3.1] - Linux localhost.localdomain 3.10.0-957.12.2.el7.x86_64 #1 SMP Tue May 14 21:24:32 UTC 2019 x86_64
Host: 0.0.0.0, Port: 3366, PHPVerison: 7.3.11
SwooleVersion: 4.4.17, WorkerNum: 2
Process : 24 total, 22 sleep, 2 query
+-----+------+-----------------+---------+---------+------+-----------+-----------------------------+----------------+-----------------------+---------------+----------------+
| ID | USER | HOST | DB | COMMAND | TIME | STATE | INFO | SERVER_VERSION | PLUGIN_NAME | SERVER_STATUS | SERVER_KEY |
+-----+------+-----------------+---------+---------+------+-----------+-----------------------------+----------------+-----------------------+---------------+----------------+
| 191 | root | localhost:54674 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | writeSΜtest_db |
| 192 | root | localhost:54680 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | writeSΜtest_db |
| 193 | root | localhost:54682 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | writeSΜtest_db |
| 195 | root | localhost:54688 | test_db | Query | 0 | executing | /*SMProxy processlist sql*/ | 8.0.13 | mysql_native_password | 2 | writeSΜtest_db |
| 196 | root | localhost:54692 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 197 | root | localhost:54696 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 198 | root | localhost:54700 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 199 | root | localhost:54704 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 200 | root | localhost:54708 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 201 | root | localhost:54712 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 202 | root | localhost:54716 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 203 | root | localhost:54720 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 204 | root | localhost:54724 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 205 | root | localhost:54728 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 206 | root | localhost:54732 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 207 | root | localhost:54736 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 208 | root | localhost:54740 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 209 | root | localhost:54744 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 210 | root | localhost:54748 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 211 | root | localhost:54752 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 212 | root | localhost:54756 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 213 | root | localhost:54760 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 214 | root | localhost:54764 | test_db | Query | 0 | executing | /*SMProxy processlist sql*/ | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
| 215 | root | localhost:54766 | test_db | Sleep | 75 | | | 8.0.13 | mysql_native_password | 2 | readSΜtest_db |
+-----+------+-----------------+---------+---------+------+-----------+-----------------------------+----------------+-----------------------+---------------+----------------+
当supervisord已经跑起来，再次跑supervisord -c /etc/supervisord.conf将会报错
root@localhost:/data# supervisord -c /etc/supervisord.conf
Error: Another program is already listening on a port that one of our HTTP servers is configured to use. Shut this program down first before starting supervisord.
For help, use /bin/supervisord -h
如果想重新再次开启supervisord，则kill supervisord 重新开启就好了：
root@localhost:/data# ps -ef | grep supervisord
root 7059 1 0 19:18 ? 00:00:00 /usr/bin/python /bin/supervisord -c /etc/supervisord.conf
root 7291 5986 0 20:13 pts/0 00:00:00 grep --color=auto supervisord
root@localhost:/data# kill -s SIGTERM 7059
root@localhost:/data# supervisord -c /etc/supervisord.conf
root@localhost:/data#
