supervisorctl守护进程

supervisorctl守护进程

1 安装

# ubuntu安装：

 sudo apt-get install supervisor

完成后可以在/etc/supervisor文件夹，找到supervisor.conf。

如果没有的话可以用如下命令创建配置文件（注意必须存在/etc/supervisor这个文件夹）

sudo su - root -c "echo_supervisord_conf > /etc/supervisor/supervisord.conf"

echo_supervisord_conf >/etc/supervisor/supervisord.conf

2 supervisor配置

supervisord.conf配置文件

默认不用修改

sudo  vim /etc/supervisor/supervisord.conf

# 文件的最后有这么一句话

[include]

files = /etc/supervisor/conf.d/*.conf

#配置文件会引入/etc/supervisor/conf.d/目录下所有conf后缀的文件.

创建自定义的服务配置文件

在/etc/supervisor/conf.d/下建立文件ipfs.conf：

。

注意: 日志路径不存在会启动失败! supervisor不会自己创建目录!

; 设置进程的名称，使用 supervisorctl 来管理进程时需要使用该进程名

[program:ipfs]

directory = /usr/local/bin            ; 程序的启动目录

command=/usr/local/bin/ipfs daemon    ; 启动命令 最好绝对路径

autostart = true                      ; 在 supervisord 启动的时候也自动启动

numprocs=1                            ; 默认为1

process_name=%(program_name)s         ; 默认为 %(program_name)s，即 [program:x] 中的 x

user=root                             ; 使用 root 用户来启动该进程

autorestart=true           ; 程序崩溃时自动重启，重启次数是有限制的，默认为3次

redirect_stderr=true                  ; 重定向输出的日志

stdout_logfile = /var/log/supervisord/tornado_server.log

loglevel=info

supervisor.conf配置文件说明：

[unix_http_server]

file=/tmp/supervisor.sock   ;UNIX socket 文件，supervisorctl 会使用

;chmod=0700                 ;socket文件的mode，默认是0700

;chown=nobody:nogroup       ;socket文件的owner，格式：uid:gid

;[inet_http_server]         ;HTTP服务器，提供web管理界面

;port=127.0.0.1:9001        ;Web管理后台运行的IP和端口，如果开放到公网，需要注意安全性

;username=user              ;登录管理后台的用户名

;password=123               ;登录管理后台的密码

[supervisord]

logfile=/tmp/supervisord.log ;日志文件，默认是 $CWD/supervisord.log

logfile_maxbytes=50MB        ;日志文件大小，超出会rotate，默认 50MB，如果设成0，表示不限制大小

logfile_backups=10           ;日志文件保留备份数量默认10，设为0表示不备份

loglevel=info                ;日志级别，默认info，其它: debug,warn,trace

pidfile=/tmp/supervisord.pid ;pid 文件

nodaemon=false               ;是否在前台启动，默认是false，即以 daemon 的方式启动

minfds=1024                  ;可以打开的文件描述符的最小值，默认 1024

minprocs=200                 ;可以打开的进程数的最小值，默认 200

[supervisorctl]

serverurl=unix:///tmp/supervisor.sock ;通过UNIX socket连接supervisord，路径与unix_http_server部分的file一致

;serverurl=http://127.0.0.1:9001 ; 通过HTTP的方式连接supervisord

; [program:xx]是被管理的进程配置参数，xx是进程的名称

[program:xx]

command=/opt/apache-tomcat-8.0.35/bin/catalina.sh run  ; 程序启动命令

autostart=true       ; 在supervisord启动的时候也自动启动

startsecs=10         ; 启动10秒后没有异常退出，就表示进程正常启动了，默认为1秒

autorestart=true     ; 程序退出后自动重启,可选值：[unexpected,true,false]，默认为unexpected，表示进程意外杀死后才重启

startretries=3       ; 启动失败自动重试次数，默认是3

user=tomcat          ; 用哪个用户启动进程，默认是root

priority=999         ; 进程启动优先级，默认999，值小的优先启动

redirect_stderr=true ; 把stderr重定向到stdout，默认false

stdout_logfile_maxbytes=20MB  ; stdout 日志文件大小，默认50MB

stdout_logfile_backups = 20   ; stdout 日志文件备份数，默认是10

; stdout 日志文件，需要注意当指定目录不存在时无法正常启动，所以需要手动创建目录（supervisord 会自动创建日志文件）

stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.out

stopasgroup=false     ;默认为false,进程被杀死时，是否向这个进程组发送stop信号，包括子进程

killasgroup=false     ;默认为false，向进程组发送kill信号，包括子进程

;包含其它配置文件

[include]

files = relative/directory/*.ini    ;可以指定一个或多个以.ini结束的配置文件

在/etc/supervisor下创建conf.d用于放置需要管理的服务配置文件

[program:blog] ; 项目名

directory=/opt/bin ; 脚本目录

command=/usr/bin/python /opt/bin/test.py ; 脚本执行命令

autostart=true ; supervisor启动的时候是否随着同时启动，默认True

autorestart=false ; 当程序exit的时候，这个program不会自动重启,默认unexpected，设置子进程挂掉后自动重启的情况，有三个选项，false,unexpected和true。如果为false的时候，无论什么情况下，都不会被重新启动，如果为unexpected，只有当进程的退出码不在下面的exitcodes里面定义的

startsecs=1 ; 这个选项是子进程启动多少秒之后，此时状态如果是running，则我们认为启动成功了。默认值为1

user = test ; 脚本运行的用户身份

stderr_logfile=/tmp/blog_stderr.log ; 错误日志输出

stdout_logfile=/tmp/blog_stdout.log ; 输出日志输出

redirect_stderr = true ; 把stderr重定向到stdout，默认 false

stdout_logfile_maxbytes = 20M ; stdout日志文件大小，默认 50MB

stdout_logfile_backups = 20 ; stdout日志文件备份数

3 权限修改

sudo chmod 777 /var/run

sudo chmod 777 /etc/supervisor

3 启动

sudo supervisord -c /etc/supervisor/supervisord.conf

systemctl start supervisor.service     //启动supervisor并加载默认配置文件

systemctl enable supervisor.service    //将supervisor加入开机启动项

sudo systemctl status supervisor    //状态

4 开机自启动

cat /lib/systemd/system/supervisor.service

[Unit]

Description=Supervisor process control system for UNIX

Documentation=http://supervisord.org

After=network.target

[Service]

ExecStart=/usr/bin/supervisord -n -c /etc/supervisor/supervisord.conf

ExecStop=/usr/bin/supervisorctl $OPTIONS shutdown

ExecReload=/usr/bin/supervisorctl -c /etc/supervisor/supervisord.conf $OPTIONS reload

KillMode=process

Restart=on-failure

RestartSec=50s

[Install]

WantedBy=multi-user.target

systemctl enable supervisor.service

5 常用命令

sudo supervisorctl update	更新，如果修改配置文件
sudo supervisord -c /etc/supervisor/supervisord.conf	启动supervisor服务
sudo supervisorctl status	查看supervisor状态
sudo supervisorctl	查看supervisor服务是否正常运行，进入交互模式，ctrl +c退出。命令不带supervisorctl可直接使用
sudo supervisorctl start 进程名字	启动某个supervisor进程
sudo supervisorctl stop 进程名字	停止某个supervisor进程
sudo supervisorctl start all	启动所有
sudo supervisorctl stop all	停止所有
sudo supervisorctl shutdown	关闭supervisor
sudo systemctl disable supervisor
systemctl enable supervisor
systemctl daemon-reload
systemctl start supervisor
supervisorctl reload	重新启动修改配置文件的进程
supervisorctl tail -f program_name	查看 该程序的日志
whereis supervisor	supervisor安装的目录
supervisord -v	查看supervisor版本

6 介绍

supervisor

supervisor是一个进程管理工具，当进程中断的时候supervisor能自动重新启动它，同时，它也是一个客户端/服务器系统，允许用户在类unix操作系统上控制多个进程。

supervisor是用Python开发的一套通用的进程管理程序，能将一个普通的命令行进程变为后台daemon，并监控进程状态，异常退出时能自动重启。

supervisor是通过fork/exec的方式把这些被管理的进程当作supervisor的子进程来启动，这样只要在supervisor的配置文件中，把要管理的进程的可执行文件的路径写进去即可。

　　可实现当子进程挂掉的时候，父进程可以准确获取子进程挂掉的信息的，可以选择是否自己启动和报警。

supervisor还提供了一个功能，可以为supervisord或者每个子进程，设置一个非root的user，这个user就可以管理它对应的进程。

supervisor进程管理服务组成

supervisor主要包括以下四个核心部分组成：

supervisord

　　这是supervisor服务的主要管理器，运行 Supervisor 时会启动一个进程 supervisord，它负责启动所管理的进程;

　　并将所管理的进程作为自己的子进程来启动，而且可以在所管理的进程出现崩溃时自动重启。

supervisorctl

　　这是supervisor服务的客户端命令行工具，可以用来执行stop、start、restart等命令，来对这些子进程进行管理。

web Server

　　这是supervisor服务的网页可视化界面，可以通过web界面查看和控制进程状态，简化了对操作命令的学习;

xml-rpc interface

　　服务与web ui的同一个http服务器，提供一个xml-rpc接口，可以用来询问和控制管理程序及其他运行的程序;

supervisor服务运行环境

supervisor可以运行在大多数类unix系统，但是不能运行在任何windows系统，supervisor运行在python环境中;

可以在python2(2.7)版本上工作、python3(3.4)版本上工作、以及更高python版本上。

进程管理服务配置信息

supervisor进程管理服务程序安装完毕后，会在系统中生成两个主要的配置文件：

　　主进程配置文件：/etc/supervisor/supervisord.conf

　　子进程配置文件：/etc/supervisor/conf.d/

7 示例

8 参考

Supervisor 后台进程管理_进入supervisor后台-CSDN博客

supervisor 安装与配置_supervisor安装-CSDN博客

进程管理程序Supervisor-安装_supervisor 安装-CSDN博客