前言
平日在公司裡都是基於阿里Teambition中的飛流進行Docker部署Api專案或服務，已經習慣了那一套成熟的操作流程，開發和部署確實快捷方便，但是還沒在自己的電腦上進行操作過，特別是Windows10開始已經有WSL、WSL2
去年在筆記本上搗鼓過WSL2，但也只是開啟安裝完後打了下幾行命令嚐個鮮，沒有進行過後續跟開發有關的操作
前兩天把家裡電腦系統升級到Windows 11，新系統感覺良好，抽空再次嘗試下WSL2，順便記錄下完整的專案部署流程
WSL
WSL：適用於 Linux 的 Windows 子系統。
- 什麼是適用於 Linux 的 Windows 子系統？
適用於 Linux 的 Windows 子系統可讓開發人員按原樣執行 GNU/Linux 環境 - 包括大多數命令列工具、實用工具和應用程式 - 且不會產生虛擬機器開銷。
- 什麼是 WSL 2？
WSL 2 是適用於 Linux 的 Windows 子系統體系結構的一個新版本，它支援適用於 Linux 的 Windows 子系統在 Windows 上執行 ELF64 Linux 二進位制檔案。 它的主要目標是提高檔案系統效能，以及新增完全的系統呼叫相容性。
- WSL 2 和 WSL 1 的區別？
安裝WSL 2
WSL官方教程：https://docs.microsoft.com/zh-cn/windows/wsl/install-win10
Hyper-V說明：https://docs.microsoft.com/zh-cn/virtualization/hyper-v-on-windows/about/
- 首先要去 控制皮膚 -> 程式和功能 -> 啟用或關閉Windows功能 -> 開啟 Hyper-V 、適用於Lindex的Windows子系統、虛擬機器平臺（僅用WSL 1無需這個） ，設定成功後需要重啟系統
- 開啟Windows Terminal (支援多命令視窗的終端工具，Windows11已自帶，之前版本需要去應用商品下載安裝) 或者 CMD 或者 PowerShell，輸入以下程式碼可檢視當前已註冊的Linux分發版本
wsl -l
注意：上面截圖裡是我已安裝完Ubuntu和Docker的結果，如果第一次安裝，只有一個預設Linux - 安裝完成預設架構是WSL 1，需要手動切換到WSL 2，在這之前需要先下載安裝Linux的核心更新包
點選下載Linux核心更新包
安裝完畢之後執行下面命令，切換到WSL 2
wsl --set-default-version 2
安裝Ubuntu
- 開啟Windows應用商城，搜尋Ubuntu，並選擇一個版本進行安裝
- 安裝完成後，點選啟動Ubuntu，會提示需要設定使用者名稱和密碼
（網上截圖） - 設定Ubuntu為WSL預設系統，WSL 版本號為2（這裡以Ubuntu 20.04為例）
wsl --set-version Ubuntu-20.04 2
- 在Windows Terminal 下會多一個Ubuntu的命令列選項
安裝Docker
Windows環境下可以去Docker官方下載Docker Desktop進行安裝，最新版本已經支援使用WSL2執行，也可以在Ubuntu下以Linux傳統方式安裝Docker（自行某度）
遷移Docker映象預設儲存路徑（如果你的C盤很大，可跳過這步）
Docker的映象預設儲存路徑在：C:\Users\你的使用者名稱\AppData\Local\Docker\wsl\data 長期使用映象多了，C盤就會吃緊了，可以遷移目錄到其他盤
- 關閉Docker
- 關閉所有發行版Linux
wsl --shutdown
- 將docker-desktop-data匯出到指定目錄下 D:\Docker\wsl\data\docker-desktop-data.tar（注意，原有的docker images不會一起匯出）
wsl --export docker-desktop-data D:\Docker\wsl\data\docker-desktop-data.tar
- 登出docker-desktop-data
wsl --unregister docker-desktop-data
- 重新匯入docker-desktop-data到要存放的資料夾：D:\Docker\wsl\data\
wsl --import docker-desktop-data D:\Docker\wsl\data\ D:\Docker\wsl\data\docker-desktop-data.tar --version 2
#引數說明
-version 2 ： 指定WSL版本為2 - 重啟Docker
- 如果重啟Docker出現報錯：Failed to set version to docker-desktop: exit code: -1
需要開啟cmd執行以下命令，執行完畢後需要重啟電腦
netsh winsock reset
報錯原因：https://zhuanlan.zhihu.com/p/151392411
如果重啟後映象預設路徑又會恢復到原路徑，需要重新弄一遍上面所有步驟，囧
在Docker中安裝Nginx、MySQL等（沒用到，可跳過這步）
直接在Ubuntu的命令下使用docker命令安裝元件
- Nginx
docker pull nginx --拉取Nginx最新映象 #此處省略拉取映象過程中的幾十行命令 #.... #....
docker run --name nginx-local -p 8080:80 -d nginx --啟動Nginx容器 #引數說明 --name nginx-local：設定容器名稱 -p 8080:80：埠進行對映，將本地 8080 埠對映到容器內部的 80 埠 -d：設定容器在在後臺一直執行 nginx：映象名或標籤名瀏覽器中輸入 http://localhost:8080
- MySQL
docker pull mysql --拉取MySQL最新映象 #此處省略拉取映象過程中的幾十行命令 #.... #....
docker run --name mysql-local -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 -d mysql
#引數說明 --name mysql-local：設定容器名稱 -p 3306:3306：埠進行對映，將本地 3306埠對映到容器內部的 3306 埠
-e MYSQL_ROOT_PASSWORD=123456 ：設定mysql的登入密碼，預設帳號名為root -d：設定容器在在後臺一直執行 mysql：映象名或標籤名
測試連線MySQL
- Docker Desktop 中同步顯示映象
新建Asp.Net Core專案
- 在專案中新增健康檢查元件
Install-Package Microsoft.Extensions.Diagnostics.HealthChecks
- 在Startup.cs檔案中新增註冊程式碼
public void ConfigureServices(IServiceCollection services) { services.AddHealthChecks(); } public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { app.UseHealthChecks("/health"); }
- 在控制器中隨便寫一個Action方法
- 通過VS執行專案，測試健康檢查和Action
生成Dockerfile檔案
- VS很早就支援快速生成Dockerfile，在專案的右鍵中，新增Docker支援，選擇Linux即可
- 編輯Dockerfile新增時區，當然也可以什麼都不動，直接進行下一步
RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime RUN echo 'Asia/Shanghai' >/etc/timezone
- 在VS中開啟終端，也可以手動開啟命令列終端工具cd到專案解決方案根目錄下
注意：命令列開啟必須是定位在解決方案根目錄下，這麼做是因為專案複雜以後專案之間會相互引用，而Dockefile檔案自動生成出來的csproj引用路徑預設是以解決方案根目錄為準，除非你手動修改了Dockerfile中csproj的檔案路徑
- 在命令列中輸入docker build命令，構建映象
docker build -f DockerApi/Dockerfile -t docker-api . --注意結尾最後還有個點
#此處省略構建映象過程中的幾十行命令
#....
#....#引數說明 -f DockerApi/Dockerfile ： 指定Dockerfile檔案路徑，如果Dockerfile已經在當前定位的目錄下就不用特別指定了 -t docker-api : 設定映象標籤為docker-api，標籤名自定義 . ：構建映象的上下文路徑
#構建完成後檢視映象
docker images
- 啟動容器
docker run --name docker-api -it -p 5000:80 docker-api
#引數說明 --name docker-api ：設定容器名稱 -it ：i-互動式操作，t-終端 -p 5000:80 ：埠進行對映，將本地5000埠對映到容器內部的80埠 docker-api ：映象名或標籤名
- 開啟瀏覽器輸入
http://localhost:5000/health
http://localhost:5000/api/demo/get
- 大功告成！檢視Docker Desktop，同步顯示所有容器
以上就是Docker上部署Asp.Net Core的所有實操步驟，如果按教程一步步來，應該是沒有多大問題的
作者：Harry
原文出處：https://www.cnblogs.com/simendancer/articles/14967916.html
有些文字描述和圖片源自網路，如有侵犯請私信告知