安装配置

安装

$ 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 <topic>):
=====================================
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