Supervisor 为服务创建守护进程

Posted 2021-02-02 along21

　　今天需要再服务上部署一个.net 方面的项目；当时开启服务的命令只能在前台执行；使用nohub CMD &等放在后台开启服务都会宕机；所以搜寻了Supervisor 这个解决办法，为服务创建守护进程。具体操作如下

1、什么是守护进程

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

本篇的创建守护进程，是指发布在Linux上 asp.net core 程序的dotnet xxx.dll命令的宿主进程创建一个守护进程。

在 Linux 上有很多可以管理进程的工具，我们使用 Supervisor 来做这个事情。原因有两点：

•  1、它是微软官方文档推荐的，降低学习成本。
•  2、它并不一定是最好的，但一定是文档最全的。

 

2、认识 Supervisor

2.1 Supervisor 介绍

官方文档：http://supervisord.org/

　　Supervisor是一个客户端/服务器系统，采用 Python(2.4+) 开发的，它是一个允许用户管理，基于 Unix 系统进程的 Client/Server 系统，提供了大量功能来实现对进程的管理。

 

2.2 Supervisor 特征

•  简单
  • Supervisor通过简单的INI样式（可以修改为.conf后缀）配置文件进行配置，该文件易于学习。它提供了许多每个进程选项，使您的生活更轻松，如重新启动失败的进程和自动日志轮换。
• 集中
  • 主管为您提供一个启动，停止和监控流程的位置。流程可以单独控制，也可以成组控制。您可以将Supervisor配置为提供本地或远程命令行和Web界面。
• 高效
  • 主管通过fork / exec启动其子进程，子进程不进行守护。当进程终止时，操作系统会立即向Supervisor发出信号，这与某些依赖麻烦的PID文件和定期轮询重新启动失败进程的解决方案不同。
• 扩展
  • Supervisor有一个简单的事件通知协议，用任何语言编写的程序都可以用它来监视它，以及一个用于控制的XML-RPC接口。它还使用可由Python开发人员利用的扩展点构建。
• 兼容
  • 除了Windows之外，Supervisor几乎可以处理所有事情。它在Linux，Mac OS X，Solaris和FreeBSD上经过测试和支持。它完全用Python编写，因此安装不需要C编译器。
• 久经考验
  • 虽然Supervisor今天非常活跃，但它并不是新软件。主管已存在多年，已在许多服务器上使用。

 

3、安装配置 Supervisor

3.1 各个平台安装Supervisor

（1）在 linux 中使用以下命令进行安装：

•  centos

yum install supervisor

•  ubuntu

sudo apt-get install supervisor

•  python

pip install supervosor easy_install supervisor

 

（2）在 masOS 中直接使用brew工具进行安装即可：

brew install supervisor

 

3.2 Supervisor 配置

（1）linux 安装完后会有一个主配置文件/etc/supervisord.conf，和一个/etc/supervisord.d 自配置文件目录

$ ls /etc/supervisord.*
/etc/supervisord.conf
/etc/supervisor

　　

（2）修改主配置文件，设置自配置文件生效的后缀

$ vim /etc/supervisord.conf   在最后一行
[include]
files = supervisord.d/*.conf

　　

（3）为了方便管理，就在自配置文件目录下，创建项目的配置文件

$ cd /etc/supervisord.d/
$ vim ProjectName.conf
[program: ProjectName]
command=dotnet ProjectName.dll   ; 运行程序的命令
directory=/usr/local/ProjectName/   ; 命令执行的目录
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   ; 自动重启间隔

　　

3.3 启动 Supervisor 服务

（1）开启服务，并设为开机自启

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

 

（2）查询服务状态

$ systemctl status supervisord.service 
● supervisord.service - Process Monitoring and Control Daemon
   Loaded: loaded (/usr/lib/systemd/system/supervisord.service; disabled; vendor preset: disabled)
   Active: active (running) since Fri 2019-01-11 15:00:23 CST; 57min ago
  Process: 910 ExecStart=/usr/bin/supervisord -c /etc/supervisord.conf (code=exited, status=0/SUCCESS)
 Main PID: 913 (supervisord)
   CGroup: /system.slice/supervisord.service
           ├─913 /usr/bin/python /usr/bin/supervisord -c /etc/supervisord.conf
           └─914 dotnet eXiu.OBD.Host.dll

Jan 11 15:00:23 iZe4iwiics91xjZ systemd[1]: Starting Process Monitoring and Control Daemon...
Jan 11 15:00:23 iZe4iwiics91xjZ systemd[1]: Started Process Monitoring and Control Daemon.

　　

（3）查看进程认证

$ ps -ef | grep dotnet ProjectName
root       914   913  0 15:00 ?        00:00:05 dotnet ProjectName.dll
root      3455  3058  0 15:58 pts/0    00:00:00 grep --color=auto dotnet

 

4、报错处理

（1）使用Supervisor 为服务创建守护进程失败

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.
For help, use /usr/bin/supervisord –h

　　是因为有一个使用supervisor配置的应用程序正在运行，需要执行supervisorctl shutdown命令终止它，或重新创建一个ProjectName.conf文件再执行第一条命令。

 

（2）如果运行supervisorctl出现以下错误

error: <class ‘socket.error‘>, [Errno 111] Connection refused: file: /usr/lib64/python2.6/socket.py line: 567

 

　　说明Supervisor 服务没有启动成功，或Supervisor 服务被关闭了，重启启动服务即可。

 

5、supervisorctl 常用命令

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