【无私分享:ASP.NET CORE 项目实战(第十章)】发布项目到 Linux 上运行 Core 项目
目录索引
简介
ASP.Net Core 给我们带来的最大的亮点就是跨平台,我在我电脑(win7)上用虚拟机建了个 CentOS7 ,来演示下,我们windows上的项目如何发布项目到Linux上运行。我这里有个在windows上搭建过的程序,我们主要演示如何在linux上运行,所以大家不要纠结于这些,大家可以新建一个web项目尝试一下。
安装.NET Core SDK for CentOS
一、.Netcore 1.0 微软有详细的安装命令,可以参考 Install .NET Core SDK
① 安装 libicu 依赖: sudo yum install libunwind libicu
安装成功:
② 下载 SDK 压缩包:curl -sSL -o dotnet.tar.gz https://go.microsoft.com/fwlink/?LinkID=809131
③ 解压缩:sudo mkdir -p /opt/dotnet && sudo tar zxf dotnet.tar.gz -C /opt/dotnet
④ 创建连接:sudo ln -s /opt/dotnet/dotnet /usr/local/bin
二、.Netcore 2.0 微软有详细的安装命令,可以参考 Install .NET Core SDK
(注意:安全之前要删除旧的 .net core 版本 删除home目录下的dotnet)
注册 Microsoft 签名密钥:sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
添加 Microsoft 产品源:sudo sh -c 'echo -e "[packages-microsoft-com-prod]\nname=packages-microsoft-com-prod \nbaseurl=https://packages.microsoft.com/yumrepos/microsoft-rhel7.3-prod\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/dotnetdev.repo'
更新:sudo yum update
安装 libicu 依赖: sudo yum install libunwind libicu
安装sdk: sudo yum install dotnet-sdk-2.1.4
将 dotnet 添加到 PATH:export PATH=$PATH:$HOME/dotnet
dotnet --version
三、NetCore 2.1.1
The specified framework 'Microsoft.AspNetCore.App', version '2.1.1' was not found.
注册源:
sudo rpm -Uvh https://packages.microsoft.com/config/rhel/7/packages-microsoft-prod.rpm
安装SDK
sudo yum update
sudo yum install aspnetcore-runtime-2.1
测试安装是否成功
通过 dotnet --info 来查看一下,出现如下界面,表示成功:
测试项目运行
注意:不熟悉Linux的朋友请注意,Liunx下路径是区分目录大小写的。
① 新建一个目录:mkdir TestApp
② 进入目录:cd TestApp
③ 新建一个默认的 web 项目:dotnet new -t web
④ 还原包:dotnet restore
这个时间可能比较长,看网速了,大家要耐心等待。
⑤ 我们来运行一下:dotnet run
发布我们的项目到Linux
大家可以使用Ftp等方式将文件发布到服务器上,我这里直接发布到本地文件夹中,然后通过FileZilla 发送到服务器上。
发布项目的方式有多种,比如可以使用 dotnet publish 命令,我们这里使用 VS :
首先,我们打开 Project.json 来添加几个发布的运行时(这一步可以不要,如果不配置这里,那么发布的时候是 Any,我们待会讲到)
然后,右击我们的项目,选择发布:
新建一个发布配置文件,发布方法选择 文件系统 :
设置里,我们选择目标运行时:centos.7-x64 (在上面,我们讲到 Project.json 里添加了 几个运行时,如果没有那一步,那么这里 没有选项,只有一个 Any)
然后点击发布,我们把发布完的文件上传到CentOS上:我放到了 Wwwroot 目录下
我们来编译我们的文件:dotnet XXX.dll
这里先为大家演示一个 错误 :我的 wkmvc.dll 是在 Wwwroot 目录下的 ,所以 我执行命令(注意路径大小写,Linux区分大小写,我们上面提到) dotnet Wwwroot/wkmvc.dll
显示成功了,我们打开浏览器,输入 localhost:5000
是空白的,我们修改一下我们的程序,输出一下日志看看:
这是什么原因呢?为什么没找到Index.cshtml呢?请大家再次注意一下 我们的 Content root path,答案是 她没有对 root 的操作权限的,我们来对比一下 我们安装过程中 测试成功的 web 和 我们这个 web 的 Content root path
我们来尝试一下:我们进入Wwwroot目录下,然后执行 dotnet wkmvc.dll
我们再次打开浏览器,输入 localhost:5000
是不是 OK 了,我们来进入我们的区域的 登录页 测试一下:
也没有问题,到此,项目就运行成功了,但是在实际中,我们可能还要安装 nginx 、配置我们的 FireWall 以及配置守护服务 Supervisor 等等,这里就不演示了。
既然大家不是很了解,或者网上找资料比较繁琐,对于 nginx firewall 以及 supervisor 的配置,我就再一步一步给大家演示一下。
安装Nginx
Nginx 的安装比较简单,就三条命令:
① curl -o nginx.rpm http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release-centos-7-0.el7.ngx.noarch.rpm
② rpm -ivh nginx.rpm
③ yum install nginx
启动 Nginx:systemctl start nginx
设置开机启动(linux宕机、重启会自动运行nginx不需要连上去输入命令):systemctl enable nginx
配置防火墙
① 开放80端口:firewall-cmd --zone=public --add-port=80/tcp --permanent
② 重启防火墙以使配置即时生效:systemctl restart firewalld
我们来测试一下Nginx是否可以访问:
配置Nginx对ASP.net Core 应用的转发
修改 Nginx 的 default.conf 文件(目录:/etc/nginx/conf.d/default.conf)
将内容替换为(配置Nginx转发):
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;
}
}
上传覆盖default.conf文件
重新加载,即时生效:nginx -s reload
我们来测试一下:
这是什么鬼?这个问题是由于SELinux保护机制所导致,我们需要将nginx添加至SELinux的白名单。
我们通过命令来解决这个问题:
① yum install policycoreutils-python
② sudo cat /var/log/audit/audit.log | grep nginx | grep denied | audit2allow -M mynginx
③ sudo semodule -i mynginx.pp
我们再次尝试访问:
Supervisor 守护服务
为什么要这个玩意呢?
我们先来看下我们存在的问题:① 我们在上面演示中,运行我们的应用都是通过 dotnet ***.dll 或者 dotnet run ,也就是我们的 ASP.NET Core应用程序运行在shell之中,如果关闭shell则会发现ASP.NET Core应用被关闭,从而导
致应用无法访问。
② 如果ASP.NET Core进程意外终止那么需要人为连进shell进行再次启动。
③ 如果服务器宕机或需要重启我们则还是需要连入shell进行启动。
那么要解决这些问题,我们就必须要实现这么一个功能:如果ASP.NET Core 意外终止,那么我们要自动重启;如果服务器服务器重启后,我们要有个类似脚本命令一样,自动执行 dotnet 命令。
现在正好有个基于 Python 开发的工具 Supervisor 可以解决我们上述问题:
① 安装Supervisor:
1.1:yum install python-setuptools
1.2:easy_install supervisor
② 配置Supervisor:
mkdir /etc/supervisor
echo_supervisord_conf > /etc/supervisor/supervisord.conf
③ 配置 Supervisor 对 Asp.net Core 应用的守护:
这里有个重要说明:很多文档包括微软的官方文档都是 在/etc/supervisor 目录下 新建一个目录 conf.d 然后在conf.d 目录下新建一个conf文件,将下面这段代码放到这个文件里,然后修改 /etc/supervisor/supervisord.conf的最后一行 [include] files= relative/directory/*.ini 修改为 [include] files = /etc/supervisor/conf.d/*.conf,但是我一直没有成功,尝试了各种办法,排查了各种错误,都没有成功,所以,我直接写在了/etc/supervisor/supervisord.conf里(如下),成功了,所以,大家可以尝试以下上述。
修改 supervisord.conf 文件(目录:/etc/supervisor/supervisord.conf),添加程序:
[program:wkmvc]
command=dotnet /root/Wwwroot/wkmvc.dll
directory=/root/Wwwroot/
autostart=true
autorestart=true
stderr_logfile=/var/log/wkmvc.err.log
stdout_logfile=/var/log/wkmvc.out.log
environment=ASPNETCORE_ENVIRONMENT=Production
user=root
stopsignal=INT
如果服务已经启动,则需要使用 supervisorctl reload 命令来使新的配置生效,当然,我们这里并没有启动,所以不需要这一步。
执行:
supervisord -c /etc/supervisor/supervisord.conf
启动服务,然后我们来看下:
ps -ef | grep wkmvc
④ 配置Supervisor开机启动:
新建一个“supervisord.service”文件
# dservice for systemd (CentOS 7.0+)
# by ET-CS (https://github.com/ET-CS)
[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
将文件拷贝至:“/usr/lib/systemd/system/supervisord.service”
systemctl enable supervisord
验证一下是否为开机启动:systemctl is-enabled supervisord
希望跟大家一起学习Asp.net Core
刚开始接触,水平有限,很多东西都是自己的理解和翻阅网上大神的资料,如果有不对的地方和不理解的地方,希望大家指正!
虽然Asp.net Core 现在很火热,但是网上的很多资料都是前篇一律的复制,所以有很多问题我也暂时没有解决,希望大家能共同帮助一下!
原创文章 转载请尊重劳动成果 http://yuangang.cnblogs.com