以前一直是用 systemd 设置开机启动的服务,因为它不需要装额外的软件,方便。
但是最近遇到个问题,就是我还需要在 OS X 上设置 Jenkins Agent 的开机自启,为此专门学习了下 launchctl 的使用,最后还是功亏一篑,败在了环境变量设置这一步——不知道为啥,我在 /Library/LaunchDaemons/io.jenkinsagent.plist
里设置的 EnvironmentVariables
字段无法生效,搞了半天没找到问题。
今天才突然想起,为何不用 supervisord 呢?!关键这个还跨平台,一份配置稍微改改就可以同时用在 MacOS 和 Linux 上。
一、MacOS X 安装 supervisord
显然我不希望自己再写个 LaunchDaemons 的 plist 文件来把 supervisord 弄成开机自启。好在 homebrew 有提供傻瓜式方案,安装方式如下:
brew services # homebrew 的 service 让我们脱离手工编写 plist 的“低级趣味”。
brew install supervisor # 安装 supervisord
brew services start supervisor # 借助 service 使 supervisor 开机启动
homebrew services 的详细使用方法可见 github- homebrew service
如需加速安装,可参考 homebrew 清华镜像源使用说明
安装启动后,可查看 supersivor 的配置文件 /usr/local/etc/supervisord.ini
,如需添加自启动程序,可将配置文件添加到 /usr/local/etc/supervisor.d/
中,该文件夹中的配置会被主配置文件 include.
详细的说明见后。
使用 supervisord
编写配置文件
注意:属性名称错误,不会给出任何提示!!!所以无法运行时,请仔细检查配置中的属性是否有拼写错误!
以 Jenkins-Agent 为例,编写 /usr/local/etc/supervisor.d/jenkins-agent.ini
,内容如下:
[program:jenkins-agent]
command=/bin/bash /Users/jenkins/jenkins_home/connect.sh ; 从 jenkins web 页面复制的连接命令
autostart=true
startsecs=5 ; 启动 5 秒后没有异常退出,就当作已经正常启动了
autorestart=true ; 程序异常退出后自动重启
startretries=3 ; 启动失败自动重试次数,默认是 3
stopasgroup=true
redirect_stderr=true ; 将 stderr 重定向到 stdout
stdout_logfile=/Users/jenkins/jenkins_home/jenkins-agent.log ; 日志输入位置
stdout_logfile_maxbytes=1MB
environment=PATH="/Users/jenkins/Softwares/flutter/bin:/Users/jenkins/Softwares/jdk-11/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
启用配置
通过 supervisorctl
操作 supervisor:
- 连接 supervisor 后端:
supervisorctl -c /usr/local/etc/supervisord.ini
,注意必须指定启动 supervisor 时用的配置文件。 - 然后就可以通过
help
查看 supervisorctl 支持的命令了,常用的有reload
重载配置,restart all
重启所有应用。
通过 start all
就可以启动配置好的应用了。
二、Linux 安装 supervisor
一般建议通过包管理器安装,好处是不用手写 systemd 配置,缺点是更新太慢。
sudo apt-get install supervisor # 安装
sudo systemctl enable supervisor # 启用开机启动
sudo systemctl start supervisor # 现在启动
如果需要新版本的功能,可以通过 pip 安装最新版,但是需要手动编写 systemd 配置(或者先用 apt-get 装老版本,把 systemd 配置拷下来)。详见 installing supervisor
使用方法
和 MacOS X 有如下区别:
- 默认的配置文件路径不同,主配置文件是
/etc/supervisor/supervisord.conf
,自定义配置路径/etc/supervisor/conf.d/*.conf
- 注意 Linux 中配置的后缀是
.conf
,而在 OS X 中默认使用.ini
原文地址:https://www.cnblogs.com/kirito-c/p/12170126.html