< >
Home » Ubuntu系统入门教程 » Ubuntu系统入门教程-整合supervisor

Ubuntu系统入门教程-整合supervisor

Ubuntu系统入门教程-整合supervisor

说明:

  • 介绍如何整合supervisor实现程序自动管理

Supervisor

  • Supervisor 是用Python开发的一套通用的进程管理程序,能将一个普通的命令行进程变为后台daemon,并监控进程状态,异常退出时能自动重启。

步骤: 

  • 安装
sudo apt install supervisor
  • supervisor主配置文件
/etc/supervisor/supervisord.conf
  • supervisor子配置文件
  • 需要的监控的进程,主要放.conf后缀的文件里
/etc/supervisor/conf.d/*.conf
  • 在/etc/supervisor/conf.d/目录下,新建.conf内容说明
;*为必须填写项
;*[program:应用名称]
[program:cat]

;*命令路径,如果使用python启动的程序应该为 python /home/test.py, 
;不建议放入/home/user/, 对于非user用户一般情况下是不能访问
command=/bin/cat

;当numprocs为1时,process_name=%(program_name)s;
当numprocs>=2时,%(program_name)s_%(process_num)02d
process_name=%(program_name)s

;进程数量
numprocs=1

;执行目录,若有/home/supervisor_test/test1.py
;将directory设置成/home/supervisor_test
;则command只需设置成python test1.py
;否则command必须设置成绝对执行目录
directory=/tmp

;掩码:--- -w- -w-, 转换后rwx r-x w-x
umask=022

;优先级,值越高,最后启动,最先被关闭,默认值999
priority=999

;如果是true,当supervisor启动时,程序将会自动启动
autostart=true

;*自动重启
autorestart=true

;启动延时执行,默认1秒
startsecs=10

;启动尝试次数,默认3次
startretries=3

;当退出码是0,2时,执行重启,默认值0,2
exitcodes=0,2

;停止信号,默认TERM
;中断:INT(类似于Ctrl+C)(kill -INT pid),退出后会将写文件或日志(推荐)
;终止:TERM(kill -TERM pid)
;挂起:HUP(kill -HUP pid),注意与Ctrl+Z/kill -stop pid不同
;从容停止:QUIT(kill -QUIT pid)
;KILL, USR1, USR2其他见命令(kill -l),说明1
stopsignal=TERM

stopwaitsecs=10

;*以root用户执行
user=root

;重定向
redirect_stderr=false

stdout_logfile=/a/path
stdout_logfile_maxbytes=1MB
stdout_logfile_backups=10
stdout_capture_maxbytes=1MB
stderr_logfile=/a/path
stderr_logfile_maxbytes=1MB
stderr_logfile_backups=10
stderr_capture_maxbytes=1MB

;环境变量设置
environment=A="1",B="2"

serverurl=AUTO
  • 增加配置后,重启动
systemctl reload supervisor
  • 相关命令
注册服务 systemctl enable supervisor
卸载服务 systemctl disable supervisor
查看服务:service  --status-all 
开启服务:systemctl start supervisor 
停止服务:systemctl stop supervisor
查看状态:systemctl status supervisor
重新加载:systemctl reload supervisor
重启服务:systemctl restart supervisor
  • 启动
#默认启动,三种方式
supervisord 
/etc/init.d/supervisor start
systemctl start supervisor

#或指定参数文件启动
#supervisord -c /etc/supervisor/supervisord.conf
  • 查看版本
supervisord -v
  • 查看状态
supervisorctl  status
  • supervisord是主进程,supervisorctl是给守护进程发送命令的客户端工具

例子:

  • 新建脚本 vim /tmp/echo_time.sh, 内容如下: 
#/bin/bash

while true; do
    echo `date +%Y-%m-%d,%H:%m:%s`
    sleep 2
done

 - 在/etc/supervisor/conf.d/新增子进程配置文件
 - 创建文件vim /etc/supervisor/conf.d/echo_time.conf,内容如下: 

[program:echo_time]
command=sh /tmp/echo_time.sh
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. 10)
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 before SIGKILL (default 10)
user=root                 ; setuid to this UNIX account to run the program
log_stdout=true
log_stderr=true             ; if true, log program stderr (def false)
logfile=/tmp/echo_time.log
logfile_maxbytes=1MB        ; max # logfile bytes b4 rotation (default 50MB)
logfile_backups=10          ; # of logfile backups (default 10)
stdout_logfile_maxbytes=20MB  ; stdout 日志文件大小,默认 50MB
stdout_logfile_backups=20     ; stdout 日志文件备份数
stdout_logfile=/tmp/echo_time.stdout.log
  • 重新读取配置、更新子进程组
$ sudo supervisorctl reread
echo_time: available
  • 执行update后输出
$ sudo supervisorctl update
echo_time: added process group
  • 查看日志
$ tail -f /tmp/echo_time.stdout.log
2022-03-23,08:03:1647995874
2022-03-23,08:03:1647995876
2022-03-23,08:03:1647995878
2022-03-23,08:03:1647995880
2022-03-23,08:03:1647995882
  • 查看进程情况
$ sudo supervisorctl  status
echo_time                        RUNNING   pid 25203, uptime 0:01:23

web界面操作:

  • 需要开启supervisord.conf注释掉的这4行
[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)
  • 端口默认是监听127.0.0.1:9001
port=*:9001 
  • 重启主进程supervisord
$ supervisorctl reload
  • 访问网址,http://localhost:9001,输入帐号user和密码123, 即可访问

进程管理

  • 启动supervisord管理的所有进程
supervisorctl start all
  • 停止supervisord管理的所有进程
supervisorctl stop all
  • 启动supervisord管理的某一个特定进程
supervisorctl start program-name // program-name为[program:xx]中的xx
  • 停止supervisord管理的某一个特定进程
supervisorctl stop program-name  // program-name为[program:xx]中的xx
  • 重启所有进程
supervisorctl restart all // 重启所有
  • 重启某个进程
supervisorctl reatart program-name // 重启某一进程,program-name为[program:xx]中的xx

参考:

纠错,疑问,交流: 请进入讨论区点击加入Q群

获取最新文章: 扫一扫右上角的二维码加入“创客智造”公众号


标签: ubuntu系统入门教程