使用supervisor来启动管理服务

supervisor 使用方法

supervisor(官网)是一个unix的系统进程管理软件，可以用它来管理apache、nginx等服务，
若服务挂了可以让它们自动重启。当然也可以用来实现golang的守护进程.

学完这篇教程后,我们希望达到如下的目标:

• 服务挂掉后,自动重启
• 可执行文件或者配置文件修改后,服务自动重启

让我们开始吧!

1.supervisor安装

1.以上tar包任意目录解压

# ubuntu安装：
sudo apt-get install supervisor 
# centos安装
yum install -y supervisor 
# 基于python库安装
pip2 install supervisor
easy_install supervisor

安装好之后，不出问题的话supervisor服务已经启动完成。

查看进程是否启动成功

pgrep supervisord

出现进程号之后表面成功启动

手动启动进程

如果上一步没发现进程号,那么可以执行下面的命令

supervisord -c  /etc/supervisor/supervisord.conf

2.supervisor配置

打开配置文件supervisord.conf

# 配置文件一般在如下位置:
> vim /etc/supervisor/supervisord.conf 

我们可以看到文件的最后有这么一句话

[include]
files = /etc/supervisor/conf.d/*.conf

也就是说配置文件会引入/etc/supervisor/conf.d/目录下所有conf后缀的文件.

创建自定义的服务配置文件

所以我们可以在/etc/supervisor/conf.d/下建立文件ipfs.conf

注意: 日志路径不存在会启动失败! supervisor不会自己创建目录!

; 设置进程的名称，使用 supervisorctl 来管理进程时需要使用该进程名
[program:ipfs] 
directory = /usr/local/bin            ; 程序的启动目录
command=/usr/local/bin/ipfs daemon    ; 启动命令 最好绝对路径
autostart = true                      ; 在 supervisord 启动的时候也自动启动
numprocs=1                            ; 默认为1
process_name=%(program_name)s         ; 默认为 %(program_name)s，即 [program:x] 中的 x
user=root                             ; 使用 root 用户来启动该进程
autorestart=true                      ; 程序崩溃时自动重启，重启次数是有限制的，默认为3次
redirect_stderr=true                  ; 重定向输出的日志
stdout_logfile = /var/log/supervisord/tornado_server.log
loglevel=info

配置文件中的注释以;打头

保存配置文件,重启

> supervisorctl reload

3.supervisor常用命令

supervisor有supervisord和supervisorctl两种命令类型:

• supervisord是服务相关的命令
• supervisorctl是客户端相关的命令

supervisor涉及的状态主要有

• running：进程处于运行状态
• starting：Supervisor 收到启动请求后，进程处于正在启动过程中
• stopped：进程处于关闭状态
• stopping：Supervisor 收到关闭请求后，进程处于正在关闭过程中
• backoff：进程进入 starting 状态后，由于马上就退出导致没能进入 running 状态
• fatal：进程没有正常启动
• exited：进程从 running 状态退出

常用的命令如下:

#关闭所有任务
supervisorctl shutdown 
# 启动某个进程
supervisorctl start programxxx
# 重启某个进程
supervisorctl restart programxxx
# 停止全部进程 注：start、restart、stop都不会载入最新的配置文件
supervisorctl stop all
# 载入最新的配置文件，停止原有进程并按新的配置启动、管理所有进程。
supervisorctl reload
# 根据最新的配置文件，启动新配置或有改动的进程，配置没有改动的进程不会受影响而重启。
supervisorctl update

注意：显式用stop停止掉的进程，用reload或者update都不会自动重启

4.自动侦测文件变化并重启服务

4.可能遇到的错误

无权限错误

error: <class 'socket.error'>, [Errno 2] No such file or directory: 
file: /usr/lib/python2.7/socket.py line: 228

解决方案: 重启服务

> supervisord -c /etc/supervisor/supervisord.conf 
Error: The directory named as part of the path /var/log/supervisor/archive/info.log　　　 does not exist. in section 'program:archive' (file: '/etc/supervisor/conf.d/archive.conf')
For help, use /usr/bin/supervisord -h

或者可能是supervisor服务未启动

> service  supervisor  start 

配置命令错误

参考链接: supervisorctl always reports error: ERROR (no such file)

> sudo supervisorctl start archive
archive: ERROR (no such file)

执行下面命令发现报错

> sudo supervisorctl status
archive                          FATAL     can't find command './archive'

说明supervisor无法解析该指令

解决方法:配置文件执行指令补全

[program:archive]   
# 改变前:
command=archive　　　　　　　　　 
# 改变后:                         
command=/opt/deploy/archive/archive　　　　　　　　　 
...