go语音版Supervisor
问题
随着微服务架构与Docker容器化的普及,企业应用由大而全的集中机构,向微服务架构转变,随之产生的是主机上需要部署和管理的越来越多的应用程序。对于微服务进程的管理和调度需求愈来愈迫切。
解决方案
Supervisor 是一个用 Python 写的进程管理工具,可以很方便的用来在 UNIX-like 系统(不支持 Windows)下启动、重启、关闭进程。它不仅仅支持Python 进程,任何进程均可以,并且支持进程异常中断后的自动重启。
新的问题
python版本的supervisor运行需要预安装python环境,部署不便。对于运行有现有业务系统的主机,风险较大。
解决办法
选用golang版本的supervisor,其功能与用法和配置与python版本完全一致。
安装说明
本人推荐go版本,本文以go版本为例。两种方法:1.下载源码,编译后拷贝到目标服务器运行即可。2.直接下载他人编译后的二进制文件
go版本supervisor下载地址
http://soft.liuyanli.win/soft/tools/supervisord-go1.13-linux-386
源码下载地址
https://github.com/ochinchina/supervisord
编译环境:win10,64位,LiteIDE-X36.2,go1.13.5.windows-amd64,
编译环境变量:GOARCH=386,GOOS=linux
编译命令: go build -o supervisord-go1.13-linux-386
安装方法
直接将二进制文件拷贝到服务器上即可,webgui为源码包中的默认http页面
[root@db1k4 supervisor]# pwd
/home/soft/supervisor
[root@db1k4 supervisor]# ll
总用量 10856
-rw-r--r-- 1 root root 343493 3月 29 20:19 AUTO
-rw-r--r-- 1 root root 160 3月 29 18:56 supervisor.conf -----配置文件
-rwxr-xr-x 1 root root 10758869 3月 29 18:28 supervisord -----二进制程序
drwxr-xr-x 4 root root 4096 3月 29 18:19 webgui -----http页面
[root@db1k4 supervisor]# ./supervisord version
v0.6.8
[root@db1k4 supervisor]# ./supervisord -h
Usage:
supervisord [OPTIONS] <ctl | init | version>
Application Options:
-c, --configuration= the configuration file
-d, --daemon run as daemon
--env-file= the environment file
Help Options:
-h, --help Show this help message
Available commands:
ctl Control a running daemon
init initialize a template
version show the version of supervisor
#生成初始化配置文件模板
[root@db1k4 supervisor]# ./supervisord init --output=./supervisor.conf
#修改后的配置
[root@db1k4 supervisor]# cat supervisor.conf
[program:glkz-zdtp]
command = /home/soft/glkz/glkz-zdtp args
directory=/home/soft/glkz
redirect_stderr=true
stdout_logfile=AUTO
[inet_http_server]
port=:9001
#启动
[root@db1k4 supervisor]# ./supervisord -c supervisor.conf -d
启动后,控制台地址为:http://ryc.liuyanli.win:9001/
- 停止supervisord进程
将停止其守护的全部进程
[root@db1k4 supervisor]# ./supervisord ctl -s http://localhost:9001 -v shutdown
Shut Down
- 管控命令
- check if option -s or --serverurl is present, use this url
- check if -c option is present and the "serverurl" in "supervisorctl" section is present, use the "serverurl" in section "supervisorctl"
- return http://localhost:9001
架构说明
Supervisor 是一个 C/S 模型的程序,supervisord 是 server 端,supervisorctl 是 client 端
配置说明
配置文件遵循ini文件格式,注释以;开头。
- supervisord
该段为supervisord自身的进程配置
[supervisord]
;directory=/tmp ;supervisord进程的工作目录
logfile=/tmp/supervisord.log ;日志文件,默认是当前目录下的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
;umask=022 ;进程创建文件的掩码,默认为022。
;user=chrism ;以root启动supervisord后,此用户对supervisord可以进行管理
;nocleanup=false ;当为false时每次supervisord启动时自动清理子进程日志
;childlogdir=/tmp ;子进程日志路径为AUTO时的子进程日志存放路径
;environment=KEY="value" ;设置环境变量,可以传递到子进程
- inet_http_server
该段用于启动一个http server,可以从Web页面中管理服务。web页面默认位于supervisord的同级目录下的webgui目录。如果缺少此段,则不启动httpserver。
[inet_http_server] ;HTTP服务器,提供web管理界面
port=127.0.0.1:9001 ;Web管理后台运行的IP和端口,如果开放到公网,需要注意安全性
;username=user ;登录管理后台的用户名
;password=123 ;登录管理后台的密码
- program:进程名称
每个段一个受管进程,可以配置多个
[program:test]
command = /your/prog cmd_args ;子程序启动命令行
directory=/home/soft/glkz ;程序工作目录
depends_on = prog_1, prog_1 ;此程序依赖的程序,被依赖程序优先启动
restart_when_binary_changed=true;程序被修改后是否自动重启
restart_directory_monitor=/a/b ;
restart_file_pattern=restart.* ;restart_directory_monitor目录下此模式的文件被修改则重启程序
;user=user:group ;程序启动用户,格式user[:group]
;priority=999 ;启动优先级,数字小的,最先启动,关闭的时候最后关闭
;autostart=true ;是否自动启动
;autorestart=unexpected ;挂掉自动重启策略:false不自动重启,true无条件自动重启,unexpected退出码不包含在exitcodes里面时才重启
;exitcodes=0,2 ;和autorestart=unexpected对应
;startsecs=1 ;子进程启动x秒后如果进程状态是running则认为启动成功
;startretries=3 ;连续重启失败超过x次后把进程的状态置为FAIL
;stopsignal=TERM ;停止信号,当用此信号kill进程时,退出码会被认为是expected
;stopwaitsecs=10 ;向子进程发送stopsignal信号后等待终止的超时时间,超时后发送强制kill的信号
;stopasgroup=false ;停止程序时是否同时向其所有子进程发送stopstopsignal信号
;killasgroup=false ;同上,不过发送的是kill信号
;redirect_stderr=true ;将stderr的日志写入stdout日志文件中
;stdout_logfile=AUTO ;stdout的日志路径;none禁写日志,AUTO自动生成日志文件
;stdout_logfile_maxbytes=1MB ; 日志文件最大大小,和[supervisord]中定义的一样。默认为50
;stdout_logfile_backups=10 ; 和[supervisord]定义的一样。默认10
;stderr_logfile=AUTO ;同stdout_logfile
;stderr_logfile_maxbytes=1MB
;stderr_logfile_backups=10
;environment=A="1",B="2" ; 这个是该子进程的环境变量,和别的子进程是不共享的
;serverurl=AUTO ;
- program-default
受管控程序默认配置项段,此段的配置项被[program:*]段继承
[program-default]
restart_when_binary_changed=true;程序被修改后是否自动重启
priority=999 ;启动优先级,数字小的,最先启动,关闭的时候最后关闭
autostart=true ;是否自动启动
autorestart=true
redirect_stderr=true ;将stderr的日志写入stdout日志文件中
stdout_logfile=AUTO ;stdout的日志路径;none禁写日志,AUTO自动生成日志文件
stdout_logfile_maxbytes=1MB ; 日志文件最大大小,和[supervisord]中定义的一样。默认为50
stdout_logfile_backups=2 ; 和[supervisord]定义的一样。默认10
stderr_logfile=AUTO