Supervisor

supervisor介绍

首先，介绍一下supervisor。Supervisor（http://supervisord.org）是用Python开发的一个client/server服务，是Linux/Unix系统下的一个进程管理工具，不支持Windows系统。它可以很方便的监听、启动、停止、重启一个或多个进程。用Supervisor管理的进程，当一个进程意外被杀死，supervisort监听到进程死后，会自动将它重新拉起，很方便的做到进程自动恢复的功能，不再需要自己写shell脚本来控制
环境：centos7.4

安装supervisor

1	pip install supervisor

因为是python开发的一个库，可以直接用pip来安装，很方便。
supervisor安装完成后会生成三个执行程序：supervisortd、supervisorctl、echo_supervisord_conf，分别是supervisor的守护进程服务（用于接收进程管理命令）、客户端（用于和守护进程通信，发送管理进程的指令）、生成初始配置文件程序。

设置环境变量

1 2 3 4

$ vim ~/.bash_profile #在后面补充： PATH=$PATH:$HOME/bin:/usr/local/python/bin $ source ~/.bash_profile

配置supervisor

创建目录，初始化配置文件

1 2	mkdir /etc/supervisor echo_supervisord_conf > /etc/supervisor/supervisord.conf

主配置文件参数

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

[unix_http_server] file=/tmp/supervisor.sock   ; UNIX socket 文件，supervisorctl 会使用 ;chmod=0700                 ; socket 文件的 mode，默认是 0700 ;chown=nobody:nogroup       ; socket 文件的 owner，格式： uid:gid     ;[inet_http_server]         ; HTTP 服务器，提供 web 管理界面 ;port=127.0.0.1:9001        ; Web 管理后台运行的 IP 和端口，如果开放到公网，需要注意安全性 ;username=user              ; 登录管理后台的用户名 ;password=123               ; 登录管理后台的密码     [supervisord] logfile=/tmp/supervisord.log ; 日志文件，默认是 $CWD/supervisord.log logfile_maxbytes=50MB        ; 日志文件大小，超出会 rotate，默认 50MB logfile_backups=10           ; 日志文件保留备份数量默认 10 loglevel=info                ; 日志级别，默认 info，其它: debug,warn,trace pidfile=/tmp/supervisord.pid ; pid 文件 nodaemon=false               ; 是否在前台启动，默认是 false，即以 daemon 的方式启动 minfds=1024                  ; 可以打开的文件描述符的最小值，默认 1024 minprocs=200                 ; 可以打开的进程数的最小值，默认 200     ; 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:///tmp/supervisor.sock ; 通过 UNIX socket 连接 supervisord，路径与 unix_http_server 部分的 file 一致 ;serverurl=http://127.0.0.1:9001 ; 通过 HTTP 的方式连接 supervisord     ; 包含其他的配置文件 [include] files = relative/directory/*.ini    ; 可以是 *.conf 或 *.ini

管理一个进程

把所有被管理的进程配置文件都放在同一个目录，主配置文件包含进去。

1	mkdir /etc/supervisor/config.d

1 2 3

vim /etc/supervisor/supervisord.conf [include] files = /etc/supervisor/config.d/*.conf

新建一个配置文件

1 2 3 4 5 6 7 8 9 10 11

[program:sougou]   #souogu 为程序的名称 command=scrapy crawl sougou #需要执行的命令 directory=/home/mzj/桌面/sougou/sougou/wechat_name/wechat_name/spiders  #命令执行的目录 environment=ASPNETCORE__ENVIRONMENT=Production #环境变量 user=root #用户 stopsignal=INT autostart=true #是否自启动 autorestart=true #是否自动重启 startsecs=3 #自动重启时间间隔（s） stderr_logfile=/home/mzj/桌面/sougou/sougou/wechat_name/wechat_name/spiders/ossoffical.err.log #错误日志文件 stdout_logfile=/home/mzj/桌面/sougou/sougou/wechat_name/wechat_name/spiders/ossoffical.out.log #输出日志文件

1 2 3 4 5 6 7 8

[program:nginx] command = /usr/local/nginx/sbin/nginx -g 'daemon off;' startsecs = 3 autostart = true autorestart = true user = root stdout_logfile = /etc/supervisor/logs/supervisord-nginx.log stderr_logfile = /etc/supervisor/logs/supervisord-nginx-error.log

刚开始有个坑，command = /usr/local/nginx/sbin/nginx 我是这样写的 结果就一直启动nginx 因为这样的话 是后台运行的nginx，然而supervisor 不能管理后台运行进程，所以把nginx daemon off 守护关掉，就让他阻塞在前台bash运行，方便supervisor来管理。

supervisor配置文件详解

• 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

启动supervisor

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

有时候kill进程之后需要释放连接

1	unlink /tmp/supervisor.sock

web界面管理 开启web访问

1 2 3 4 5

vi /etc/supervisor/supervisord.conf [inet_http_server]        port=0.0.0.0:9001       username=user            password=123

此处需要注意将 [inet_http_server] 前边的注释也要去掉

supervisorctl的用法

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

 vim /etc/supervisord.conf

[program:xxxxx111]
command=python3 -m gunicorn -c gunicorn_config.py run:app
user=root
autorstart=true
directory=/home/xxxxx111
autorestart=true
startsecs=5
startretries=3
redirect_stderr=true
stopasgroup=true
killasgroup=true
stdout_logfile=/home/xxxxx111/log/out.log
stderr_logfile=/home/xxxxx111/log/err.log