Ubuntu 16.04+.Net Core+Docker+Nginx安装部署
前言
最近公司的項目打算移植到.Net Core平臺，所以調(diào)研了一下.Net Core在Linux下的安裝部署。本篇文章會一步步的描述從安裝到配置到部署的全部過程。在文章的結(jié)構(gòu)和內(nèi)容里，筆者借鑒了很多其他博文的內(nèi)容，但感覺其他博文中都只是實現(xiàn)了一部分或者沒有將配置內(nèi)容寫全。筆者做的是整理一下自己的實際部署過程。
目錄
1. 準(zhǔn)備工作
2.?創(chuàng)建一個非root用戶
3. 更新服務(wù)器
4. 安裝.Net Core
5. 創(chuàng)建Demo
6. 守護(hù)進(jìn)程部署
7. Nginx反向代理
8. 安裝Docker
9. 在Docker中部署.Net Core項目
步驟
1. 準(zhǔn)備工作
一臺Linux服務(wù)器：筆者用的是VMWare的虛擬機模擬的環(huán)境，有條件的朋友可以使用真實服務(wù)器作為部署環(huán)境
Linux終端：筆者用的是MobaXterm
2. 創(chuàng)建一個非root用戶
$ sudo adduser docker_user $ sudo usermod -aG sudo docker_user $ exit
3. 更新服務(wù)器
?
4. 安裝.Net Core
我們要運行.Net Core的項目，自然要安裝.Net Core的環(huán)境啦。這里微軟提供了大部分Linux版本的安裝方案，我使用的是Ubuntu16.04，所以以下代碼是針對這個系統(tǒng)版本的，如果你使用的是其他版本可以參考（https://docs.microsoft.com/en-us/dotnet/core/linux-prerequisites?tabs=netcore2x）
// 注冊微軟產(chǎn)品Key為被信任的
$ curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
$ sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg
// 設(shè)置所需要的版本主機包
$ 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. 創(chuàng)建Demo
因為是Demo項目，所以就在用戶根目錄下創(chuàng)建一個文件夾，將該文件夾作為項目的根目錄。
5.1 創(chuàng)建項目
$ cd ~/$ mkdir helloworld $ cd helloworld $ dotnet new mvc5.2 發(fā)布項目
$ dotnet restore $ dotnet publish -c Release5.3 運行發(fā)布好的程序
通過上面的截圖我們發(fā)現(xiàn)，發(fā)布完的程序和在PC平臺上的差不多，是在bin/Release的目錄下。我們先移動到這個目錄，然后用"dotnet"命令運行這個Demo
$ cd bin/Release/netcoreapp2.0/publish/$ dotnet helloworld.dll執(zhí)行命令以后，終端會如上圖所示。這個時候就說明程序已經(jīng)跑起來了。倒數(shù)第二行則說明了，程序默認(rèn)的端口號是5000。這個時候我們就可以通過服務(wù)器IP+端口號5000訪問這個網(wǎng)站了。（注：如果是外網(wǎng)訪問，需要在防火墻打開5000端口的權(quán)限。這個就不在本文中擴展了。）
筆者是通過開啟另一個終端來測試程序是否正常的，結(jié)果如下：
// 通過wget請求網(wǎng)站$ wget http://localhost:50006. 守護(hù)進(jìn)程部署
走到這一步，有不少同學(xué)就發(fā)現(xiàn)了。現(xiàn)在的程序是需要我們始終打開終端才能保證網(wǎng)站可以被訪問的，那接下來我們要做的就是將這個網(wǎng)站部署成一個自定義服務(wù)。讓網(wǎng)站可以在后臺進(jìn)程中運行。
6.1 準(zhǔn)備運行目錄
按照Linux部署習(xí)慣，我們在var目錄下創(chuàng)建一個www文件夾，并將剛才發(fā)布的Demo放到該目錄下
$ cd /var
$ sudo mkdir www
$ cd www
$ sudo mkdir helloworld
$ cd helloworld
$ sudo cp -r ~/helloworld/bin/Release/netcoreapp2.0/publish/* .
6.2 創(chuàng)建服務(wù)配置文件
$ cd /etc/systemd/system/$ sudo touch dotnet-helloworld.service6.3 編寫服務(wù)配置文件
$ sudo vi dotnet-helloworld.service先通過vi進(jìn)入該文件（注：vi是Linux下最常用的文本編輯器之一，如果對vi不了解，可以自行百度，這里就不擴展了）。進(jìn)入編輯后，將以下代碼寫入配置文件
[Unit]
Description=DotNet Core HelloWorld Running on Ubuntu
[Service]
WorkingDirectory=/var/www/helloworld? ? ? ? ? ? ? ? ? ? ? ? ? ? ?// 工作目錄，這里我們寫的是剛才創(chuàng)建的網(wǎng)站工作目錄
ExecStart=/usr/bin/dotnet /var/www/helloworld/helloworld.dll? ? ?// 服務(wù)的實際執(zhí)行命令
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 啟動服務(wù)
$ sudo systemctl enable dotnet-helloworld.service $ sudo systemctl start dotnet-helloworld.service6.5 檢查服務(wù)狀態(tài)
$ sudo systemctl status dotnet-helloworld.service當(dāng)服務(wù)啟動后，運行status命令查看服務(wù)狀態(tài)時，會返回服務(wù)執(zhí)行的日志，終端會顯示類似于下圖的代碼。
這段代碼和我們之前直接用命令行啟動dotnet項目是相似，這也就說明我們的服務(wù)部署成功了。我們再使用wget驗證，同樣可以訪問這個網(wǎng)站了。
7. Nginx反向代理
做到這里，.Net Core項目的部署已經(jīng)差不多了。接下來我們就通過Nginx進(jìn)行反向代理。
7.1 安裝Nginx
// 安裝命令$ sudo apt-get install nginx// 完成安裝后檢查安裝是否成功$ nginx -v7.2 配置反向代理
// 移動到Nginx配置文件夾
$ cd /etc/nginx/conf.d/
// 創(chuàng)建代理配置文件
$ sudo touch helloworld.conf
// 編輯配置文件
$ sudo vi helloworld.conf
// 配置內(nèi)容
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
當(dāng)完成這一步后，我們就可以在瀏覽器里直接輸入服務(wù)器的IP地址來訪問Demo網(wǎng)站了。
注：這里有一個小坑，Nginx有一個默認(rèn)配置文件，文件路徑在：/etc/nginx/sites-available下。文件名是default。如果訪問的時候打開的不是上面這個網(wǎng)站，那需要到這個配置文件下，把所有的配置都注釋掉，再重新reload一下Nginx。
?
8. 安裝Docker
通過上面的教程，大家已經(jīng)可以在自己電腦上訪問Linux服務(wù)器上的.Net Core項目了。接下來我們將.Net Core項目放到Docker下運行，并同樣通過Nginx方向代理，使我們能訪問到.Net Core項目。
8.1 卸載舊版本Docker
因為Ubuntu系統(tǒng)可能自帶Docker，所以在安裝新版Docker前先將舊版的Docker清楚干凈
$ sudo apt-get remove docker \ docker-engine \ docker.io8.2 安裝
$ sudo apt-get update
// 由于apt源使用 HTTPS 以確保軟件下載過程中不被篡改。因此，我們首先需要添加使用HTTPS 傳輸?shù)能浖约?CA 證書。
$ sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
software-properties-common
// 鑒于國內(nèi)網(wǎng)絡(luò)問題，強烈建議使用國內(nèi)源，官方源請在注釋中查看。
// 為了確認(rèn)所下載軟件包的合法性，需要添加軟件源的? 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
// 執(zhí)行安裝命令
$ sudo apt-get install docker-ce
8.3 啟動Docker服務(wù)
$ sudo systemctl enable docker $ sudo systemctl start docker8.4 建立Docker用戶組
默認(rèn)情況下，docker命令會使用 Unix socket 與 Docker 引擎通訊。而只有 root 用戶和 docker 組的用戶才可以訪問 Docker 引擎的 Unix socket。出于安全考慮，一般 Linux 系統(tǒng)上不會直接使用 root 用戶。因此，更好地做法是將需要使用 docker 的用戶加入 docker 用戶組。
?
// 建立docker用戶組，這行命令執(zhí)行的時候可能會報該用戶組已存在。如果報這個錯，可以直接跳過這條命令。$ sudo groupadd docker// 將當(dāng)前用戶加入docker用戶組$ sudo usermod -aG docker $USER?
執(zhí)行完這條命令后，退出終端重新登錄一下。就可以使用docker命令來管理docker了。
8.5 鏡像加速器配置
鏡像（image）是docker的一個基礎(chǔ)元素，但當(dāng)我們在國內(nèi)的網(wǎng)絡(luò)環(huán)境中拉取Docker Hub（官方Docker鏡像庫）鏡像時會變得比較困難，這時我們就可以配置鏡像加速器。這里我使用的是Docker官方提供的國內(nèi)加速器服務(wù)。
// docker文件夾默認(rèn)是只允許root訪問的。這里筆者偷個懶就直接開放docker的文件夾權(quán)限了。
sudo chmod 777 /etc/docker
cd /etc/docker
// 創(chuàng)建并編輯加速器源
sudo touch daemon.js
sudo vi daemon.js
// 文件內(nèi)容
{
? ? "registry-mirrors": [
? ? ? ? "https://registry.docker-cn.com"
? ? ]
}
// 重啟服務(wù)
$ sudo systemctl daemon-reload
$ sudo systemctl restart docker
9. 在Docker中部署.Net Core項目
9.1 拉取.Net Core鏡像
$ sudo docker pull microsoft/dotnet9.2 修改Demo程序
之前我們用的是默認(rèn)的Demo程序運行，程序是運行在5000端口上的，在我們的實際環(huán)境中，不可能每個服務(wù)都用同一個端口號，所以這次我們將端口好做一個小變動。
// 移動到最開始我們創(chuàng)建的Demo中。編輯Program.cs// $ cd ~/helloworld// $ vi Program.cs內(nèi)容為
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();
? ? }
}
完成之后，我們重新發(fā)布
$ dotnet restore $ dotnet publish -c Release9.3 編寫Dockerfile
// 移動到發(fā)布目錄
$ cd ~/helloworld/bin/Release/netcoreapp2.0/publish/// 創(chuàng)建Dockerfile
$ sudo touch Dockerfile
// 編輯Dockerfile
$ sudo vi Dockerfile
以下是Dockerfile的內(nèi)容
// 基于.Net Core鏡像來構(gòu)建我們的鏡像
FROM microsoft/dotnet
// 將程序復(fù)制到鏡像中的publish目錄
COPY . /publish
// 定義工作目錄為publish
WORKDIR /publish
// 設(shè)置Docker容器對外暴露的端口
EXPOSE 10001
// 執(zhí)行dotnet命令
CMD ["dotnet", "helloworld.dll"]
9.4 構(gòu)建Docker鏡像
$ docker build -t helloworld:1.0 .注意最后有一個"."
?
9.5 運行構(gòu)建的鏡像
$ docker run --name helloworld -d -p 10001:10001 helloworld:1.0?
?
9.6 修改Nginx配置
在本文前半段，我們讓Nginx代理了5000端口，現(xiàn)在我們把他改為10001。
// 編輯之前創(chuàng)建的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
好了。大功告成，我們現(xiàn)在又可以在瀏覽器中用服務(wù)器IP直接訪問到Demo網(wǎng)站了。
總結(jié)
這次學(xué)習(xí)的過程，總共花了大概兩天時間，反反復(fù)復(fù)看了很多其他的教程。但大部分教程都感覺要么沒說清楚，要么就是缺少某個步驟而導(dǎo)致最后運行不起來，所以在完成配置以后，決定寫下這篇文章，算是給自己一個交代。也希望可以幫到各位看客。
原文：http://www.cnblogs.com/noahji/p/8947151.html
.NET社區(qū)新聞，深度好文，歡迎訪問公眾號文章匯總 http://www.csharpkit.com
總結(jié)
以上是生活随笔為你收集整理的Ubuntu 16.04+.Net Core+Docker+Nginx安装部署的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 使用ILSpy探索C#7.0新增功能点
- 下一篇： Docker最全教程之Ubuntu下安装