简介
supervisord是一个进程管理工具,可以把其它进程当作supervisord的子进程进行管理,主要功能包括对子进程的状态监控、子进程异常自动重启、子进程异常信息收集等功能。
安装supervisor
首先切换为root用户然后使用yum命令安装
yum install epel-release
yum install -y supervisor
或者
easy_install supervisor
查看配置文件
安装supervisor后会自动生成一个默认的supervisord.conf文件,可以直接使用该配置文件,一般的功能都可以使用
cat /etc/supervisord.conf
; Sample supervisor config file.
[unix_http_server]
file=/var/run/supervisor/supervisor.sock ; (the path to the socket file) ;UNIX socket 文件,supervisorctl 会使用
;chmod=0700 ; sockef file mode (default 0700) ;socket文件的mode,默认是0700
;chown=nobody:nogroup ; socket file uid:gid owner ;socket文件的owner,格式:uid:gid
;username=user ; (default is no username (open server))
;password=123 ; (default is no password (open server))
file = /tmp/supervisor.sock
chmod = 0777
username = admin
password = 12345
[inet_http_server] ;HTTP服务器,提供web管理界面
port = *:9001;Web管理后台运行的IP和端口,如果开放到公网,需要注意安全性
username = admin;登录管理后台的用户名
password = 12345 ;登录管理后台的密码
;[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=/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=/var/run/supervisord.pid ; (supervisord pidfile;default supervisord.pid)
nodaemon=false ; (start in foreground if true;default false)
minfds=1024 ; (min. avail startup file descriptors;default 1024)
minprocs=200 ; (min. avail process descriptors;default 200)
user = root
;umask=022 ; (process file creation umask;default 022)
;user=chrism ; (default is current user, required if root)
;identifier=supervisor ; (supervisord identifier, default is 'supervisor')
;directory=/tmp ; (default is not to cd during start)
;nocleanup=true ; (don't clean up tempfiles at start;default false)
;childlogdir=/tmp ; ('AUTO' child log dir, default $TEMP)
;environment=KEY=value ; (key value pairs to add to environment)
;strip_ansi=false ; (strip ansi escape codes in logs; def. false)
; 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/supervisor.sock ; use a unix:// URL for a unix socket
serverurl=unix:///tmp/supervisor.sock
username = admin
password = 12345
prompt = admin user
;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
;prompt=mysupervisor ; cmd line prompt (default "supervisor")
;history_file=~/.sc_history ; use readline history if available
[include] ;包含其它配置文件
files = supervisord.d/*.ini;可以指定一个或多个以.ini结束的配置文件
子进程的配置文件
子进程的配置文件应该放在/etc/supervisord.d目录下,一般是以.ini文件为后缀的,和supervisord.conf中的[include] 匹配(也可以定义为.conf后缀名文件)
[program:pinserver];进程名
command=/usr/java/jdk1.8.0_171/bin/java -Xms64m -Xmx128m -jar /opt/pin-server/web-0.0.1-SNAPSHOT.war--spring.profiles.active=prod,ext--server.port=8080 ; 程序启动命令
autostart=true; 在supervisord启动的时候也自动启动
startsecs=10 ; 启动10秒后没有异常退出,就表示进程正常启动了,默认为1秒
autorestart=false; 程序退出后自动重启,可选值:[unexpected,true,false],默认为unexpected,表示进程意外杀死后才重启
startretries=3 ; 启动失败自动重试次数,默认是3
user=root ; 用哪个用户启动进程,默认是root
priority=999; 进程启动优先级,默认999,值小的优先启动
redirect_stderr=true ; 把stderr重定向到stdout,默认false
stdout_logfile_maxbytes=10MB ; stdout 日志文件大小,默认50MB
stdout_logfile_backups = 20 ; stdout 日志文件备份数,默认是10
; stdout 日志文件,需要注意当指定目录不存在时无法正常启动,所以需要手动创建目录(supervisord 会自动创建日志文件)
stdout_logfile=/opt/pin-server/logs/java8080.out
stderr_logfile=/opt/pin-server/logs/java8080err.out
stderr_logfile_maxbytes=10MB
stderr_logfile_backups=20
stderr_capture_maxbytes=1MB
stderr_events_enabled=false
stopasgroup=false ;默认为false,进程被杀死时,是否向这个进程组发送stop信号,包括子进程
killasgroup=false;默认为false,向进程组发送kill信号,包括子进程
管理supervisor进程的常用命令
启动supervisor,-c指定让其读取的配置文件
supervisord -c /etc/supervisord.conf
关闭supervisor
supervisorctl shutdown
设置supervisor开机自动启动
systemctl enable supervisord.service
启动supervisor进程
systemctl start supervisord.service
关闭supervisor进程
systemctl stop supervisord.service
配置文件修改后可以使用该命令加载新的配置
supervisorctl update
管理supervisor子进程的常用命令
查看子进程状态
supervisorctl status
启动子进程
supervisorctl -c /etc/supervisord.conf start pinserver
停止子进程
supervisorctl -c /etc/supervisord.conf stop pinserver
重启子进程
supervisorctl -c /etc/supervisord.conf restart pinserver
启动所有子进程
supervisorctl -c /etc/supervisord.conf start all
停止所有子进程
supervisorctl -c /etc/supervisord.conf stop all
子进程定时重启任务
crontab -e
1 0 * * * supervisorctl -c /etc/supervisord.conf restart pinserver
每天24点01分重启定时任务
crontab 文件的格式:
{minute} {hour} {day-of-month} {month} {day-of-week} {full-path-to-shell-script}
- minute: 区间为 0 – 59
- hour: 区间为0 – 23
- day-of-month: 区间为0 – 31
- month: 区间为1 – 12. 1 是1月. 12是12月.
- Day-of-week: 区间为0 – 7. 周日可以是0或7.