详解ASP.NET Core部署项目到Ubuntu Server


            基于上一篇成功安装Ubuntu Server 16.10的基础上，接下来继续我们ASP.NET Core项目的部署之旅！

只是对于这些年整天和Windows打交道的我，初次使用Linux确实有点费劲。

但是为了.NET Core跨平台的这一重大特性，即使再多的坑，也还是要硬着头皮上的。

不然会有人怀着诧异的眼神问你：你的.NET Core项目还部署到Windows上？

废话不多说，预祝你在十步之内成功部署！<(￣︶￣)↗[GO!]

一、安装.NET Core SDK

依次输入以下命令即可完成安装，如果中间有失败的，请多尝试几次。





sudo sh -c 'echo "deb [arch=amd64] http://apt-mo.trafficmanager.net/repos/dotnet-release/ yakkety main" > /etc/apt/sources.list.d/dotnetdev.list'



sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 417A0893



sudo apt-get update



sudo apt-get install dotnet-dev-1.0.1



安装好之后试着执行一下dotnet命令，出现以下内容，说明你已经安装成功，恭喜！



二、小试牛刀

1、创建一个文件夹，命名为test，然后切换之





mkdir test



cd test



2、初始化一下CLI配置





dotnet new





3、创建一个MVC项目





dotnet new mvc



4、构建该项目并运行





dotnet restore



dotnet run





5、如果能监听成功，说明没问题。接下来进入Program.cs文件，并修改成如下内容，在80端口监听所有的网络适配器

1）、vi Program.cs //打开Program.cs文件



2）、i //进入编辑模式



3）、Esc键退出编辑模式



4）、：wq //保存并退出



6、安装反向代理nginx，并启动之，当然了，apache也是未尝不可的。





sudo apt-get install nginx



sudo service ngnix start



然后访问一下服务器的地址，如果出现如下页面，说明已经安装成功



7、安装好之后进入到以下目录，打开default文件并修改为以下的内容





cd /etc/nginx/sites-available



sudo vim default





顺便记录几个常用的编辑命令





vim Program.cs //打开或新建Program.cs文件



i //进入编辑模式



Esc键 //退出编辑模式



yy //复制光标所在行



5yy //复制光标起后5行



p //粘贴



dd //删除光标所在行



5dd //删除光标起后5行



u  //撤销操作



:q! //不保存并退出



:wq //保存并退出



8、重新启动Nginx来应用配置





sudo nginx -t



sudo nginx -s reload



9、接下来就是见证奇迹的时刻。重新运行我们刚才的test项目，然后打开本机浏览器，输入：http://192.168.1.104（如果不知道自己ubuntu服务器地址的，输入ifconfig命令进行查看）访问，如果出现如下画面，说明配置已经成功。服务器已经不再是IIS，取而代之的是ubuntu上的nginx，版本为1.10.1



Tips：如果不成功的话，不要灰心！试着用以下命令更新一下系统，或者卸载nginx然后重新再来一次，相信曙光就要到来！





sudo apt-get update

sudo apt-get upgrade

sudo apt-get dist-upgrade

sudo reboot



三、配置守护进程Supervisor

到目前位置，应用程序还是我们自己手动运行起来的，而且还不能Ctrl+C关闭并退出，否则你的网站将无法访问！所以我们需要有一个类似监视器的角色来保证ASP.NET Core进程的正常运行，那么Supervisor会是我们的首选。

1、安装supervisor





sudo apt-get install supervisor



2、发布上面mvc的test项目，记录下你的发布路径





dotnet publish





3、发布成功之后记得切换到发布目录执行下dotnet运行命令，然后重复上面的步骤9看下是否可以正常访问，没问题的话我们进行下一步



4、切换到var路径，创建一个netcore文件夹，再在其下创建一个test-publish文件夹，然后将上面发布后的所有文件拷贝到这里





cd /var



sudo mkdir netcore



cd netcore



sudo mkdir test-publish



cd test-publish



