supervisor简介:
官方文档:http://supervisord.org/index.html
Supervisor (http://supervisord.org) 是一个用 Python 写的进程管理工具,可以很方便的用来启动、重启、关闭进程(不仅仅是 Python 进程)。除了对单个进程的控制,还可以同时启动、关闭多个进程,比如很不幸的服务器出问题导致所有应用程序都被杀死,此时可以用 supervisor 同时启动所有应用程序而不是一个一个地敲命令启动。
Supervisor安装及使用:
http://liyangliang.me/posts/2015/06/using-supervisor/
注:精简版的安装、启动和管理进程可直接看加粗部分的内容
安装:
Supervisor 可以运行在 Linux、Mac OS X 上。如前所述,supervisor 是 Python 编写的,所以安装起来也很方便,可以直接用 pip :
pip安装
|
安装遇到问题怎么办:Google或百度之,肯定有人跟你遇到过同样的问题。
配置:
Supervisor 相当强大,提供了很丰富的功能,不过我们可能只需要用到其中一小部分。安装完成之后,可以编写配置文件,来满足自己的需求。
为了方便,我们把配置分成两部分:supervisord(supervisor 是一个 C/S 模型的程序,这是 server 端,对应的有 client 端:supervisorctl)和应用程序(即我们要管理的程序)。
首先来看 supervisord 的配置文件。安装完 supervisor 之后,可以运行echo_supervisord_conf
命令输出默认的配置项,也可以重定向到一个配置文件里:
输出配置文件到/etc下
|
去除里面大部分注释和“不相关”的部分,我们可以先看这些配置:(如果没有特殊需要,可以)
|
启动
我们把上面这部分配置保存到 /etc/supervisord.conf(或其他任意有权限访问的文件),然后启动 supervisord(通过 -c 选项指定配置文件路径,如果不指定会按照这个顺序查找配置文件:$CWD/supervisord.conf, $CWD/etc/supervisord.conf, /etc/supervisord.conf):
|
查看 supervisord 是否在运行:
|
配置需要管理的进程
上面我们已经把 supervisrod 运行起来了,现在可以添加我们要管理的进程的配置文件。可以把所有配置项都写到 supervisord.conf 文件里,但并不推荐这样做,而是通过 include 的方式把不同的程序(组)写到不同的配置文件里。
为了举例,我们新建一个目录 /etc/supervisor/ 用于存放这些配置文件,相应的,把 /etc/supervisord.conf 里 include 部分的的配置修改一下:
|
举例说明:
现在我要管理jmeter的服务进程,jmeter是一个java服务,本身提供了启动服务的shell脚本,在命令行启动jmeter的服务时这样的:
|
现在编写一份配置文件来管理这个进程(可配置的内容很多,这里只列出了一些基本的选项),注意配置文件需要放在上一步骤中 supervisord.conf的include配置的目录下,并按照配置进行命名。按照本文的配置,文件为/etc/supervisor/jmeter.conf
|
一份配置文件至少需要一个 [program:x]
部分的配置,来告诉 supervisord 需要管理那个进程。[program:x]
语法中的 x
表示 program name,会在客户端(supervisorctl 或 web 界面)显示,在 supervisorctl 中通过这个值来对程序进行 start、restart、stop 等操作。
让supervisord重新加载配置
|
查看你的进程是否被supervisor正确启动
|
使用(管理进程)
Supervisorctl 是 supervisord 的一个命令行客户端工具,启动时需要指定与 supervisord 使用同一份配置文件,否则与 supervisord 一样按照顺序查找配置文件。
|
上面这个命令会进入 supervisorctl 的 shell 界面,然后可以执行不同的命令了:
|
上面这些命令都有相应的输出,除了进入 supervisorctl 的 shell 界面,也可以直接在 bash 终端运行:
|
常见问题
运行一段时间后遇到 "unix:///tmp/supervisor.sock no such file " 错误,造成supervisord服务挂掉、无法启动的问题
原因:supervisor默认配置会把socket文件和pid守护进程生成在/tmp/
目录下,/tmp/
目录是缓存目录,Linux会根据不同情况自动删除其下面的文件。原因找到了,就好办了,将supervisor配置文件里的相应地方改掉就好了。
修改配置后重新启动supervisor服务即可。
参考资料:http://www.cashqian.net/blog/001472975510127673ea63db9234c4e8293cf43cefcafde000