CentOS 使用 Supervisior 部署程序

1. 安装

Supervisor 支持在 python 2.4 或更高版本下运行，不支持 python 3。CentOS 默认安装了 Python 2.7.5。

# easy_install supervisor

2. 生成配置文件

#  mkdir /etc/supervisor/ && touch /etc/supervisor/supervisord.conf
#  echo_supervisord_conf > /etc/supervisor/supervisord.conf

3. 编辑配置文件

$ mkdir -p /var/run && chmod 777 /var/run
$ mkdir -p /var/log && chmod 777 /var/log

这里只列出了一些常用配置项：

[unix_http_server]
file=/var/run/supervisor.sock   ; UNIX socket 文件，supervisorctl 会使用

;[inet_http_server]         ; HTTP 服务器，提供 web 管理界面
;port=127.0.0.1:9001        ; Web 管理后台运行的 IP 和端口，如果开放到公网，需要注意安全性
;username=user              ; 登录管理后台的用户名
;password=123               ; 登录管理后台的密码

[supervisord]
logfile=/var/log/supervisord.log ; 日志文件，默认是 $CWD/supervisord.log
pidfile=/var/run/supervisord.pid ; pid 文件

; 包含其他的配置文件
[include]
files = /etc/supervisor/conf.d/*.conf

我们把上面这部分配置保存到 /etc/supervisor/supervisord.conf（或其他任意有权限访问的文件），然后启动 supervisord（通过 -c 选项指定配置文件路径，如果不指定会按照这个顺序查找配置文件：$CWD/supervisord.conf,
$CWD/etc/supervisord.conf, /etc/supervisord.conf, /etc/supervisor/supervisord.conf）：

# supervisord -c /etc/supervisor/supervisord.conf

查看 supervisord 是否在运行：

# ps -A | grep supervisord

4. 编辑程序运行配置

添加程序运行配置文件，下面以日志服务 thrift-log 在开发联调环境运行为例:

# mkdir -p /etc/supervisor/conf.d
# cd /etc/supervisor/conf.d
# vim thrift-log.conf

输入下列内容：

[program:thrift-log]
directory = /gowork/src/bisale/thrift-log          ; 程序的启动目录
command = go run log_server.go                     ; 启动命令
autostart = true       ; 在 supervisord 启动的时候也自动启动
startsecs = 5          ; 启动 5 秒后没有异常退出，就当作已经正常启动了
autorestart = true     ; 程序异常退出后自动重启
startretries = 3       ; 启动失败自动重试次数，默认是 3
user = root            ; 用哪个用户启动
redirect_stderr = true          ; 把 stderr 重定向到 stdout，默认 false
stdout_logfile_maxbytes = 20MB  ; stdout 日志文件大小，默认 50MB
stdout_logfile_backups = 20     ; stdout 日志文件备份数
environment=GO_ENV=debug,NODE_ENV=debug

; stdout 日志文件，需要注意当指定目录不存在时无法正常启动，所以需要手动创建目录（supervisord 会自动创建日志文件）
stdout_logfile = /opt/logs/thrift-log/thrift-log-stdout.log

无备注版（在跳板机界面下编辑大量中文容易卡死）：

[program:thrift-log]
directory = /gowork/src/bisale/thrift-log          
command = go run log_server.go                     
autostart = true       
startsecs = 5          
autorestart = true 
startretries = 3      
user = root           
redirect_stderr = true  
stdout_logfile_maxbytes = 20MB  
stdout_logfile_backups = 20     
environment=GO_ENV=debug,NODE_ENV=debug
stdout_logfile = /opt/logs/thrift-log/thrift-log-stdout.log

5. 使用 supervisorctl

Supervisorctl 是 supervisord 的一个命令行客户端工具，启动时需要指定与 supervisord 使用同一份配置文件，否则与 supervisord 一样按照顺序查找配置文件。

# supervisorctl -c /etc/supervisor/supervisord.conf

上面这个命令会进入 supervisorctl 的 shell 界面，然后可以执行不同的命令了

> status                # 查看程序状态
> stop thrift-log       # 关闭 usercenter 程序
> start thrift-log      # 启动 usercenter 程序
> restart thrift-log    # 重启 usercenter 程序
> reread               ＃ 读取有更新（增加）的配置文件，不会启动新添加的程序
> update               ＃ 重启配置文件修改过的程序

上面这些命令都有相应的输出，除了进入 supervisorctl 的 shell 界面，也可以直接在 bash 终端运行：

$ supervisorctl status
$ supervisorctl stop thrift-log
$ supervisorctl start thrift-log
$ supervisorctl restart thrift-log
$ supervisorctl reread
$ supervisorctl update

6. 参考文档

1. http://supervisord.org/index.html
2. 使用 supervisor 管理进程