sudo cp -a /home/jack/test/bin/Debug/netcoreapp1.1/publish/* /var/netcore/test-publish



ls





5、创建test.conf的supervisor配置文件，并将以下内容添加进去(一定要仔细不要手抖写错了)





cd /etc/supervisor/conf.d



sudo vim test.conf





6、重新启动supervisor来应用配置！然后试着用本机访问下ubuntu server的IP，看下网站是否如你所愿的展示在了你的面前！如果和上面的步骤9一致，那么整个部署流程已经暂时告一段落，这样一来即使你重启了服务器，网站依旧可以访问。到这里我终于算是松了一口气。





sudo service supervisor restart



四、进阶

接下来我就把我之前在IIS上搭好的项目：“ASP.NET Core：使用Dapper和SwaggerUI来丰富你的系统框架”也部署到Ubuntu Server上去，其中需要准备一个远程登录工具：Putty，用来将我们本机的发布文件传输到服务器上，同时你还可以像在Ubuntu中一样进行一些命令操作。



1、在Ubuntu Server上安装OpenSSH Server并启动该SSH服务（默认端口22即可）





sudo apt-get install openssh-server



sudo /etc/init.d/ssh start



2、启用防火墙配置ufw（默认是待用的，同时也是为了安全），然后打开SSH服务的22端口。





sudo ufw default deny



sudo ufw enable



sudo ufw allow ssh





注：第一条命令表示所有端口默认关闭，除非被指定打开。至于红框内的，就不用我过多解释了吧（笑而不语~）。

3、打开Putty，输入Ubuntu Server的IP地址，端口为22，连接类型为SSH，你可以把这个配置保存下来，命名为：ubuntu即可，下次直接双击打开就行了，挺方便的。



4、出现下面这个提示时，选择“是”即可



5、然后输入服务器的用户名和密码进行登录，如果没问题，你会看到如下画面



5、小试牛刀：打开windows的命令提示窗口，输入以下命令，表示复制一个test.txt（E盘下）文件到ubuntu服务器上test文件夹下





pscp test.txt jack@192.168.1.105:test





随后切换至Putty上进行查看



6、重新发布我们的项目，指定runtime为ubuntu.16.10-x64，如需更多，请点击这里进行查看。

复制代码 代码如下:dotnet publish --framework netcoreapp1.1 --runtime ubuntu.16.10-x64 --output "E:\Publish\Light.Api-Ubuntu" --configuration Release



但是不幸的是出现了一个大大的报错：“project.assets.json don't have a target for ‘.NETCoreApp,Version=v1.1/ubuntu.16.10-x64'”，网上一查，发现是项目文件csproj中没有此依赖，添加之后重新运行发布命令，如果出现最后一个画面，说明你就成功了！





<RuntimeIdentifiers>ubuntu.16.10-x64</RuntimeIdentifiers>







同时将我们的监听端口设置为6000，否则的话将无法启动，因为5000端口已经被测试项目test占用了。而其中的UseIISIntegration方法可以拿掉，因为我们是要发布到Ubuntu服务器上，用不着IIS，但是这样的话你的本机也将会无法访问。



7、到了最重要的一环：使用PSFTP，主要命令为open和put，将我们刚才发布的Light.Api项目Copy到Light.Api-Publish下，你会看到很多的复制记录



8、复制完成之后，切换到服务器的该目录下，如果能启动，说明没问题



9、接下来就不用多说了，Ctrl+Art+F2切换到第二个管理页面，把nginx的监听端口改成6000并重启nginx



10、屏住呼吸，在本机浏览器中输入服务器地址：“http://192.168.1.105/swagger/ui”，如果可以正常访问，并且可以请求到数据，说明你已经成功了！如果发现服务器不可用的话，多半是本机开启了防火墙，连接不到数据库导致的，因为这时你ping主机也是ping不通的，只需到控制面板中关闭防火墙即可！最后的效果图，nginx on ubuntu就是强有力的证明



四、写在最后

可能细心的人儿已经发现我其实还有最后一步Light.Api的守护进程没有配置，所以就最后就留给大家来搞定吧。我不会告诉你只需要参照着上面的步骤5即可！希望这篇文章可以帮到那些刚接触到ASP.NET Core在Linux中部署的同学们，如果对文章有疑问或者不清晰的，欢迎讨论。也希望大家多多支持中文源码网。