使用 supervisord 设置应用开机启动

Posted kirito-c

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了使用 supervisord 设置应用开机启动相关的知识,希望对你有一定的参考价值。

以前一直是用 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:

  1. 连接 supervisor 后端:supervisorctl -c /usr/local/etc/supervisord.ini,注意必须指定启动 supervisor 时用的配置文件。
  2. 然后就可以通过 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 有如下区别:

  1. 默认的配置文件路径不同,主配置文件是 /etc/supervisor/supervisord.conf,自定义配置路径 /etc/supervisor/conf.d/*.conf
  2. 注意 Linux 中配置的后缀是 .conf,而在 OS X 中默认使用 .ini

以上是关于使用 supervisord 设置应用开机启动的主要内容,如果未能解决你的问题,请参考以下文章

CentOS7 配置Supervisor开机启动

配置Supervisor开机启动

配置Supervisor开机启动

supervisor进程管理工具的使用

Centos 7 安装Supervisor及使用

supervisor 配置