在CentOS上部署Asp.net Core应用程序

作为一个Linux新手,许多人向我鼓吹说CentOS多么强大,于是我就开始把一个演示程序发布到CentOS,想试一下它到底有多强大。在此之前,我将同样的程序已经成功发布到了Ubuntu,我觉得,既然已经有了前一次的成功经验,不论CentOS还是Ubuntu都是Linux,道理应该差不多吧。但事实证明,还是有些差异的,某些在CentOS上频出的问题在Ubuntu上却没有,所以我的感觉是Ubuntu部署Asp.net Core程序更容易些。


过程很不顺利,但最终经过一天摸索已摸清个七八成,应用总算能运行了。


Asp.net Core应用需要反向代理配合才能运行,IIS、Apache和Nginx等Web服务软件都可以作为它的反向代理。这里使用Nginx作为反向代理。


1.安装.NET Core SDK。四个命令,依次执行:

sudo yum install libunwind libicu

curl -sSL -o dotnet.tar.gz https://go.microsoft.com/fwlink/?linkid=847103

sudo mkdir -p /opt/dotnet && sudo tar zxf dotnet.tar.gz -C /opt/dotnet

sudo ln -s /opt/dotnet/dotnet /usr/local/bin


2.安装nginx。

yum install nginx


3.上传应用程序。使用工具不限,在Windows上可以用MobaXterm,这个东西不错,既能登录系统,也能传送和下载文件,还可以可视化地浏览服务器上的目录、打开文件进行编辑。


4. 配置nginx。打开/etc/nginx/nginx.conf,找到“server”块,把以前的东西删除或注释掉,再添加如下配置:

listen 80;

location / {

proxy_pass http://localhost:5000;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection keep-alive;

proxy_set_header Host $host;

proxy_cache_bypass $http_upgrade;

}

此时,应用内部的Kestrel监听的端口是5000,而外部用户访问应用仍然使用80端口。


注意找到“user XXX;”这句,"XXX"可以为任何字串,这个东西要记住,稍后把.net Core应用监听服务设置为系统服务时需要它。


5.经过第4步配置后,进入应用程序所在目录,执行

dotnet app.dll(app.dll是asp.net core应用程序发布后生成的文件,需要用你自己的应用名称替代app.dll)


一切安好的话,此时应用应该可以访问了,打开浏览器去试一下。


到此为止,应用程序已经部署好了。但是,你发现了,有个命令窗口一直开着,它就是执行dotnet xxxx.dll那个窗口,如果这个窗口关闭了,那么应用程序也随即不能访问了。作为完美型的程序猿,肯定不希望这个窗口总趴在屏幕上,这时就用到了系统服务,让应用程序监听服务在系统启动时自动启动,省去了每次启动都需要再次执行dotnet命令去运行服务。


6.将应用程序的监听服务设置为系统服务。这一步中,许多介绍部署.net core应用的文章都使用一个叫“Supervisor”的东西,这个东西我不熟,当然,其实我对整个Linux就不熟,通过参考资料,我使用系统自带的systemd(据说以前的版本没有这个东西,我用的是CentOS 7)来制作守护进程。


在/etc/systemd/system/目录下建一个服务文件xxxx.service(用自己的名称替换xxxx),然后打开,写入:

[Unit]
Description=应用描述
[Service]
WorkingDirectory=/sites/test_app#工作目录,合理配置
#执行dotnet命令的地方,注意配置为自己机器上正确的dotnet所在路径及程序所在路径
ExecStart=/usr/local/bin/dotnet/sites/test_app/WebApp.dll
Restart=always
RestartSec=10
#注意,这里User的值应该与第4步nginx.conf配置文件里userXXX的XXX相同。
#比如在nginx.conf中,有一句:usernginx;那么此处也为User的值就为nginx
User=nginx

Environment=ASPNETCORE_ENVIRONMENT=Production
[Install]
WantedBy=multi-user.target

上面“#”号后面的是注释,我加了些说明,实际使用时可以移除这些注释。

在这步中遇到个问题,一开始,在“ExecStart……“后面有个注释,在执行
systemctlenablexxxx.service
时老是报错。后来把注释移除,并且把这句后面的空格删除后就正常了。


7.将服务设置为开机自启,这样每当机器重启就不需要再执行dotnet命令来启动应用程序监听了,那个碍眼的dotnet监听窗口也可以关闭了。

设置服务开机自启:

systemctl enable xxxx.service


启动服务:

systemctl start xxxx.service


查看服务状态:

systemctl status xxxx.service

如果服务没能正常启动,这个命令可以显示哪里出错。如果有错误,修改错误。

到此,部署完成,应该能访问应用了。


第二天,我想起了已经把监听服务设置成了系统服务,可以在重启后不需要执行dotnet命令,于是我就想测一测到底靠不靠谱,就把机器重启了。结果浏览器给我回馈了个“Bad Gateway”,真是不靠谱啊,说好的Linux强大呢?


我用systemctl status检查了服务,显示运行中,不是服务没启动,说明系统服务还是靠谱的。那怎么不能访问了呢?网上找了半天没找到想要的答案,突然想到,是不是nginx这玩意挂了,因为在安装、配置nginx时这货就曾经瘫过,使用nginx -s reload命令想重启一下nginx,结果发现它提示nginx.pid文件出了问题。关于这个问题的解决办法,我在《Nginx在CentOS中丢失nginx.pid文件的处理》中提到过。

在Ubuntu下部署与这个差不多,某些命令不一样。参考:https://docs.microsoft.com/zh-cn/aspnet/core/publishing/linuxproduction。

相关文章

本文将从上往下,循序渐进的介绍一系列相关.NET的概念,先从...
基于 .NET 的一个全新的、好用的 PHP SDK + Runtime: Pe...
.NET 异步工作原理介绍。
引子 .NET 6 开始初步引入 PGO。PGO 即 Profile Guided Opti...
前言 2021/4/8 .NET 6 Preview 3 发布,这个版本的改进大多来...
前言 开头防杠:.NET 的基础库、语言、运行时团队从来都是相...