前言
平日在公司里都是基於阿里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
有些文本描述和圖片源自網絡，如有侵犯請私信告知