supervisor是一个很好的守护程序管理工具,配置方面自动启动,日志输出,自动切割日志等等一系列强大功能,下面是在CentOS下安装使用supervisor的记录。
安装
# epel源
yum install epel-release
# 安装supervisor
yum install -y supervisor
# 开机自启动
systemctl enable supervisord
# 启动supervisord服务
systemctl start supervisord
配置路径
# 主配置文件
/etc/supervisord.conf
# 运行程序配置文件夹
/etc/supervisord.d/
操作命令
supervisorctl status
# 正在允许的进程状态
supervisorctl add <name>
# 使进程/组配置的任何更新生效
supervisorctl remove <name>
# 从活动进程/组中删除
supervisorctl update
# 重载配置对活动进程进行必要添加或者删除,受影响的进程会被重启
supervisorctl clear all
supervisorctl clear <name>
supervisorctl clear <name>
# 清除日志文件,可指定组,或组内进程
supervisorctl pid
# 获取supervisord的PID
supervisorctl pid <name>
supervisorctl pid all
# 获取进程PID
supervisorctl reload
# 重启守护程序 supervisord
supervisorctl start
supervisorctl stop
supervisorctl restart
# 开始,停止,重启(不会重新读取配置文件)
功能很多,一般添加好 ini
配置文件后直接使用 update
就可以了。
supervisorctl管理进程
name
指配置文件中的 program
;
supervisorctl 的命令
add <name>
激活配置更新或者新配置
remove <name>
从已激活的配置中去除某个项目或者组
update (all)
重新加载配置并添加或者去除项目(如有必要),会重启受影响的项目
update <gname>
更新某个组,会重启受影响的项目
clear <name>
清理某进程的log文件
clear <name> <name>
清理多个
clear all
清理全部
fg <process>
前台模式运行某进程,Ctrl + C退出这个模式
pid
获取supervisord的PID
pid <name>
获取某个子进程的PID
pid all
获取全部子进程PID
reload
重启监控
reread
重新加载守护进程的配置文件,不重启
restart <name>
Restart a process Note: restart does not reread config files. For that, see reread and update.
restart <gname>:*
Restart all processes in a group Note: restart does not reread config files. For that, see reread and update.
restart <name> <name>
Restart multiple processes or groups Note: restart does not reread config files. For that, see reread and update.
restart all
Restart all processes Note: restart does not reread config files. For that, see reread and update.
start <name>
Start a process
start <gname>:*
Start all processes in a group
start <name> <name>
Start multiple processes or groups
start all
Start all processes
status
Get all process status info.
status <name>
Get status on a single process by name.
status <name> <name>
Get status on multiple named processes.
stop <name>
Stop a process
stop <gname>:*
Stop all processes in a group
stop <name> <name>
Stop multiple processes or groups
stop all
Stop all processes
tail [-f] <name> [stdout|stderr] (default stdout)
查看某个项目的日志,默认标准输出日志
使用测试
写一个测试脚本 test.php
,记录启动次数和运行。
<?php
try {
$a = file_get_contents('./times.json');
} catch (Exception $e) {
$a = 0;
}
$a ++;
file_put_contents('./times.json', $a);
echo date('Y-m-d H:i:s') . " 这是第{$a}次启动!!!!" . PHP_EOL;
$i = 1;
while (1) {
echo date('Y-m-d H:i:s') . " 第{$i}次输出" . PHP_EOL;
$i ++;
sleep(5);
}
在程序配置文件夹 /etc/supervisord.d
中添加 test.ini
:
[program:test]
command=php /home/wwwroot/test.cc/test.php
user=www
autostart=true
autorestart=true
numprocs=2
redirect_stderr=true
stdout_logfile=/home/wwwroot/test.cc/log/out.log
上面只是一些必要的基本配置,更详细的配置参考:
;[program:theprogramname]
;command=/bin/cat ; the program (relative uses PATH, can take args)
;process_name=%(program_name)s ; process_name expr (default %(program_name)s)
;numprocs=1 ; number of processes copies to start (def 1)
;directory=/tmp ; directory to cwd to before exec (def no cwd)
;umask=022 ; umask for process (default None)
;priority=999 ; the relative start priority (default 999)
;autostart=true ; start at supervisord start (default: true)
;autorestart=true ; retstart at unexpected quit (default: true)
;startsecs=10 ; number of secs prog must stay running (def. 1)
;startretries=3 ; max # of serial start failures (default 3)
;exitcodes=0,2 ; 'expected' exit codes for process (default 0,2)
;stopsignal=QUIT ; signal used to kill process (default TERM)
;stopwaitsecs=10 ; max num secs to wait b4 SIGKILL (default 10)
;user=chrism ; setuid to this UNIX account to run the program
;redirect_stderr=true ; redirect proc stderr to stdout (default false)
;stdout_logfile=/a/path ; stdout log path, NONE for none; default AUTO
;stdout_logfile_maxbytes=1MB ; max # logfile bytes b4 rotation (default 50MB)
;stdout_logfile_backups=10 ; # of stdout logfile backups (default 10)
;stdout_capture_maxbytes=1MB ; number of bytes in 'capturemode' (default 0)
;stdout_events_enabled=false ; emit events on stdout writes (default false)
;stderr_logfile=/a/path ; stderr log path, NONE for none; default AUTO
;stderr_logfile_maxbytes=1MB ; max # logfile bytes b4 rotation (default 50MB)
;stderr_logfile_backups=10 ; # of stderr logfile backups (default 10)
;stderr_capture_maxbytes=1MB ; number of bytes in 'capturemode' (default 0)
;stderr_events_enabled=false ; emit events on stderr writes (default false)
;environment=A=1,B=2 ; process environment additions (def no adds)
;serverurl=AUTO ; override serverurl computation (childutils)
这里简单的配置了一些日志输出,以及多线程和线程名称自定义,要使刚添加的test.ini生效只需要运行:
[root@localhost test.cc]# supervisorctl update
test: added process group
这里我们启动了两个进程来跑程序,那我们看看进程状态:
[root@localhost test.cc]# supervisorctl status
test:00 RUNNING pid 14206, uptime 0:00:16
test:01 RUNNING pid 14207, uptime 0:00:16
这里显示的进程名称是在配置文件里自定义的,看看程序的输出文件 stdout_logfile
中,程序正在把输出写入到配置中指定的文件。
使用ps查看系统中进程:
[root@localhost test.cc]# ps -aux | grep test.php
www 14206 0.0 0.6 271840 12172 ? S 18:29 0:00 php /home/wwwroot/test.cc/test.php
www 14207 0.0 0.6 271840 12168 ? S 18:29 0:00 php /home/wwwroot/test.cc/test.php
root 14232 0.0 0.0 112712 992 pts/0 S+ 18:30 0:00 grep --color=auto test.php
可以重启服务器,或者 kill -9 PID
杀死进程,会发现 supervisor
会第一时间重启程序,达到了守护进程的目的。
关于配置方面仔细看看上面的参考,基本上涵盖了需要的功能,多进程的运行,切割日志的大小,保留数量等等,功能强大而且使用。
更多高级功能请参考 supervisor
官网使用手册:传送门