专栏首页Python乱炖Python & Supervisor

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

本文分享自微信公众号 - Python乱炖(Cooking_python)

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2019-01-10

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • [日常] nginx的错误日志error_log设置

    nginx error_log设置 1.error_log syslog:server=192.168.1.1 [级别] //直接发送给远程syslog日志集中...

    陶士涵
  • 手把手教你做一个“渣”数据师,用Python代替老情人Excel

    现在,要成为一个合格的数据分析师,你说你不会Python,大概率会被江湖人士耻笑。

    大数据文摘
  • malloc,free,calloc,realloc函数

    版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。

    村雨
  • [PHP] PHP在CLI环境下的错误日志

    1. display_errors = Off;//控制php是否输出错误;在生产环境中输出会泄露敏感信息;建议记录错误而不是将它们发送到STDOUT off ...

    陶士涵
  • [PHP] PHP数组的实现哈希表(HashTable)结构

    PHP中使用最为频繁的数据类型非字符串和数组莫属,使用哈希表实现的PHP数组。 1.数据结构:保存哈希表容器,保存数据的容器 2.哈希函数实现:需要尽可能的将不...

    陶士涵
  • Node.js 应用最佳实践:日志[每日前端夜话0xBB]

    日志记录是每个开发人员从第一天编写代码时就要做的事情,但很少有人知道它可以产生的价值和最佳实践。

    疯狂的技术宅
  • [每日前端夜话0xBB]

    日志记录是每个开发人员从第一天编写代码时就要做的事情,但很少有人知道它可以产生的价值和最佳实践。

    疯狂的技术宅
  • [日常] Go语言圣经-Panic异常,Recover捕获异常习题

    Go语言圣经-Panic异常 1.当panic异常发生时,程序会中断运行,并立即执行在该goroutine中被延迟的函数(defer 机制) 2.不是所有的pa...

    陶士涵
  • [android] ndk环境的搭建

    C语言在windows上==> .o中间文件 ==>.exe可执行文件 打包函数是.dll文件

    陶士涵
  • IEEE 2019编程语言排行榜出炉:趋势、开源、职位需求,Python都是第一

    这是 IEEE Spectrum 的第六次年度编程语言排行统计。今年的统计进行了重大改革,一些基础指标进行了重构,而最终的排行榜也进一步得到了简化。但其基本理念...

    机器之心

扫码关注云+社区

领取腾讯云代金券