[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應用。

1-23

二、定義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鏡像。

1-24

四、啟動容器

既然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應用。

1-25

[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

posted @ 2019-10-14 08:27 Artech 閱讀(...) 評論(...) 編輯 收藏