概述
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管理界面了。
待解决问题
- xxx