安装配置
安装
$ brew install supervisor
配置自启动
完成后有如下提示信息
To have launchd start supervisor now and restart at login:
brew services start supervisor # 自动启动
Or, if you don't want/need a background service you can just run:
supervisord -c /usr/local/etc/supervisord.ini
==> Summary # 安装位置
/usr/local/Cellar/supervisor/3.3.3: 541 files, 6.5MB
提示信息已经说的很清楚了：
- 不想让supervisor作为后台服务随系统启动，可以通过用指定配置文件的方式来启动：
supervisord -c /usr/local/etc/supervisord.ini
- 如果要让supervisor随系统自启动，用一下命令就可以了：
brew services start supervisor
默认的配置文件：/usr/local/etc/supervisord.ini
- 设置随系统自动启动
hylexus@hylexusPC bin $ brew services start supervisor
==> Tapping homebrew/services
Cloning into '/usr/local/Homebrew/Library/Taps/homebrew/homebrew-services'...
remote: Counting objects: 12, done.
remote: Compressing objects: 100% (8/8), done.
remote: Total 12 (delta 0), reused 7 (delta 0), pack-reused 0
Unpacking objects: 100% (12/12), done.
Tapped 0 formulae (40 files, 54.2KB)
==> Successfully started `supervisor` (label: homebrew.mxcl.supervisor)
其实在安装完成后，已经自动生成了 plist 文件模板，位置在这里： /usr/local/Cellar/supervisor/3.3.3/homebrew.mxcl.supervisor.plist 。
常用命令
supervisor提供的几个可执行文件(链接文件)：
hylexus@hylexusPC bin $ pwd
/usr/local/Cellar/supervisor/3.3.3/bin
hylexus@hylexusPC bin $ ls
echo_supervisord_conf pidproxy supervisorctl supervisord
命令帮助：
# 带上配置文件参数 不然会在进入supervisor的shell的时候提示如下错误
hylexus@hylexusPC etc $ supervisorctl
http://localhost:9001 refused connection
supervisor>
hylexus@hylexusPC etc $ supervisorctl -c /usr/local/etc/supervisord.ini
supervisor> help
default commands (type help ):
=====================================
add exit open reload restart start tail
avail fg pid remove shutdown status update
clear maintail quit reread signal stop version
supervisor>
####################
hylexus@hylexusPC etc $ supervisorctl --help
supervisorctl -- control applications run by supervisord from the cmd line.
Usage: /usr/local/bin/supervisorctl [options] [action [arguments]]
Options:
-c/--configuration FILENAME -- configuration file path (searches if not given)
-h/--help -- print usage message and exit
-i/--interactive -- start an interactive shell after executing commands
-s/--serverurl URL -- URL
- echo_supervisord_conf 可以输出配置文件模板。
hylexus@hylexusPC bin $ echo_supervisord_conf
[unix_http_server]
file=/usr/local/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)
;[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)
; ......
- 经常启停控制
supervisor> reload
Really restart the remote supervisord process y/N? y
Restarted supervisord
supervisor> start logstash
logstash: started
supervisor> stop logstash
配置示例(logstash)
配置文件的最后一行是这样的：
[include]
files = /usr/local/etc/supervisor.d/*.ini
许多软件的配置文件都是这个套路，就和 nginx 类似的，最后一行的配置是指将 files 所指定的目录里以.ini结尾的文件也包含进来作为配置文件。
这样一来，可以方便的为不同的服务配置不同的配置文件。
下面看看一个 logstash 的示例级别配置：
- 准备配置文件
hylexus@hylexusPC supervisor.d $ vim /usr/local/etc/supervisor.d/logstash.ini
写入如下内容：
[program:logstash]
directory = /Users/hylexus/app/logstash-5.2.0/bin
command = /Users/hylexus/app/logstash-5.2.0/bin/logstash -f /Users/hylexus/app/logstash-5.2.0/my-task/echo.conf -l /Users/hylexus/app/logstash-5.2.0/logs/test-logstash.log
autostart = false
startsecs = 5
autorestart = true
startretries = 3
user = hylexus
redirect_stderr = true
stdout_logfile_backups = 20
stdout_logfile=/usr/local/var/log/logstash.log
stdout_logfile_maxbytes=10MB
stderr_logfile=/usr/local/var/log/logstash-err.log
stderr_logfile_maxbytes=10MB
; environment=PYTHONPATH=$PYTHONPATH:/path/to/somewhere
echo.conf
input {
stdin { }
}
output {
stdout { }
}
- 启动logstash
hylexus@hylexusPC etc $ supervisorctl -c /usr/local/etc/supervisord.ini
supervisor>
supervisor> reload
Really restart the remote supervisord process y/N? y
Restarted supervisord
supervisor> start logstash
logstash: started
supervisor> status
logstash RUNNING pid 41344, uptime 0:01:34
- 查看logstash日志输出
hylexus@hylexusPC supervisor.d $ tail -f /usr/local/var/log/logstash.log
Sending Logstash's logs to /usr/local/var/run/log/logstash.log which is now configured via log4j2.properties
[2017-10-08T21:10:25,839][INFO ][logstash.pipeline ] Starting pipeline {"id"=>"main", "pipeline.workers"=>4, "pipeline.batch.size"=>125, "pipeline.batch.delay"=>5, "pipeline.max_inflight"=>500}
[2017-10-08T21:10:25,855][INFO ][logstash.pipeline ] Pipeline main started
[2017-10-08T21:10:25,921][INFO ][logstash.agent ] Successfully started Logstash API endpoint {:port=>9600}
- 停止logstash
supervisor> stop logstash
logstash: stopped
supervisor> status
logstash STOPPED Oct 08 09:11 PM