Supervisor管理进程小记01

前言

在处理消息队列的时候，为了方便消费者类处理消息队列，我们不需要手动在终端上去敲命令监听创建进程处理队列，使用supervisor进程管理可以很方便的去管理消息队列进程处理；

简介

在linux或者unix操作系统中，守护进程（Daemon）是一种运行在后台的特殊进程，它独立于控制终端并且周期性的执行某种任务或等待处理某些发生的事件。由于在linux中，每个系统与用户进行交流的界面称为终端，每一个从此终端开始运行的进程都会依附于这个终端，这个终端被称为这些进程的控制终端，当控制终端被关闭的时候，相应的进程都会自动关闭。但是守护进程却能突破这种限制，它脱离于终端并且在后台运行，并且它脱离终端的目的是为了避免进程在运行的过程中的信息在任何终端中显示并且进程也不会被任何终端所产生的终端信息所打断。它从被执行的时候开始运转，直到整个系统关闭才退出。

此处的创建守护进程，是指发布在Linux上 asp.net core 程序的dotnet xxx.dll命令的宿主进程创建一个守护进程。
在 Linux 上有很多可以管理进程的工具，我们使用 Supervisor 来做这个事情。原因有两点：
1、它是微软官方文档推荐的，降低学习成本。
2、它并不一定是最好的，但一定是文档最全的。
        Supervisor是采用 Python(2.4+) 开发的，它是一个允许用户管理 基于 Unix 系统进程的 Client/Server 系统，提供了大量功能来实现对进程的管理。
官方文档：http://supervisord.org/

安装supervisor

 1，安装命令：

        yum  install  python-setuptools

          easy_install   supervisor

    或者：

            如果easy_install不好使就从官方下载：

wget https://pypi.python.org/packages/80/37/964c0d53cbd328796b1aeb7abea4c0f7b0e8c7197ea9b0b9967b7d004def/supervisor-3.3.1.tar.gz

然后通过python安装：

tar zxf supervisor-3.3.1.tar.gz
cd supervisor
python setup.py install

如果报错可能：

1. 提示setuptools-0.6c11.tar没有安装

   下载https://pypi.python.org/packages/source/s/setuptools/setuptools-0.6c11.tar.gz
   tar zxf setuptools-0.6c11.tar.gz
   cd setuptools-0.6c11/
   python setup.py build
   python setup.py  install

2. 提示下载错误，需meld3>0.6.5
   1. 下载 http://dl.fedoraproject.org/pub/epel/7/x86_64/p/python-meld3-0.6.10-1.el7.x86_64.rpm(或者我备份了一份)
   2. 安装 rpm -ivh python-meld3-0.6.10-1.el7.x86_64.rpm

　　如下提示，安装完成：

1 2	Using /usr/lib64/python2.7/site-packages Finished processing dependencies  for  supervisor==3.3.1

配置Supervisor

    a,创建文件夹和配置文件      

mkdir /etc/supervisor
echo_supervisord_conf > /etc/supervisor/supervisord.conf

    b.修改/etc/supervisor/supervisord.conf文件内容

在文件结尾[include]节点处

把;files = relative/directory/*.ini

改为files = conf.d/*.conf

c.执行supervisorctl reload命令使配置文件生效。

（注意：supervisord是服务端命令；supervisorctl是客户端命令；比如这里，我们每次修改配置文件supervisor.conf都要执行命令:supervisorctl  reload命令使得配置文件生效；当然重点在这，有时候会报错，这时候需要先关闭客户端进程：supervisorctl  shutdown ;然后使用服务端让配置文件生效：supervisord  /etc/supervisor/supervisord.conf ;最后再 supervisorctl  reload ; 这样就不会报错。报错信息可能如下 ： 01 , Error: Another program is already listening on a port that one of our HTTP servers is configured to use.  Shut this program down first before starting supervisord. 

02,error: <class 'socket.error'>, [Errno 2] No such file or directory: file: <string> line: 1   这个应该是服务端没有开启，哈哈哈）

d.在/etc/supervisor/下创建conf.d文件夹，及ProjectName.conf(以项目名称命名的)

e.打开ProjectName.conf文件，添加内容如下：

[program: ProjectName]
command=dotnet ProjectName.dll ; 运行程序的命令
directory=/root/Publishing/PublishOutput/ ; 命令执行的目录
autorestart=true ; 程序意外退出是否自动重启
autostart=true ; 是否自动启动
stderr_logfile=/var/log/ProjectName.err.log ; 错误日志文件
stdout_logfile=/var/log/ProjectName.out.log ; 输出日志文件
environment=ASPNETCORE_ENVIRONMENT=Production ; 进程环境变量
user=root ; 进程执行的用户身份
stopsignal=INT

startsecs=1 ; 自动重启间隔

或者

[program:php]
command= /usr/bin/php think queue:work --queue notify --daemon ; 被监控进程
directory=/home/wwwroot/dlsj.mrpzx.com
;process_name=%(process_num)02d 
;numprocs=5 #启动几个进程
autostart=true ;随着supervisord的启动而启动
autorestart=true ;自动启动
startsecs=1 ;程序重启时候停留在runing状态的秒数
startretries=10 ;启动失败时的最多重试次数
redirect_stderr=true ;重定向stderr到stdout

stdout_logfile=/root/supervisor.log ;stdout文件

3、 运行supervisord，查看是否生效，执行以下命令：

upervisord -c /etc/supervisor/ supervisord.conf
ps -ef | grep ProjectName

返回

root     27007 27006  1 13:21 ?        00:00:02 dotnet ProjectName.dll 
root     27026 26810  0 13:23 pts/0    00:00:00 grep --color=auto ProjectName

或者返回 

root     18164 18141  0 15:32 ?        00:00:04 /usr/bin/php think queue:listen --queue multiTaskJobQueue

root     21589 18164  3 16:31 ?        00:00:00 /usr/local/php/bin/php think queue:work --queue=multiTaskJobQueue --delay=0 --memory=128 --sleep=3 --tries=0
root     21593 13889  0 16:31 pts/1    00:00:00 grep multi

表示运行成功！

或者在客户端直接查看状态：

supervisor> status
multi                            STARTING  
supervisor> status
multi                            RUNNING   pid 18164, uptime 0:00:05
supervisor> status
multi                            RUNNING   pid 18164, uptime 0:00:09

supervisor> 

 常用命令

1 2 3 4 5 6 7 8 9

sudo service supervisor stop 停止supervisor服务   sudo service supervisor start 启动supervisor服务   supervisorctl shutdown #关闭所有任务   supervisorctl stop|start program_name #启动或停止服务   supervisorctl status #查看所有任务状态

　　 

 配置supervisord开机启动

a.在指定目录下创建文件supervisord.service

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

b.输入以下内容：

[Unit]
Description=Supervisor daemon 

[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

提示：

Created symlink from /etc/systemd/system/multi-user.target.wants/supervisord.service to /usr/lib/systemd/system/supervisord.service.

验证是否为开机启动：

systemctl is-enabled supervisord

提示：

enabled

表示设置成功！

至此，创建supervisor守护进程完毕。