从零实操基于WSL2 Docker部署Asp.Net Core项目
前言
平日在公司里都是基于阿里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分發版本
?
注意：上面截圖里是我已安裝完Ubuntu和Docker的結果，如果第一次安裝，只有一個默認Linux
安裝完成默認架構是WSL 1，需要手動切換到WSL 2，在這之前需要先下載安裝Linux的內核更新包
點擊下載Linux內核更新包
安裝完畢之后執行下面命令，切換到WSL 2
?
安裝Ubuntu
打開Windows應用商城，搜索Ubuntu，并選擇一個版本進行安裝
安裝完成后，點擊啟動Ubuntu，會提示需要設置用戶名和密碼
（網上截圖）
設置Ubuntu為WSL默認系統，WSL 版本號為2（這里以Ubuntu 20.04為例）
在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
將docker-desktop-data導出到指定目錄下 D:\Docker\wsl\data\docker-desktop-data.tar（注意，原有的docker images不會一起導出）
注銷docker-desktop-data
重新導入docker-desktop-data到要存放的文件夾：D:\Docker\wsl\data\
重啟Docker
如果重啟Docker出現報錯：Failed to set version to docker-desktop: exit code: -1
需要打開cmd執行以下命令，執行完畢后需要重啟電腦
報錯原因：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
總結
以上是生活随笔為你收集整理的从零实操基于WSL2 Docker部署Asp.Net Core项目的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 张善友： .NET社区运营 | 202
- 下一篇： 打造史上最小尺寸.Net Core单文件