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配置参数及概念一览：
参数 | 参数解释 |
|---|---|
command | 启动程序使用的命令，可以是绝对路径或者相对路径 |
process_name | 一个python字符串表达式，用来表示supervisor进程启动的这个的名称，默认值是%(program_name)s |
numprocs | Supervisor启动这个程序的多个实例，如果numprocs>1，则process_name的表达式必须包含%(process_num)s，默认是1 |
numprocs_start | 一个int偏移值，当启动实例的时候用来计算numprocs的值 |
priority | 权重，可以控制程序启动和关闭时的顺序，权重越低：越早启动，越晚关闭。默认值是999 |
autostart | 如果设置为true，当supervisord启动的时候，进程会自动重启。 |
autorestart | 值可以是false、true、unexpected。false：进程不会自动重启，unexpected：当程序退出时的退出码不是exitcodes中定义的时，进程会重启，true：进程会无条件重启当退出的时候。 |
startsecs | 程序启动后等待多长时间后才认为程序启动成功 |
startretries | supervisord尝试启动一个程序时尝试的次数。默认是3 |
exitcodes | 一个预期的退出返回码，默认是0,2。 |
stopsignal | 当收到stop请求的时候，发送信号给程序，默认是TERM信号，也可以是 HUP, INT, QUIT, KILL, USR1, or USR2。 |
stopwaitsecs | 在操作系统给supervisord发送SIGCHILD信号时等待的时间 |
stopasgroup | 如果设置为true，则会使supervisor发送停止信号到整个进程组 |
killasgroup | 如果设置为true，则在给程序发送SIGKILL信号的时候，会发送到整个进程组，它的子进程也会受到影响。 |
user | 如果supervisord以root运行，则会使用这个设置用户启动子程序 |
redirect_stderr | 如果设置为true，进程则会把标准错误输出到supervisord后台的标准输出文件描述符。 |
stdout_logfile | 把进程的标准输出写入文件中，如果stdout_logfile没有设置或者设置为AUTO，则supervisor会自动选择一个文件位置。 |
stdout_logfile_maxbytes | 标准输出log文件达到多少后自动进行轮转，单位是KB、MB、GB。如果设置为0则表示不限制日志文件大小 |
stdout_logfile_backups | 标准输出日志轮转备份的数量，默认是10，如果设置为0，则不备份 |
stdout_capture_maxbytes | 当进程处于stderr capture mode模式的时候，写入FIFO队列的最大bytes值，单位可以是KB、MB、GB |
stdout_events_enabled | 如果设置为true，当进程在写它的stderr到文件描述符的时候，PROCESS_LOG_STDERR事件会被触发 |
stderr_logfile | 把进程的错误日志输出一个文件中，除非redirect_stderr参数被设置为true |
stderr_logfile_maxbytes | 错误log文件达到多少后自动进行轮转，单位是KB、MB、GB。如果设置为0则表示不限制日志文件大小 |
stderr_logfile_backups | 错误日志轮转备份的数量，默认是10，如果设置为0，则不备份 |
stderr_capture_maxbytes | 当进程处于stderr capture mode模式的时候，写入FIFO队列的最大bytes值，单位可以是KB、MB、GB |
stderr_events_enabled | 如果设置为true，当进程在写它的stderr到文件描述符的时候，PROCESS_LOG_STDERR事件会被触发 |
environment | 一个k/v对的list列表 |
directory | supervisord在生成子进程的时候会切换到该目录 |
umask | 设置进程的umask |
serverurl | 是否允许子进程和内部的HTTP服务通讯，如果设置为AUTO，supervisor会自动的构造一个url |