Supervisor: A Process Control System（进程控制系统）

概述

Supervisor是一个客户端/服务器系统，允许类UNIX操作系统用户管理大量进程（进程控制系统）。

我认识到Supervisor是因为Python的项目（Flask）是通过Gunicorn部署的，然后本地通过Fabric自动化部署到服务器上，这样通过Supervisor管理Gunicorn进程会比较方便。

以下的一些操作是我在安装和适配过程中的一些笔记，不断完善中。。。

---

安装

easy_install

easy_install supervisor

通过pip安装

pip install supervisor

其它安装方式请参考官网：http://www.supervisord.org/installing.html

初始化配置文件
当Supervisor安装完成后，执行echo_supervisord_conf可以打印默认的配置文件到控制台。

如果你有系统的root权限，可以执行echo_supervisord_conf > /etc/supervisord.conf把配置文件导出到/etc目录下，可以在启动的时候使用supervisord 加-c的参数指定配置配置文件的路径

---

运行Supervisor

添加一个项目

通过编辑supervisord.conf配置文件，在文件结尾加入program标签声明一个项目，声明完毕后，当你运行supervisord命令后就可以管理这个项目啦。

一个例子：

[program:foo]
command=/bin/cat

启动gunicorn：

[program:hole_project]
;supervisor启动命令
command = /var/www/Hole/venv/bin/gunicorn -w 4 -b 127.0.0.1:8000 Hole:app
;项目的文件夹路径
directory = /var/www/Hole
user = root
;log 日志
stdout_logfile=/var/log/Hole.log
;错误日志
stderr_logfile=/var/log/Hole.err

常用命令

# 启动
supervisord -c /etc/supervisord.conf

# 修改配置文件生效
supervisorctl reread

# 重新加载（会重新启动supervisor）
supervisorctl reload

# 重启项目
supervisorctl restart project_name

---

开机启动

针对不同的操作系统，有不同的启动方式，因为我的服务器是CentOS系统，所以这里只是做CentOS系统配置开机启动Supervisor的说明，可以在官网找到其它系统的指导：http://www.supervisord.org/running.html#running-supervisord-automatically-on-startup

服务器操作系统版本是：CentOS 7.3

7.x的操作系统开机启动脚本位置对于6.x的版本有一些变化，在/usr/lib/systemd/目录下，有系统（system）和用户（user）区分,如需要开机没有登陆情况下就能运行的程序，存在系统服务（system）里，即：/lib/systemd/system/，反之，用户登录后才能运行的程序，存在用户（user）里，服务以.service结尾。

在/lib/systemd/system/目录下新建supervisor.service，文件中输入以下内容：

# supervisord service for systemd (CentOS 7.0+)
# by ET-CS (https://github.com/ET-CS)
[Unit]
Description=Supervisor daemon

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

[Install]
WantedBy=multi-user.target

保存后修改文件权限为754，然后执行systemctl enable supervisor.service设置为开机启动。

---

WEB管理界面

Supervisor还提供一个WEB管理界面，只需要简单的配置就能够通过友好的可视化界面控制操作。

编辑配置文件vim supervisord.conf

;打开注解（删掉前面的";"）
[inet_http_server]         ; inet (TCP) server disabled by default
port=*:9001                ; ip_address:port specifier, *:port for all iface
username=admin             ; default is no username (open server)
password=admin             ; default is no password (open server)

[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL  for a unix socket
serverurl=http://127.0.0.1:9001 ; use an http:// url to specify an inet socket
username=admin               ; should be same as in [*_http_server] if set
password=admin               ; should be same as in [*_http_server] if set
;prompt=mysupervisor         ; cmd line prompt (default "supervisor")
;history_file=~/.sc_history  ; use readline history if available

port=*:9001表示监听本地9001端口，允许任何主机访问
如果本地有防火墙，记得打开9001端口的访问权限。
然后在浏览器输入http://<你的IP地址>:9001，就可以打开WEB管理界面了。

WEB管理界面截图

---

待解决问题

• xxx