按部就班学.Net Core Web Api开发系列【7】：项目发布到CentOS7

系列目录

按部就班学.Net Core Web Api开发系列目录

 本系列涉及到的源码下载地址：https://github.com/seabluescn/Blog_WebApi

 

1、概述

本篇讨论如何把项目发布到Linux环境，主要包括如下内容：

一、项目打包

二、配置Nginx转发

三、配置守护服务Supervisor

在介绍实际内容前，有两个疑问须要探讨一下：

一、咱们的项目发布后能够自宿主运行，为何要配置nginx转发？

答：nginx是专业的网络服务器，功能强大，能够帮忙处理静态资源、SSL等。（简单来讲就是Kestrel没有nginx、IIS等专业）

官方解释：Kestrel is great for serving dynamic content from ASP.NET Core. However, the web serving capabilities aren't as feature rich as servers such as IIS, Apache, or Nginx. A reverse proxy server can offload work such as serving static content, caching requests, compressing requests, and SSL termination from the HTTP server. A reverse proxy server may reside on a dedicated machine or may be deployed alongside an HTTP server.

二、为何要配置守护服务？

答：这个问题比较简单，咱们的程序可能没有那么健壮，若是进程意外终止了，守护进程能够自动从新启动进程。

 

2、打包与发布

CentOS环境下安装 dotNet Core SDK的过程，请参考本系列第一篇：按部就班学.Net Core Web Api开发系列【1】：开发环境

利用VS 2017发布项目很是简单，执行发布命令便可。须要注意的是saleservice.xml文件不会被发布，须要手动拷贝到发布目录，有个简单的办法，我把发布的路径从PublishhOutput 改为bin\Release\netcoreapp2.0\，Release模式编译一下再发布就能够，不过这不是什么大问题。

将发布目录copy到目标服务器，运行如下代码启动程序：

# dotnet SaleService.dll

经过运行   # curl http://localhost:5000/api/products   能够查看程序是否运行成功。

因为系统默认监听localhost:5000这个地址，因此即便防火墙开通了5000端口，外部也是没法经过IP来访问的。须要增长如下代码来处理：

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .UseUrls("http://*:5000")
                .Build();

固然，若是咱们要经过nginx代理访问项目，并不会经过服务器IP来访问，上面步骤就不须要。

在调试项目时，咱们在launchSettings.json中设置了启动页面，但项目部署后，这个配置不会有效果，若是但愿输入 http://localhost:5000 就跳转到指定页面，须要作以下处理：

修改app.UseMvcWithDefaultRoute()

//app.UseMvcWithDefaultRoute();            
app.UseMvc(routes => routes.MapRoute(name: "default", template: "{controller=Account}/{action=Index}/{id?}"));　

增长一个Controller

public class AccountController : Controller
    {
        
        public ActionResult Index()
        {
            return Redirect("/index.html");
        }
 }

 

3、配置Nginx代理

一、安装

# rpm -Uvh http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release-centos-7-0.el7.ngx.noarch.rpm
# yum install nginx

 

二、配置

运行命令：

#vi /etc/nginx/conf.d/default.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;
    }
}

重启nginx和项目。

此时应该能够经过 http://192.168.0.110/api/product 来访问项目，实际访问时，页面报错：

这个问题是因为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

 若是经过localhost能够访问，经过IP访问报404错误，请注意确认防火墙是否打开。

 

4、跨域访问的问题

跨域是指从一个域名的网页去请求另外一个域名的资源，跨域的严格一点的定义是：只要 协议，域名，端口有任何一个的不一样，就被看成是跨域。
在前端的Ajax代码中咱们把localhost改为了服务器的IP：

 $("#query").click(function (event) {
                $.getJSON("http://192.168.109.131/api/products",
                    function (result) {
                        });
                    });
         

此时原来正常的程序会报错：No 'Access-Control-Allow-Origin' header is present on the requested resource

处理办法：

 public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc();
            services.AddCors();      
        }

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        { 
            app.UseCors(builder => builder.AllowAnyOrigin().AllowAnyMethod().AllowAnyHeader().AllowCredentials());
           
            app.UseMvcWithDefaultRoute();
            app.UseStaticFiles();
        }

其中services.AddCors()能够不用加，WebHost.CreateDefaultBuilder已经加了。

 

5、配置守护进程

一、 安装Supervisor

# yum install python-setuptools
# easy_install supervisor

　　

二、 配置Supervisor

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

 在文件底部增长：

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

 在/etc/supervisor建一个conf.d的文件夹，在其下新建一个saleservice.ini文件，内容以下：

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

　　

启动supervisor

supervisord -c /etc/supervisor/supervisord.conf

 关闭与重启：

关闭：supervisorctl shutdown
重启：supervisorctl reload

　　

验证咱们的项目是否启动成功

ps -ef | grep SaleService

　　

三、 配置supervisord为服务
在/usr/lib/systemd/system文件夹下新建文件：supervisord.service

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

内容以下：

[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 start supervisord
# systemctl stop supervisord

设置自动启动supervisord
# systemctl enable supervisord

验证是否为开机启动：
# systemctl is-enabled supervisord

　　

把ngnix也设置为开机自启动，而后重启系统看是否成功。