1. 程式人生 > >[ASP.NET Core 3框架揭祕] 跨平臺開發體驗: Docker

[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