Ubuntu 16.04+.Net Core+Docker+Nginx安装部署
前言
最近公司的项目打算移植到.Net Core平台，所以调研了一下.Net Core在Linux下的安装部署。本篇文章会一步步的描述从安装到配置到部署的全部过程。在文章的结构和内容里，笔者借鉴了很多其他博文的内容，但感觉其他博文中都只是实现了一部分或者没有将配置内容写全。笔者做的是整理一下自己的实际部署过程。
目录
步骤
1. 准备工作
- 一台Linux服务器：笔者用的是VMWare的虚拟机模拟的环境，有条件的朋友可以使用真实服务器作为部署环境
- Linux终端：笔者用的是MobaXterm
2. 创建一个非root用户
$ sudo adduser docker_user $ sudo usermod -aG sudo docker_user $ exit
3. 更新服务器
$ sudo apt-get update $ sudo apt-get upgrade $ sudo apt-get dist-upgrade $ sudo reboot
4. 安装.Net Core
我们要运行.Net Core的项目，自然要安装.Net Core的环境啦。这里微软提供了大部分Linux版本的安装方案，我使用的是Ubuntu16.04，所以以下代码是针对这个系统版本的，如果你使用的是其他版本可以参考（https://docs.microsoft.com/en-us/dotnet/core/linux-prerequisites?tabs=netcore2x）
// 注册微软产品Key为被信任的 $ curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg $ sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg // 设置所需要的版本主机包 $ sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-xenial-prod xenial main" > /etc/apt/sources.list.d/dotnetdev.list' // APT支持Https $ sudo apt-get install apt-transport-https $ sudo apt-get update // 安装.Net Core SDK $ sudo apt-get install dotnet-sdk-2.0.3 // 检查安装是否成功 $ dotnet --version
5. 创建Demo
因为是Demo项目，所以就在用户根目录下创建一个文件夹，将该文件夹作为项目的根目录。
5.1 创建项目
$ cd ~/ $ mkdir helloworld $ cd helloworld $ dotnet new mvc
5.2 发布项目
$ dotnet restore $ dotnet publish -c Release
5.3 运行发布好的程序
通过上面的截图我们发现，发布完的程序和在PC平台上的差不多，是在bin/Release的目录下。我们先移动到这个目录，然后用"dotnet"命令运行这个Demo
$ cd bin/Release/netcoreapp2.0/publish/ $ dotnet helloworld.dll
执行命令以后，终端会如上图所示。这个时候就说明程序已经跑起来了。倒数第二行则说明了，程序默认的端口号是5000。这个时候我们就可以通过服务器IP+端口号5000访问这个网站了。（注：如果是外网访问，需要在防火墙打开5000端口的权限。这个就不在本文中扩展了。）
笔者是通过开启另一个终端来测试程序是否正常的，结果如下：
// 通过wget请求网站 $ wget http://localhost:5000
6. 守护进程部署
走到这一步，有不少同学就发现了。现在的程序是需要我们始终打开终端才能保证网站可以被访问的，那接下来我们要做的就是将这个网站部署成一个自定义服务。让网站可以在后台进程中运行。
6.1 准备运行目录
按照Linux部署习惯，我们在var目录下创建一个www文件夹，并将刚才发布的Demo放到该目录下
$ cd /var $ sudo mkdir www $ cd www $ sudo mkdir helloworld $ cd helloworld $ sudo cp -r ~/helloworld/bin/Release/netcoreapp2.0/publish/* .
6.2 创建服务配置文件
$ cd /etc/systemd/system/ $ sudo touch dotnet-helloworld.service
6.3 编写服务配置文件
$ sudo vi dotnet-helloworld.service
先通过vi进入该文件（注：vi是Linux下最常用的文本编辑器之一，如果对vi不了解，可以自行百度，这里就不扩展了）。进入编辑后，将以下代码写入配置文件
[Unit] Description=DotNet Core HelloWorld Running on Ubuntu [Service] WorkingDirectory=/var/www/helloworld // 工作目录，这里我们写的是刚才创建的网站工作目录 ExecStart=/usr/bin/dotnet /var/www/helloworld/helloworld.dll // 服务的实际执行命令 Restart=always RestartSec=10 SyslogIdentifier=dotnet-example User=docker_user // 已docker_user的身份启动 Environment=ASPNETCORE_ENVIRONMENT=Production Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false [Install] WantedBy=multi-user.target
上面这段配置文件我是参考微软官方的部署文档写的（文档链接）
6.4 启动服务
$ sudo systemctl enable dotnet-helloworld.service $ sudo systemctl start dotnet-helloworld.service
6.5 检查服务状态
$ sudo systemctl status dotnet-helloworld.service
当服务启动后，运行status命令查看服务状态时，会返回服务执行的日志，终端会显示类似于下图的代码。
这段代码和我们之前直接用命令行启动dotnet项目是相似，这也就说明我们的服务部署成功了。我们再使用wget验证，同样可以访问这个网站了。
7. Nginx反向代理
做到这里，.Net Core项目的部署已经差不多了。接下来我们就通过Nginx进行反向代理。
7.1 安装Nginx
// 安装命令 $ sudo apt-get install nginx // 完成安装后检查安装是否成功 $ nginx -v
7.2 配置反向代理
// 移动到Nginx配置文件夹
$ cd /etc/nginx/conf.d/
// 创建代理配置文件
$ sudo touch helloworld.conf
// 编辑配置文件
$ sudo vi helloworld.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;
}
}
// 测试配置
$ sudo nginx -t
// 重新加载配置
$ sudo nginx -s reload
当完成这一步后，我们就可以在浏览器里直接输入服务器的IP地址来访问Demo网站了。
注：这里有一个小坑，Nginx有一个默认配置文件，文件路径在：/etc/nginx/sites-available下。文件名是default。如果访问的时候打开的不是上面这个网站，那需要到这个配置文件下，把所有的配置都注释掉，再重新reload一下Nginx。
8. 安装Docker
通过上面的教程，大家已经可以在自己电脑上访问Linux服务器上的.Net Core项目了。接下来我们将.Net Core项目放到Docker下运行，并同样通过Nginx方向代理，使我们能访问到.Net Core项目。
8.1 卸载旧版本Docker
因为Ubuntu系统可能自带Docker，所以在安装新版Docker前先将旧版的Docker清楚干净
$ sudo apt-get remove docker \ docker-engine \ docker.io
8.2 安装
$ sudo apt-get update // 由于apt源使用 HTTPS 以确保软件下载过程中不被篡改。因此，我们首先需要添加使用HTTPS 传输的软件包以及 CA 证书。 $ sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ software-properties-common // 鉴于国内网络问题，强烈建议使用国内源，官方源请在注释中查看。 // 为了确认所下载软件包的合法性，需要添加软件源的 GPG 密钥。 $ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg | sudo apt-key add - // 官方源 // $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - // 向 source.list 中添加 Docker 软件源 sudo add-apt-repository \ "deb [arch=amd64] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu \ $(lsb_release -cs) \ stable" $ sudo apt-get update // 执行安装命令 $ sudo apt-get install docker-ce
8.3 启动Docker服务
$ sudo systemctl enable docker $ sudo systemctl start docker
8.4 建立Docker用户组
默认情况下，docker命令会使用 Unix socket 与 Docker 引擎通讯。而只有 root 用户和 docker 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 root 用户。因此，更好地做法是将需要使用 docker 的用户加入 docker 用户组。
// 建立docker用户组，这行命令执行的时候可能会报该用户组已存在。如果报这个错，可以直接跳过这条命令。 $ sudo groupadd docker // 将当前用户加入docker用户组 $ sudo usermod -aG docker $USER
执行完这条命令后，退出终端重新登录一下。就可以使用docker命令来管理docker了。
8.5 镜像加速器配置
镜像（image）是docker的一个基础元素，但当我们在国内的网络环境中拉取Docker Hub（官方Docker镜像库）镜像时会变得比较困难，这时我们就可以配置镜像加速器。这里我使用的是Docker官方提供的国内加速器服务。
// docker文件夹默认是只允许root访问的。这里笔者偷个懒就直接开放docker的文件夹权限了。
sudo chmod 777 /etc/docker
cd /etc/docker
// 创建并编辑加速器源
sudo touch daemon.js
sudo vi daemon.js
// 文件内容
{
"registry-mirrors": [
"https://registry.docker-cn.com"
]
}
// 重启服务
$ sudo systemctl daemon-reload
$ sudo systemctl restart docker
9. 在Docker中部署.Net Core项目
9.1 拉取.Net Core镜像
$ sudo docker pull microsoft/dotnet
9.2 修改Demo程序
之前我们用的是默认的Demo程序运行，程序是运行在5000端口上的，在我们的实际环境中，不可能每个服务都用同一个端口号，所以这次我们将端口好做一个小变动。
// 移动到最开始我们创建的Demo中。编辑Program.cs // $ cd ~/helloworld // $ vi Program.cs
内容为
namespace helloworld
{
public class Program
{
public static void Main(string[] args)
{
BuildWebHost(args).Run();
}
public static IWebHost BuildWebHost(string[] args) =>
WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>()
.UseUrls("http://*:10001") // 使用10001作为程序运行时端口
.Build();
}
}
完成之后，我们重新发布
$ dotnet restore $ dotnet publish -c Release
9.3 编写Dockerfile
// 移动到发布目录 $ cd ~/helloworld/bin/Release/netcoreapp2.0/publish/// 创建Dockerfile $ sudo touch Dockerfile // 编辑Dockerfile $ sudo vi Dockerfile
以下是Dockerfile的内容
// 基于.Net Core镜像来构建我们的镜像 FROM microsoft/dotnet // 将程序复制到镜像中的publish目录 COPY . /publish // 定义工作目录为publish WORKDIR /publish // 设置Docker容器对外暴露的端口 EXPOSE 10001 // 执行dotnet命令 CMD ["dotnet", "helloworld.dll"]
9.4 构建Docker镜像
$ docker build -t helloworld:1.0 .
注意最后有一个"."
9.5 运行构建的镜像
$ docker run --name helloworld -d -p 10001:10001 helloworld:1.0
9.6 修改Nginx配置
在本文前半段，我们让Nginx代理了5000端口，现在我们把他改为10001。
// 编辑之前创建的Nginx配置
$ cd /etc/nginx/conf.d/
$ vi helloworld.conf
// 只需要修改代理的端口就行
server {
listen 80;
location / {
proxy_pass http://localhost:10001;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection keep-alive;
proxy_set_header Host $http_host;
proxy_cache_bypass $http_upgrade;
}
}
// 重载Nginx
$ sudo nginx -t
$ sudo nginx -reload
好了。大功告成，我们现在又可以在浏览器中用服务器IP直接访问到Demo网站了。
总结
这次学习的过程，总共花了大概两天时间，反反复复看了很多其他的教程。但大部分教程都感觉要么没说清楚，要么就是缺少某个步骤而导致最后运行不起来，所以在完成配置以后，决定写下这篇文章，算是给自己一个交代。也希望可以帮到各位看客。
- Ubuntu 16.04安装使用Docker - mickjoust 的 技术小屋 - 博客频道 - CSDN.NET
- Docker在Ubuntu16.04上安装和部署Apache Storm
- ubuntu16.04 docker环境安装部署
- ASP.NET Core 2.0 MVC 发布部署--------- Ubuntun 16.04 X64 具体操作
- Ubuntu16.04 部署安装Docker容器 & 注意事项
- ASP.NET Core部署前期准备 使用Hyper-V安装Ubuntu Server 16.10
- Ubuntu & GitLab CI & Docker & ASP.NET Core 2.0 自动化发布和部署（2）
- ASP.NET Core Docker jexus nginx部署-CentOS实践版
- Ubuntu 16.04 离线安装 .net core SDK
- Ubuntu & GitLab CI & Docker & ASP.NET Core 2.0 自动化发布和部署（1）
- Ubuntu 17.04 x64 安装 Docker CE 初窥 Dockerfile 部署 Nginx
- ubuntu16.04 docker环境安装部署
- 5.Ubuntu16.04Docker部署nginx实现静态网站
- Ubuntu 17.04 x64 安装 Docker CE 初窥 Dockerfile 部署 Nginx
- nginx + docker 部署react or vue 前端项目(ubuntu16.04)
- Ubuntu & GitLab CI & Docker & ASP.NET Core 2.0 自动化发布和部署（1）
- Ubuntu16.04安装docker
- ASP.NET Core Docker jexus部署-CentOS实践版
- Centos7 & Docker & Jenkins & ASP.NET Core 2.0 自动化发布和部署