web：supervisor 安装

文档：http://supervisord.org/introduction.html
supervisor 是什么我就不说了，下面就来说一下我一天半的安装踩坑之旅。
我是在 Ubuntu 系统上进行的安装，采用的是 apt-get 的方式：

sudo apt-get install supervisor

一、安装

1、使用上面的命令进行安装。
2、安装成功后你需要在终端进入到 /etc/supervisor 文件夹，然后输入 echo_supervisord_conf

ouer@ouer-virtual-machine:/etc/supervisor$ echo_supervisord_conf

然后正常情况下你应该会看到，控制台输出一堆内容（其实是supervisor的默认配置文件的内容）
然后再执行：

ouer@ouer-virtual-machine:/etc/supervisor$ echo_supervisord_conf > /etc/supervisor/supervisord.conf
如果出现没有权限的问题，可以使用这条命令
sudo su - root -c "echo_supervisord_conf > /etc/supervisor/supervisord.conf"

就是把配置文件（supervisord.conf）创建到 /etc/supervisor文件夹下。

3、使用这种方式创建的默认配置文件有些地方是需要更改的。
supervisord.pid 以及 supervisor.sock 是放在 /tmp 目录下，但是 /tmp 目录是存放临时文件，里面的文件是会被 Linux 系统删除的，一旦这些文件丢失，就无法再通过 supervisorctl 来执行 restart 和 stop 命令了。会报错。
因此：

[unix_http_server]
;file=/tmp/supervisor.sock   ; (the path to the socket file)
;修改为 /var/run 目录，避免被系统删除
file=/var/run/supervisor.sock   ; (the path to the socket file)
;chmod=0700                 ; socket file mode (default 0700)
;chown=nobody:nogroup       ; socket file uid:gid owner
;username=user              ; (default is no username (open server))
;password=123               ; (default is no password (open server))

;[inet_http_server]         ; inet (TCP) server disabled by default
;port=127.0.0.1:9001        ; (ip_address:port specifier, *:port for ;all iface)
;username=user              ; (default is no username (open server))
;password=123               ; (default is no password (open server))
...

[supervisord]
;logfile=/tmp/supervisord.log ; (main log file;default $CWD/supervisord.log)
;修改为 /var/log 目录，避免被系统删除
logfile=/var/log/supervisor/supervisord.log ; (main log file;default $CWD/supervisord.log)
logfile_maxbytes=50MB        ; (max main logfile bytes b4 rotation;default 50MB)
logfile_backups=10           ; (num of main logfile rotation backups;default 10)
loglevel=info                ; (log level;default info; others: debug,warn,trace)
;pidfile=/tmp/supervisord.pid ; (supervisord pidfile;default supervisord.pid)
;修改为 /var/run 目录，避免被系统删除
pidfile=/var/run/supervisord.pid ; (supervisord pidfile;default supervisord.pid)
...
;设置启动supervisord的用户，一般情况下不要轻易用root用户来启动，除非你真的确定要这么做
;user=chrism                 ; (default is current user, required if root)
...

[supervisorctl]
; 必须和'unix_http_server'里面的设定匹配
;serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL  for a unix socket
;修改为 /var/run 目录，避免被系统删除
serverurl=unix:///var/run/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=chris              ; should be same as http_username if set
;password=123                ; should be same as http_password if set
...

设置好配置文件后，应先创建上述配置文件中新增的文件夹。如果指定了启动用户 user，那么应注意相关文件的权限问题，包括日志文件，否则会出现没有权限的错误。

Error: Cannot open an HTTP server: socket.error reported errno.EACCES (13)

需要为刚才创建的文件夹赋予权限：

sudo chmod 777 /run
sudo chmod 777 /var/log

4、还有个 include 的问题：
其实你把自己的项目配置在默认配置文件中也可以，不过我可不想那么干。因此就的说到include。在默认的配置文件中include是被注释了的（;）,首先你需要打开注释，然后配置你自己的配置文件的路径。

[include]
files = /etc/supervisord.d/*.ini 可以是.conf 或者 .ini

5、使用浏览器管理
supervisor 同时提供了通过浏览器来管理进程的方法，只需要打开下面代码的注释就可以了。（就是把前面的；删除）

;[inet_http_server]         ; inet (TCP) server disabled by default
;port=127.0.0.1:9001        ; (ip_address:port specifier, *:port for ;all iface)
;username=user              ; (default is no username (open server))
;password=123               ; (default is no password (open server))

然后通过浏览器访问 127.0.0.1:9001 就会看到管理界面。

二、命令

supervisord : 启动supervisor
supervisorctl reload :修改完配置文件后重新启动supervisor
supervisorctl status :查看supervisor监管的进程状态
supervisorctl start 进程名 ：启动XXX进程
supervisorctl stop 进程名 ：停止XXX进程
supervisorctl stop all：停止全部进程，注：start、restart、stop都不会载入最新的配置文件。
supervisorctl update：根据最新的配置文件，启动新配置或有改动的进程，配置没有改动的进程不会受影响而重启

参考博客：http://www.cnblogs.com/restran/p/4854623.html
参考博客：http://www.ttlsa.com/linux/using-supervisor-control-program/