进程管理工具Supervisor使用说明

末蓝、 2022-03-15 01:34 348阅读 0赞

## 背景： ##

项目中遇到有些脚本需要通过后台进程运行， 保证不被异常中断， 之前都是通过nohup、&、screen来实现， 在基于可以实现start/stop/restart/reload的服务后，出现了Supervisor。

Supervisor是用Python开发的一套通用的进程管理程序， 能降一个普通的命令行进程变为后台daemon， 并监控进程状态， 异常退出时能自动重启。它是通过fork、exec的方式把这些被管理的进程当做supervisor的子进程来启动， 这样只要在supervisor的配置文件中， 把要管理的进程的可执行文件的路径写进去就可以了。 也实现当子进程挂掉的时候， 父进程可以准确的获取子进程挂掉的信息， 可以选择是否重启和报警。 supervisor还提供了一个功能， 可以为supervisord或者每一个子进程， 设置一个非root的user， 这个user就可以管理它对应的进程。

## 说明： ##

### 1. 安装 ###

1: easy_install 安装：
    easy_install supervisor
    
    2: pip 安装：
    pip install supervisor
    
    3: Debian / Ubuntu 可以直接通过apt安装：
    apt-get installsupervisor

### 2. 配置文件 ###

*  通过apt-get install 安装后， supervisor的配置文件在：  
    `/etc/supervisor/supervisord.conf`  
    supervisor的配置文件默认是不全的， 不过在大部分默认的情况下， 上面说的基本功能已经满足。 而其管理的子进程配置文件在：  
    `/etc/supervisor/conf.d/*.conf`  
    然后， 开始给自己需要的脚本程序编写一个子进程配置文件，让supervisor来管理它， 放在 上面 路径的目录下面， 以.conf作为扩展名(每个进程的配置文件都可以单独分拆也可以把相关的脚本放一起)。 如任意定义一个和脚本相关的项目名称的选项组 （/etc/supervisor/conf.d/test.conf）:

# 项目名
    [program:blog]
    
    # 脚本目录
    directory=/opt/bin
    
    # 脚本执行命令
    command=/usr/bin/python /opt/bin/willpy
    
    # supervisor 启动的时候是否随着同事启动， 默认为True
    autostart=true
    
    # 当程序exit的时候， 这个program不会自动重启， 默认unexpected
    # 设置子进程挂掉后自动重启的情况， 有三个选项， false, unexpected和true。如果为false的时候，无论什么情况下， 都不会被重新启动， 如果为unexpected， 只有当进程的退出码不在下面的exitcodes里面定义的
    autorestart=true
    
    # 这个选项是子进程启动多少秒之后， 此时的状态如果是runnning， 则我们认为启动成功了。 默认值为1
    startsecs=1
    
    #日志输出
    stderr_logfile=/tmp/blog_stderr.log
    stdout_logfile=/tmp/blog_stdout.log
    
    # 脚本运行的用户身份
    user=will
    
    # 把 stderr 重定向到 stdout, 默认false
    redirect_stderr=true
    
    # stdout 日志文件大小， 默认 50M
    stdout_logfile_maxbytes=20M
    
    # stdout 日志文件备份数
    stdout_logfile_backups=20
    
    
    [program:zhoujy] #说明同上
    directory=/opt/bin 
    command=/usr/bin/python /opt/bin/will.py 
    autostart=true 
    autorestart=false 
    stderr_logfile=/tmp/will_stderr.log 
    stdout_logfile=/tmp/will_stdout.log 
    #user = will

### 3.运行 ###

*  apt-get install 安装的supervisor直接可以通过 /etc/init.d/supervisor 运行：  
    `/etc/init.d/supervisor start`

### 4.web界面操作 ###

需要在supervisor的配置文件里面添加【inet\_http\_server】选项组： 之后可以通过http://10.211.55.11:9001 来访问控制子线程的管理。

[inet_http_server]
    port=10.211.55.11:9001
    username=user
    password=123

### 5.子进程管理（supervisorctl） ###

*  查看所有子进程的状态：

# supervisorctl status
    blog                             RUNNING    pid 2395, uptime 0:08:41
    will                             RUNNING    pid 2396, uptime 0:08:41

*  关闭、开启指定的子进程：

# supervisorctl stop all
    blog: stopped
    will: stopped
    
    # supervisorctl start all
    blog: started
    will: started

*  其他参数：  
    supervisor 开始后子进程自动开始（autostart=true）和子进程退出后自动启动（autorestart=true）

#### [官网戳这里][Link 1] ####

[Link 1]: http://supervisord.org/