Python & Supervisor

今天就来说一说Supervisor吧！

首先来介绍一下：Supervisor是个什么东西？

Supervisor的中文意思是监督人，主管的意思，那么在我们今天要说的这个supervisor也是同样的意思，只不过它监管的不是人，而是进程罢了。

Supervisor 是一个用 Python 写的进程管理工具，可以很方便的用来启动、重启、关闭进程。除了对单个进程的控制，还可以同时启动、关闭多个进程，比如很不幸的服务器由于某种原因暂时 kill 掉你的应用，此时可以用 Supervisor 让你的应用自动重启，如果是多个应用被杀死，也省去了手动一个一个地敲命令重新启动。

值得一说的是，到目前为止，supervisor还不支持在window上运行，只能在linux系统上运行。对于window的开发用户就显得有些苍白无力了。

好了，废话不多说，接下来我们就正式进入supervisor的主题了。

第一步安装supervisor：

目前为止supervisor，还是只支持python2，暂时还不支持python3，这就很尴尬了！

相信到了这一步已经有好多人看不下去了 ，不支持window也就算了，还不支持python3，你妹啊！这还怎么玩！

所以，关于supervisor到这里就结束了。

下期见！

读者

朋友们！

如果

你

还是

选择

往下翻

的话？

好吧，那我就继续讲下去，如果没有环境的可以去aws上注册一个linux的服务器，或者去微软搞个Azure都可以，这样我们就有了一套python2+linux的环境了。

首先安装supervisor：

pip install supervisor

装完了之后我们需要去看看它的配置文件，控制它做什么事情就全在这里了：

vim /etc/supervisor/supervisord.conf

然后将以下文件复制进去

；就是注释的意思

[unix_http_server]

file=/var/run/supervisor.sock   ; (the path to the socket file)

chmod=0700                       ; sockef file mode (default 0700)

[supervisord]

logfile=/var/log/supervisor/supervisord.log ; (main log file;default $CWD/supervisord.log)

pidfile=/var/run/supervisord.pid ; (supervisord pidfile;default supervisord.pid)

childlogdir=/var/log/supervisor            ; ('AUTO' child log dir, default $TEMP)

; the below section must remain in the config file for RPC

; (supervisorctl/web interface) to work, additional interfaces may be

; added by defining them in separate rpcinterface: sections

[rpcinterface:supervisor]

supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

[supervisorctl]

serverurl=unix:///var/run/supervisor.sock ; use a unix:// URL  for a unix socket

; The [include] section can just contain the "files" setting.  This

; setting can list multiple files (separated by whitespace or

; newlines).  It can also contain wildcards.  The filenames are

; interpreted as relative to this file.  Included files *cannot*

; include files themselves.

[include]

files = /etc/supervisor/conf.d/*.conf ;加载其他配置文件

[inet_http_server]         ; inet (TCP) server disabled by default

port=*:9001                ; 通过网页可以控制子进程

;username=user              ; (default is no username (open server))

;password=123               ; (default is no password (open server))

; 进程的配置样例

; 设置进程的名称，使用 supervisorctl 来管理进程时需要使用该进程名，这里的进程名是 your_program_name

[program:your_program_name]

;numprocs=1                 ; 进程数量，默认为1

;process_name=%(program_name)s   ; 默认为 %(program_name)s，即 [program:x] 中的 x

directory=/home/yiming ; 执行 command 之前，先切换到工作目录

command=python test.py

autostart=true ;如果设置为true，当supervisord启动的时候，进程会自动重启。

user=yiming                 ; 使用 yiming 用户来启动该进程

autorestart=true   ; 程序崩溃时自动重启，重启次数是有限制的，默认为3次

startsecs = 5        ; 启动 5 秒后没有异常退出，就当作已经正常启动了          

redirect_stderr=true        ; 错误日志重定向到标准输出

loglevel=info

基本配置就先说明一下：

username=user

使用supervisorctl连接的时候，认证的用户

password=123

和上面的用户名对应的密码，可以直接使用明码，也可以使用SHA加密

command=/bin/eventlistener

表示listener的可执行文件的路径

numprocs=1

相同的listener启动的个数

priority=-1

启动优先级，默认是-1

autostart=true

是否和supervisord启动一起启动，默认true

autorestart=true

是否自动重启，和program一个样，分true,false,unexpected等

startsecs=1

进程启动后跑了几秒钟后被认定为成功启动，默认1

startretries=3

失败最大尝试次数，默认3，当某个进程失败了，让她重启，默认三次

exitcodes=0,2

期望的进程退出码，0,和2是期望值，1是不期望值，会触发重启

stopasgroup=true

暂停某个进程的时候，将他的子进程也停掉，避免僵尸进程的存在，消耗CPU资源，默认false

killasgroup=true

同上，一般的将stopasgroup设为true的时候，这个也会变成true

[group:thegroupname]

给programs分组，划分到组里面的program，program被划分到组里面之后，就相当于原来的配置从supervisor的配置文件里消失了。supervisor只会对组进行管理，而不再会对组里面的单个program进行管理了

（想看更全的解释可以翻到最下面看表格）

下面要是说的是：使用 supervisorctl 管理进程

停止某一个进程：

supervisorctl stop program_name

启动某个进程：

supervisorctl start program_name

重启某个进程：

supervisorctl restart program_name

停止全部进程：

supervisorctl stop all

载入最新的配置文件，停止原有进程并按新的配置启动、管理所有进程：

supervisorctl reload

根据最新的配置文件，启动新配置或有改动的进程，配置没有改动的进程不会受影响而重启：

supervisorctl update

配置参数及概念一览：