Supervisor通用配置

2020 年 7 月 22 日
筆記

1、简介

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

supervisord

运行superior的时候会启动一个进程superiord，他主要是负责启动所管理的进程，并且将所管理的进程作为自己的子进程来启动，而且可以在所管理的进程出现崩溃的时候自动重启

supervisorctl

它是supervisor的命令行管理工具，可以执行stop,start,restart,status,update等指令，来对这些子进程进行管理。

supervisor是所有进程的父进程，管理所有的子进程，supervisor以子进程的PID来管理子进程，当子进程异常退出的时候supervisor可以收到相应的信号量

2、安装supervisor

因为supervisor是基于python来运行的，所以我们的服务器上必须有python环境，但是如果你服务器上跑的是django或者其他的python项目必然基于python环境，如果supervisor管理的后台服务比较多的话肯定会有一些影响，所以supervisor的安装会创建一个新的虚拟环境。

1、安装Python3.8.2

# 下载python
> wget //www.python.org/ftp/python/3.8.2/Python-3.8.2.tar.xz

# 解压安装包
> tar -xf Python-3.8.2.tar.xz

# 进入目标文件
> cd Python-3.8.2

# 配置安装目录
> ./configure --prefix=/usr/local/python3

# 编译&安装
> make && sudo make install

# 建立软连接：python3，pip3
> ln -s /usr/local/python3/bin/python3.8 /usr/bin/python3
> ln -s /usr/local/python3/bin/pip3.8 /usr/bin/pip3

# 删除安装包与文件
> rm -rf Python-3.8.2
> rm -rf Python-3.8.2.tar.xz

2、安装python虚拟环境

# 1、安装工具包
> pip3 install virtualenv
> pip3 install virtualenvwrapper

# 注意：有些解释器无法直接安装virtualenvwrapper包，可能是因为缺少依赖，可以先安装一下下面两个包
> pip3 install pbr
> pip3 install stevedore

# 2、建立虚拟环境软链接
> ln -s /usr/local/python3/bin/virtualenv /usr/bin/virtualenv

# 3、配置虚拟环境对应环境变量
> vim ~/.bash_profile

export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
# 指定virtualenv的路径
source /usr/local/bin/virtualenvwrapper.sh

# 4、更新配置文件内容

> source ~/.bash_profile

所有的虚拟环境文件都指定存放在~/.virtualenvs 目录

3、创建python虚拟环境

# 1、创建虚拟环境
> mkvirtualenv supervisor_env # 虚拟环境名称

# 2、管理虚拟环境
> workon  # 进入虚拟环境只需要在后面加上虚拟环境名称

# 3、退出虚拟环境
> deactivate

4、supervisor安装

# 安装
> pip install supervisor

# 生成配置文件
> echo_supervisord_conf > supervisord.conf

3、配置supervisor

5、superiord.conf

# 指定socket文件路径
[unix_http_server]
file=/root/work/manager/supervisor/supervisor.sock   ; the path to the socket file

[supervisord]
logfile=/root/work/manager/supervisor/supervisord.log ; main log file; default $CWD/supervisord.log
logfile_maxbytes=50MB        ; max main logfile bytes b4 rotation; default 50MB
logfile_backups=10           ; # of main logfile backups; 0 means none, default 10
loglevel=info                ; log level; default info; others: debug,warn,trace
pidfile=/root/work/manager/supervisor/supervisord.pid ; supervisord pidfile; default supervisord.pid
nodaemon=false               ; start in foreground if true; default false
silent=false                 ; no logs to stdout if true; default false
minfds=1024                  ; min. avail startup file descriptors; default 1024
minprocs=200                 ; min. avail process descriptors;default 200

[supervisorctl]
serverurl=unix:///root/work/manager/supervisor/supervisor.sock ; use a unix:// URL  for a unix socket

# 指定分发所有子进程的配置目录，默认子进程配置文件为ini格式
[include]
files = conf.d/*.ini

6、例：conf.d/onlydaya.ini

将不同分类的子进程单独使用配置文件，便于后期管理。下面的例子是后台启动uwsgi

# 项目名称
[program:onlydata]
# 脚本目录
directory=/root/work/code/python/onlydata
# 脚本执行命令
command=/root/.virtualenvs/onlydata/bin/uwsgi --ini /root/work/code/python/onlydata/onlydata/uwsgi.ini 
# 日志输出
stderr_logfile=/root/work/code/python/onlydata/uwsgi.err.log
stdout_logfile=/root/work/code/python/onlydata/uwsgi.out.log 
# 脚本运行的用户身份
user=root
stopsignal=INT
# 这个选项是子进程启动多少秒之后，此时状态如果是running，则我们认为启动成功了。默认值为1
startsecs=1

4、supervisor常用命令

supervisorctl status        //查看所有进程的状态
supervisorctl stop es       //停止es
supervisorctl start es      //启动es
supervisorctl restart       //重启es
supervisorctl update        //配置文件修改后使用该命令加载新的配置
supervisorctl reload        //重新启动配置中的所有程序

也可以通过supervisorctl进入supervisor的shell界面，直接进行命令操作

补充：

systemctl start supervisord.service     //启动supervisor并加载默认配置文件
systemctl enable supervisord.service    //将supervisor加入开机启动项