简介

supervisor管理进程,是通过fork/exec的方式将这些被管理的进程当作supervisor的子进程来启动,所以我们只需要将要管理进程的可执行文件的路径添加到supervisor的配置文件中就好了。此时被管理进程被视为supervisor的子进程,若该子进程异常中断,则父进程可以准确的获取子进程异常中断的信息,通过在配置文件中设置autostart=ture,可以实现对异常中断的子进程的自动重启。

安装

sudo apt-get install supervisor

配置

  • 进入配置文件目录 : cd /etc/supervisor/conf.d
  • 新建配置文件 sudo vim test.conf

配置内如如下:

[program:cow] 
command=/home/argericy/workspace/test #要执行的命令
autostart=true #自动启动
autorestart=true #自动重启
user=root #执行命令用户
log_stderr=true
logfile=/var/log/test.log #日志文件
stopsignal=INT
[supervisord]

参数解释

;[program:theprogramname]
;command=/bin/cat              ; 程序执行命令,需要
;process_name=%(program_name)s ; process_name expr (default %(program_name)s)
;numprocs=1                    ; 进程启动数量,默认为1
;directory=/tmp                ; 工作目录,如果配置了工作目录,command 配置项 可以直接执行工作目录里的命令
;umask=022                     ; 设置进程权限 默认为:none
;priority=999                  ; 设置优先级 默认:999
;autostart=true                ; 在 supervisor 启动时启动程序,默认为:true
;startsecs=1                   ; 程序启动 startsecs 秒 后视为程序启动成功, 默认为:1
;startretries=3                ; 当程序启动失败后最大尝试次数,默认为:3
;autorestart=unexpected        ; 其值为可以设置为 true 、false 、expected 设置为 true 无论什么情况下都自动重启, 设置为 false 则不自动重启,设置 unexpected 则配合 exitcodes 使用,只有在 exitcodes 配置的中的退出代码 才会自动重启
;exitcodes=0,2                 ; autorestart 设置为 unexpected 此项生效,默认为: 0,2
;stopsignal=QUIT               ; 用于 kill 进程的信号 默认为: TERM
;stopwaitsecs=10               ; 停止进程等待秒数,默认为:10
;stopasgroup=false             ; 发送停止信号给 UNIX 进程组 默认为:false
;killasgroup=false             ; 发送立刻中止信号给 UNIX 进程组,默认为:false
;user=chrism                   ; 设置启动程序的用户
;redirect_stderr=true          ; redirect proc stderr to stdout (default false)
;stdout_logfile=/a/path        ; 输入日志配置
;stdout_logfile_maxbytes=1MB   ; 日志容量大与1m则分割日志
;stdout_logfile_backups=10     ; 备份文件数量,默认为10
;stderr_logfile=/a/path        ; 标准错误日志输出
;stderr_logfile_maxbytes=1MB   ; 日志容量大与1m则分割日志
;stderr_logfile_backups=10     ; 备份文件数量,默认为10
;serverurl=AUTO                ; override serverurl computation (childutils)

使用 supervisorctl

Supervisorctl 是 supervisord 的一个命令行客户端工具,启动时需要指定与 supervisord 使用同一份配置文件,否则与 supervisord 一样按照顺序查找配置文件。

$ supervisorctl status
$ supervisorctl stop usercenter
$ supervisorctl start usercenter
$ supervisorctl restart usercenter
$ supervisorctl reread
$ supervisorctl update

加入开机启动(centos)

关于 centos 加入服务,在《Centos 服务配置详解》 一文中有详细的说明,这里只是简单的应用。
创建文/usr/lib/systemd/system/supervisord.service

$ sudo vim /usr/lib/systemd/system/supervisord.service

插入如下内容:

[Unit] 
Description=Supervisor

[Service] 
Type=forking 
ExecStart=/usr/bin/supervisord -c /etc/supervisor/supervisord.conf  // 启动命令
ExecStop=/usr/bin/supervisorctl shutdown  //关闭命令
ExecReload=/usr/bin/supervisorctl reload  //重载命令
KillMode=process 
Restart=on-failure 
RestartSec=42s

[Install] 
WantedBy=multi-user.target

启动服务

$ systemctl enable supervisord

验证服务是否未开机启动

$ systemctl is-enabled supervisord //返回 enable 表示已启动

常见问题

supervisor Error: .ini file does not include supervisord section

在配置文件中增加 [supervisord] 配置项