supervisor是一个用 Python 写的进程管理工具,可以很方便的用来启动、重启、关闭进程(守护进程)。可以用他来管理自己的“服务程序”。
安装
首先安装Python,Mac系统好像自带。
执行 sudo pip install supervisor
安装
安装pip
下载get-pip.py,然后执行。具体请查看文档
$ wget https://raw.githubusercontent.com/pypa/pip/master/contrib/get-pip.py
...
$ sudo python get-pip.py
配置
使用默认配置项
$ sudo echo_supervisord_conf > /etc/supervisord.conf
$ sudo vim /etc/supervisord.conf
其他可以暂时忽略,修改最底下一行
; 包含其他的配置文件
[include]
files = /etc/supervisor/*.conf ; 可以随意指定,目录不存在请先建立。配置文件可以是 *.conf 或 *.ini
测试一下
supervisord -c /etc/supervisord.conf
ps aux | grep supervisord
配置“服务”
这里我用“IDEA License Server”做示例
sudo vim /etc/supervisor/idea.conf
文件内容
[program:idea] ; 是应用程序的唯一标识,不能重复
directory = /data/jidea-server ; 程序的启动目录
command = /data/jidea-server/IntelliJIDEALicenseServer_darwin_amd64 ; 启动命令
autostart = true ; 在 supervisord 启动的时候也自动启动
startsecs = 5 ; 启动 5 秒后没有异常退出,就当作已经正常启动了
autorestart = true ; 程序异常退出后自动重启
startretries = 3 ; 启动失败自动重试次数,默认是 3
redirect_stderr = true ; 把 stderr 重定向到 stdout,默认 false
stdout_logfile_maxbytes = 20MB
stdout_logfile_backups = 20
stdout_logfile = /var/log/supervusor/jidea-server.log ; stdout 日志文件,注意:要确保目录已经建立并且可以访问(写权限)
使用命令supervisorctl -c /etc/supervisord.conf
加装并启动。如果一切正常可以使用命令supervisorctl status
查看状态。例如:
$ supervisorctl status
idea RUNNING pid 1177, uptime 0:32:00
$
以上输出表示一起正常,如果有错误,请“具体情况具体分析”本文档暂不做相关讨论。
使用 launchctl 来启动 supervisor 自身
launchctl
是Mac自带的工具,具体使用方法请看官方文档或者问度娘。
这里我在 /Library/LaunchAgents
目录下, 创建一个 supervisord.plist
文件, 命令:sudo vim /Library/LaunchDaemons/supervisord.plist
,内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key>
<dict>
<key>SuccessfulExit</key>
<false/>
</dict>
<key>Label</key>
<string>supervisord</string>
<key>ProgramArguments</key>
<array>
<string>/usr/local/bin/supervisord</string>
<string>-n</string>
<string>-c</string>
<string>/etc/supervisord.conf</string>
</array>
<key>RunAtLoad</key>
<true/>
</dict>
</plist>
注意:检查文件的权限
$ ls -lsa /Library/LaunchDaemons
total 24
0 drwxr-xr-x 5 root wheel 170 11 22 09:44 .
0 drwxr-xr-x+ 67 root wheel 2278 11 16 14:41 ..
8 -rw-r--r-- 1 root wheel 590 11 16 17:52 supervisord.plist
supervisord.plist
必须是属于root
用户的。不是的话修改:sudo chown root:wheel /Library/LaunchDaemons/supervisord.plist
。最后启动他
sudo launchctl load /Library/LaunchDaemons/supervisord.plist
注意,在启动前先检查一下supervisord
时不时已经在运行了,如果已经运行请先kill
掉。
注意: 必须在这个目录(/Library/LaunchDaemons
)下才会使用root
启动。
$ ps aux | grep supervisord
user 1167 0.0 0.2 4304600 15744 ?? Ss 9:52上午 0:00.51 /usr/bin/python /usr/local/bin/supervisord -n -c /etc/supervisord.conf
$ kill -4 1167