[ASP.NET Core 3框架揭秘] 跨平台開發體驗: Docker

對於一個 .NET Core開發人員，你可能沒有使用過Docker，但是你不可能沒有聽說過Docker。Docker是Github上最受歡迎的開源項目之一，它號稱要成為所有雲應用的基石，並把互聯網升級到下一代。Docker是dotCloud公司開源的一款產品，從其誕生那一刻算起，在短短兩三年時間里就成為了開源社區最火爆的項目。對於完全擁抱開源的.NET Core來說，它自然應該對Docker提供完美的支持。對於接下來的內容，我們假設你已經對Docker有了基本的了解，並且在你的機器上（Windows）上已經安裝了Docker。

一、創建一個ASP.NET Core應用

我們將演示如何創建一個ASP.NET Core程序並將其編譯成Docker鏡像，並Docker環境針對該鏡像創建一個容器來啟動一個應用實例。簡單起見，我們還是直接采用腳手架命令行的形式來創建這個ASP.NET Core應用。如下圖1所示，我們執行dotnet new web命令在“d:\projects\helloworld”目錄下創建一個空的ASP.NET Core應用。

二、定義Dokerfile

我們現在需要將這個ASP.NET Core應用制作成一個Docker鏡像，為此我們需要在項目根目錄下創建一個Dockerfile文件（文件名就是Dokerfile，沒有擴展名），並在該文件中定義如下的內容。如果我們對Dockerfile具有基本的了解，對於這個文件的內容應該不難理解。

# 1. 指定編譯和發布應用的鏡像
FROM mcr.microsoft.com/dotnet/core/sdk:3.0 AS build

# 2. 指定（編譯和發布）工作目錄
WORKDIR /app

# 3. 拷貝.csproj到工作目錄/app，然后執行dotnet restore恢復所有安裝的NuGet包
COPY *.csproj ./
RUN dotnet restore

# 4. 拷貝所有文件到工作目錄(/app)，然后執行dotnet publish命令將應用發布到/app/out目錄下
COPY . ./
RUN dotnet publish -c Release -o out

# 5. 編譯生成Docker鏡像
# 5.1.設置基礎鏡像
FROM mcr.microsoft.com/dotnet/core/aspnet:3.0 AS runtime

# 5.2. 設置（運行）工作目錄，並將發布文件拷貝到out子目錄下
WORKDIR /app
COPY --from=build /app/out .

# 5.3. 利用環境變量設置ASP.NET Core應用的監聽地址
ENV ASPNETCORE_URLS http://0.0.0.0:3721

# 5.4. 執行dotnet命令啟動ASP.NET Core應用
ENTRYPOINT ["dotnet", "helloworld.dll"]

這個Dockerfile采用了一個中間層（build）來暫存ASP.NET Core MVC應用發布后的資源，其工作目錄為“/app”。具體來說，這個層采用“microsoft/aspnetcore-build:2”作為基礎鏡像，我們先將定義項目的.csproj文件（helloworld.csproj）拷貝到當前工作目錄，然后運行“dotnet restore”命令恢復所有注冊在這個項目文件中的NuGet包。接下來我們將當前項目的所有文件拷貝到當前工作目錄，並執行dotnet publish對整個項目進行編譯發布（針對Release模式），發布后的資源被保存到目錄“/app/out”中。

在真正將編譯生成Docker鏡像的時候，我們采用“mcr.microsoft.com/dotnet/core/aspnet:3.0”作為基礎鏡像，由於應用在上面進行了預先發布，所以我們只需要將發布后的所有文件拷貝到當前工作目錄就可以了。接下來我們通過環境變量設置了ASP.NET Core應用的監聽地址（http://0.0.0.0:3721）。針對ENTRYPOINT的定義（ENTRYPOINT ["dotnet", "helloworld.dll"]），我們知道當容器被啟動的時候，“dotnet helloworld.dll”命令會被執行以啟動這個ASP.NET Core應用。

三、生成鏡像

Dockerfile文件定義好之后，我們打開CMD命令行並切換到項目所在根目錄（也就是Dockerfile文件所在的目錄），然后執行“docker build -t helloworldapp .”命令，該命令會利用這個Dockerfile文件生成一個命名為helloworldapp”的Docker鏡像。

四、啟動容器

既然Docker鏡像已經被成功創建出來了，那么余下的工作就很簡單了，我們只需要針對這個鏡像創建對應的容器，最終的ASP.NET Core應用的啟動就可以直接通過啟動該容器來完成。如下圖所示，我們執行“docker run -d -p 8080:3721 --name myapp helloworldapp”命令針對前面生成的Docker鏡像（helloworldapp）創建並啟動了一個命名為myapp（--name myapp）的容器。由於我們從外面訪問這個應用，所以我們通過端口映射（-p 8080:3721）將內部監聽端口3721映射為當前宿主機器的端口8080，所以我們利用地址“http://localhost:8080”訪問這個通過Docker容器承載的ASP.NET Core應用。

[ASP.NET Core 3框架揭秘] 跨平台開發體驗: Windows [上篇]
[ASP.NET Core 3框架揭秘] 跨平台開發體驗: Windows [中篇]
[ASP.NET Core 3框架揭秘] 跨平台開發體驗: Windows [下篇]
[ASP.NET Core 3框架揭秘] 跨平台開發體驗: Mac OS
[ASP.NET Core 3框架揭秘] 跨平台開發體驗: Linux
[ASP.NET Core 3框架揭秘] 跨平台開發體驗: Docker