linux supervisor 安装使用
目录
linux supervisor 安装使用
supervisor与systemd不同，systemd的作用是将服务管理起来，方便开机自启动，或者启动服务。
而supervisor更趋向于维持进程的存活，类似docker里面的 --restart=always
安装
// yum 安装，如果需要迁移到其他，可以加个--downloadonly，将rpm包拷贝到目标服务器安装
yum -y install supervisor
// 上面的rpm前提是目标服务器和你本地服务器系统版本一样，如果版本不一致，可以下载源码包直接编译安装
// 需要注意的是，源码安装需要python环境，需要确认本地python版本和supervisor的版本
配置文件
// 提前创建配置文件路径
mkdir -p /etc/supervisor/conf.d/
// 安装好后，用本地工具生成配置文件
echo_supervisord_conf > /etc/supervisord.conf
// vim 配置文件
# 原配置
[unix_http_server]
file=/tmp/supervisor.sock ; the path to the socket file
;chmod=0700 ; socket file mode (default 0700)
;chown=nobody:nogroup ; socket file uid:gid owner
;username=user ; default is no username (open server)
;password=123 ; default is no password (open server)
# 修改后的配置，原先的/tmp目录下的内容容易被系统删除，导致启动失败
[unix_http_server]
file=/var/run/supervisor.sock ; the path to the socket file
;chmod=0700 ; socket file mode (default 0700)
;chown=nobody:nogroup ; socket file uid:gid owner
;username=user ; default is no username (open server)
;password=123 ; default is no password (open server)
------------------------------------------------------------------------------
# 原配置
[supervisord]
logfile=/tmp/supervisord.log ; main log file; default $CWD/supervisord.log
logfile_maxbytes=50MB ; max main logfile bytes b4 rotation; default 50MB
logfile_backups=10 ; # of main logfile backups; 0 means none, default 10
loglevel=info ; log level; default info; others: debug,warn,trace
pidfile=/tmp/supervisord.pid ; supervisord pidfile; default supervisord.pid
nodaemon=false ; start in foreground if true; default false
silent=false ; no logs to stdout if true; default false
minfds=1024 ; min. avail startup file descriptors; default 1024
minprocs=200 ; min. avail process descriptors;default 200
# 修改后的配置，修改了服务的日志文件目录，修改了supervisord.pid的存放位置
[supervisord]
logfile=/etc/supervisor/log/supervisord.log ; 避免被系统删除
logfile_maxbytes=50MB ; max main logfile bytes b4 rotation; default 50MB
logfile_backups=10 ; # of main logfile backups; 0 means none, default 10
loglevel=info ; log level; default info; others: debug,warn,trace
pidfile=/var/run/supervisord.pid ; 避免被系统删除
nodaemon=false ; start in foreground if true; default false
silent=false ; no logs to stdout if true; default false
minfds=1024 ; min. avail startup file descriptors; default 1024
minprocs=200 ; min. avail process descriptors;default 200
------------------------------------------------------------------------------
# 原配置
[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL for a unix socket
;serverurl=http://127.0.0.1:9001 ; use an http:// url to specify an inet socket
;username=chris ; should be same as in [*_http_server] if set
;password=123 ; should be same as in [*_http_server] if set
;prompt=mysupervisor ; cmd line prompt (default "supervisor")
;history_file=~/.sc_history ; use readline history if available
# 修改后的配置，修改supervisor.sock的存放位置，避免被系统删除
[supervisorctl]
serverurl=unix:///var/run/supervisor.sock
;serverurl=http://127.0.0.1:9001 ; use an http:// url to specify an inet socket
;username=chris ; should be same as in [*_http_server] if set
;password=123 ; should be same as in [*_http_server] if set
;prompt=mysupervisor ; cmd line prompt (default "supervisor")
;history_file=~/.sc_history ; use readline history if available
------------------------------------------------------------------------------
# 原配置
;[include]
;files = relative/directory/*.ini
# 修改后的配置，设置子任务的配置文件目录
[include]
files = /etc/supervisor/conf.d/*.ini
其他参数详情
[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，如果设成0，表示不限制大小
logfile_backups=10 ;日志文件保留备份数量默认10，设为0表示不备份
loglevel=info ;日志级别，默认info，其它: debug,warn,trace
pidfile=/tmp/supervisord.pid ;pid 文件
nodaemon=false ;是否在前台启动，默认是false，即以 daemon 的方式启动
minfds=1024 ;可以打开的文件描述符的最小值，默认 1024
minprocs=200 ;可以打开的进程数的最小值，默认 200
[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ;通过UNIX socket连接supervisord，路径与unix_http_server部分的file一致
;serverurl=http://127.0.0.1:9001 ; 通过HTTP的方式连接supervisord
; [program:xx]是被管理的进程配置参数，xx是进程的名称
[program:xx]
command=/opt/apache-tomcat-8.0.35/bin/catalina.sh run ; 程序启动命令
autostart=true ; 在supervisord启动的时候也自动启动
startsecs=10 ; 启动10秒后没有异常退出，就表示进程正常启动了，默认为1秒
autorestart=true ; 程序退出后自动重启,可选值：[unexpected,true,false]，默认为unexpected，表示进程意外杀死后才重启
startretries=3 ; 启动失败自动重试次数，默认是3
user=tomcat ; 用哪个用户启动进程，默认是root
priority=999 ; 进程启动优先级，默认999，值小的优先启动
redirect_stderr=true ; 把stderr重定向到stdout，默认false
stdout_logfile_maxbytes=20MB ; stdout 日志文件大小，默认50MB
stdout_logfile_backups = 20 ; stdout 日志文件备份数，默认是10
; stdout 日志文件，需要注意当指定目录不存在时无法正常启动，所以需要手动创建目录（supervisord 会自动创建日志文件）
stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.out
stopasgroup=false ;默认为false,进程被杀死时，是否向这个进程组发送stop信号，包括子进程
killasgroup=false ;默认为false，向进程组发送kill信号，包括子进程
;包含其它配置文件
[include]
files =/etc/supervisord.d/*.ini ;可以指定一个或多个以.ini结束的配置文件
启动supervisor
//supervisor 有两个命令，supervisord 用于首次启动，supervisorctl 用于管理进程的启动、停止、重新加载
supervisord -c /etc/supervisord.conf
其他命令
supervisord -c /etc/supervisord.conf : 启动supervisor
supervisorctl -c /etc/supervisord.conf reload :修改完配置文件后重新启动supervisor
supervisorctl -c /etc/supervisord.conf status :查看supervisor监管的进程状态
supervisorctl -c /etc/supervisord.conf start all | 进程名 ：启动全部或某进程
supervisorctl -c /etc/supervisord.conf stop all | 进程名 ：停止全部或某进程
supervisorctl -c /etc/supervisord.conf stop all：停止进程，注：start、restart、stop都不会载入最新的配置文件。
supervisorctl -c /etc/supervisord.conf update：根据最新的配置文件，启动新配置或有改动的进程，配置没有改动的进程不会受影响而重启
添加被守护的进程
java案例
touch /etc/supervisord.d/java123.ini
// 编辑 vim java123.ini
;名字可以自定义java123
[program:java123]
environment=JAVA_HOME=/home/download/jdk1.8.0_191/bin
command= /home/download/jdk1.8.0_191/bin/java -jar -Xms128M -Xmx256M -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=128m admin.jar
;运行前切换到工作目录
directory = /data
numprocs = 1
process_name = %(program_name)s
;*自动重启
autorestart = true
;启动延时执行,默认1秒
startsecs = 60
;启动尝试次数,默认3次
startretries=3
stdout_logfile_maxbytes = 50MB
stdout_logfile_backups = 20
;运行和错误日志输出位置
stdout_logfile = /data/notebooks/log/ruoyi-admin.log
stderr_logfile = /data/notebooks/log/ruoyi-admin_err.log
// 加完后，重新加载配置
supervisorctl -c /etc/supervisord.conf reload
// 执行jps查看java进程
jps -l
python案例
#cat /data/python3.conf
[program:python3]
command= python3 -u manager.py
#python程序平时启动命令：nohup python3 -u manager.py > log/stock.log 2>&1 &
#python程序启动配置：command= python3 -u manager.py
directory = /data #manager.py文件目录
numprocs = 1
process_name = %(program_name)s
;*自动重启
autorestart = true
;启动延时执行,默认1秒
startsecs = 60
;启动尝试次数,默认3次
startretries=3
stdout_logfile_maxbytes = 50MB
stdout_logfile_backups = 20
stdout_logfile = /data/notebooks/log/python3.log
stderr_logfile = /data/notebooks/log/python3_err.log
vue3+ts案例
#cat /data/vue3ts.conf
[program:vue3ts]
command= npm run dev
#vue程序平时启动命令：nohup npm run dev > log/stock-web.log 2>&1 &
#vue启动程序配置：command= npm run dev
directory = /data #项目根目录
numprocs = 1
process_name = %(program_name)s
;*自动重启
autorestart = true
;启动延时执行,默认1秒
startsecs = 60
;启动尝试次数,默认3次
startretries=3
stdout_logfile_maxbytes = 50MB
stdout_logfile_backups = 20
stdout_logfile = /data/notebooks/log/vue3ts.log
stderr_logfile = /data/notebooks/log/vue3ts_err.log
redis案例
#cat /data/redis.conf
#项目名
[program:redis]
#程序启动命令
command=/usr/bin/redis-server /www/server/redis/redis.conf
#supervisor启动的时候是否随着同时启动，默认True
autostart=true
#程序退出后自动重启，可选值：[unexpected,true,false]。
#默认为unexpected，表示进程意外杀死后才重启。
#false无论什么情况下都不会被重新启动。
#true将会无条件自动重启。
autorestart=true
#启动10秒钟之后，则我们认为启动成功了。默认值为1
startsecs=10
#启动失败自动重试次数，默认是3
startretries=5
#用哪个用户启动进程，默认是root
user = root
#日志输出
stdout_logfile=/tmp/redis_out.log
#程序错误信息输出到该文件
stderr_logfile=/tmp/redis_err.log
tomcat案例
[program:testframework]
command=/usr/local/testFramework-tomcat/bin/catalina.sh run
user=root
#autostart=true
#autorestart=true
redirect_stderr=true
startsecs=0
stopsignal=TERM
stopasgroup=true
stdout_logfile_maxbytes=20MB
stdout_logfile_backups=20
stdout_logfile=/root/data/logs/testframework_stdout.log
守护进程其他参数详情
command：启动程序使用的命令，可以是绝对路径或者相对路径
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。
stderr_logfile：把进程的错误日志输出一个文件中，除非redirect_stderr参数被设置为true
stderr_logfile_maxbytes：错误log文件达到多少后自动进行轮转，单位是KB、MB、GB。如果设置为0则表示不限制日志文件大小
stderr_logfile_backups：错误日志轮转备份的数量，默认是10，如果设置为0，则不备份
user：如果supervisord以root运行，则会使用这个设置用户启动子程序
stdout_logfile：把进程的标准输出写入文件中，如果stdout_logfile没有设置或者设置为AUTO，则supervisor会自动选择一个文件位置。
process_name：一个python字符串表达式，用来表示supervisor进程启动的这个的名称，默认值是%(program_name)s
numprocs：Supervisor启动这个程序的多个实例，如果numprocs>1，则process_name的表达式必须包含%(process_num)s，默认是1
numprocs_start：一个int偏移值，当启动实例的时候用来计算numprocs的值
stopwaitsecs：在操作系统给supervisord发送SIGCHILD信号时等待的时间
stopasgroup：如果设置为true，则会使supervisor发送停止信号到整个进程组
killasgroup：如果设置为true，则在给程序发送SIGKILL信号的时候，会发送到整个进程组，它的子进程也会受到影响。
redirect_stderr：如果设置为true，进程则会把标准错误输出到supervisord后台的标准输出文件描述符。
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_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
