Asp.NetCore轻松学-使用Supervisor进行托管部署

前言

上一篇文章 asp.netcore轻松学-部署到 linux 进行托管 介绍了如何在 centos 上部署自托管的 .net core 应用程序，接下来的内容就是介绍如何使用第三方任务管理程序来托管 .net core 应用程序，这里以笔者常用的 supervisor 为例子，从安装环境开始，一步一步的进入 linux 的世界，部署程序还是以上一篇的项目文件 deploy.linux 为基础。

1. 安装前置条件

centos 和 ubuntu 下，安装 supervisor 的步骤有所不同，在 centos 下，需要先添加 centos 下的扩展包源，

1.1 安装 centos 扩展源

sudo yum install epel-release

1.2. 安装 supervisor

sudo yum install supervisor

• ubuntu 下使用 apt-get install supervisor 进行安装

1.3 supervisor 安装完成

• 输入supervisord --version 查看安装已完成，

注意是 supervisord 后面多了一个字符：d，因为安装的服务名称是：supervisord.service，通过命令查看服务文件可知道

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

1.4 设置 supervisor 开机启动

sudo systemctl enable supervisord
sudo systemctl start supervisord

1.5 进入 supervisor 控制台执行命令

sudo supervisorctl

进入 supervisor 控制台，表示服务安装成功，并已成功启动

2. 创建 supervisor 托管的 .net core 的服务配置文件

2.1 查看配置文件目录

通过查看 cat /etc/supervisord.conf 看到 supervisor 引入配置文件的指定目录为

[include]
files = supervisord.d/*.ini

可以看到，默认的托管服务配置文件目录在 supervisord.d/ 下面，这个目录的完整地址是 /etc/supervisord.d/

2.2 建立配置文件 demo.ini

关于 supervisor 配置文件的含义，这里不做过多的解释，可移步官网查看帮助文档： .net core 应用程序即可

[program:demo]
command=/usr/bin/dotnet  deploy.linux.dll ; 输入执行命令，这里表示 dotnet  deploy.linux.dll
directory=/data/sites/demo/publish ; 应用程序根目录 
autostart=true ; 是否自动启动，当 supervisor 加载该配置文件的时候立即启动它 
autorestart=true ; 是否自动重启，当执行 dotnet  deploy.linux.dll 启动失败时，会重复的自动重启 
logfile_maxbytes=50mb ; 该配置文件输出单个日志文件的大小 
logfile_backups=10 ; 日志备份个数 
loglevel=info ; 记录日志级别 
stderr_logfile=/data/logs/demo/demo.err.log ; 指定标准错误输出日志文件 
stdout_logfile=/data/logs/demo/demo.out.log ; 指定标准输出日志文件 
environment=aspnetcore_environment=production ; 可配置环境变量，该环境变量将通过执行 dotnet  deploy.linux.dll 命令的时候传入到 .net core 应用程序中  
user=root ;启动服务的用户  
stopsignal=int
redirect_stderr=true

• 上面包含了几个关键的参数，都在注释中了,接下来建立日志目录，否则服务启动出错，输入命令

2.3 创建日志文件目录

sudo mkdir -p /data/logs/demo

2.4 重启 supervisor 服务，并进入 supervisorctl

sudo systemctl restart supervisord
sudo supervisorctl

2.5 查看服务状态

输入站点地址： 查看服务已正常启动

2.6 查看日志输出

查看日志输出，定位到目录 /data/logs/demo 查看日志文件内容正常

结束语

本文从零开始介绍如何使用 supervisor，一步一步的从安装环境到编写托管服务文件，设置执行文件、执行文件目录、日志输出配置等细节，最终成功将 .net core 应用程序托管到了 supervisor 中，文中都是通过命令形式进行安装部署，对于接触 linux 比较少的同学来说，可能有些不适应，不过不要紧，这些都是很基础的命令，我们呢，就是要多学多用，达到熟悉和强化记忆，然后平滑过渡到 linux 平台。