進行ASP.NET容器化-以ASP.NET MVC/Web API為例

要將 ASP.NET MVC / ASP.NET Web API 轉移至 Docker Container 中運行，看似麻煩，但其實非常簡單。以下討論不使用工具與使用 Visual Studio for Docker 工具來達成轉移的工作。

Step1 - 手動進行 ASP.NET MVC / Web API 容器化

第一步，將 ASP.NET MVC / ASP.NET Web API 進行本機部署。

• 在「發行」選擇「目錄]
• 路徑採用預設的「bin\Release\PublishOutput」
• 發行設定檔完成後，修改設定檔發行選項，勾選「發行期間預先編譯」

因為將要發行至 Container 進行檢視與測試，代表應用程式已經接近 Release，可以採用預先編譯。修改好了之後，可以發行至指定目錄。

第二步，我們要製作 MVC / Web API 應用程式的 Image。

首先要先選擇基礎 Image，連線至 Docker Hub - microsoft/aspnet 選擇。Docker Hub - microsoft 包含所有 Microsoft 目前所有 Docker 的 Linux / Windows 平台基礎 Images。基礎 Images 的說明請自行參考。這裡比較容易搞混的地方在於，microsoft/iis 與 microsoft/aspnet 兩者，microsoft/iis 想成只單純啟用 IIS 的伺服器，microsoft/aspnet 是以 microsoft/iis 為基礎 Image 再加上其他如 .NET Framework 的執行環境。這裡我們選擇 microsoft/aspnet 作為我們的基礎 Image。

在選擇 microsoft 的 Image 時，有個小技巧，請多注意 Tags 裡的編譯條件，盡量選擇 windowsservercore 或 nanoserver 的版本，少選擇 latest 版本。最明顯的差異是節省大量空間，例如，aspnet:latest 與 aspnet:4.7.1 約 7GB 大小，但 aspnet:4.7.1-windowsservercore-1709 約 4GB。有興趣的讀者可自行瞭解 Windows Server / Server Core / Nano Server 的差異。

在專案根目錄下撰寫 Dockerfile：

FROM microsoft/aspnet:4.7.1-windowsservercore-1709
COPY ./bin/Release/PublishOutput /inetpub/wwwroot

預設 microsoft/aspnet 只含 .NET Framework 4.6.2 執行環境，這裡我們採用較高的 .NET Framework 4.7.1 版本。

建議先把基礎 Image 先下載好：docker pull microsoft/aspnet:4.7.1-windowsservercore-1709

接下來就能建置出我們要的應用程式版本的 Image：

docker build -t aspnetapp .
docker run -d --name aspnetapp aspnetapp

取得取得連線 IP：

docker inspect aspnetapp
docker exec aspnetapp ipconfig

現在就能透過取得的 IP 進行 http://IP 來連線測試。

使用 Docker Support 工具進行 ASP.NET MVC / Web API 容器化

ASP.NET MVC 或 ASP.NET Web API 專案 --> 新增 --> Docker Support。

點選之間就完成所有 Docker 所需的組態檔的產生，不過和剛剛不太一樣，Docker Support 是使用 docker-compose 方式來進行建置與執行，所以 Dockerfile 的內容有些差異，而且 Visual Studio 會在背景就開始產生所需要 Image，可以在輸出視窗看到如下訊息：

========== Preparing Containers ==========
Getting Docker containers ready...
docker-compose  -f "Z:\webapp5\docker-compose.yml" -f "Z:\webapp5\docker-compose.override.yml" -f "Z:\webapp5\obj\Docker\docker-compose.vs.debug.g.yml" -p dockercompose17244174905642050223 --no-ansi config
networks:
  default:
    external:
      name: nat
services:
  webapp5:
    build:
      args:
        source: obj/Docker/empty/
      context: Z:\webapp5\webapp5
      dockerfile: Dockerfile
    entrypoint: cmd /c "start /B C:\\ServiceMonitor.exe w3svc & C:\\remote_debugger\\x64\\msvsmon.exe
      /noauth /anyuser /silent /nostatus /noclrwarn /nosecuritywarn /nofirewallwarn
      /nowowwarn /timeout:2147483646"
    environment:
      DEV_ENVIRONMENT: '1'
      VBCSCOMPILER_TTL: '604800'
    image: webapp5:dev
    ports:
    - 80/tcp
    volumes:
    - Z:\webapp5\webapp5:C:\inetpub\wwwroot:rw
    - C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Remote
      Debugger:C:\remote_debugger:ro
version: '3.0'
docker-compose  -f "Z:\webapp5\docker-compose.yml" -f "Z:\webapp5\docker-compose.override.yml" -f "Z:\webapp5\obj\Docker\docker-compose.vs.debug.g.yml" -p dockercompose17244174905642050223 --no-ansi build 
Building webapp5
Step 1/4 : FROM microsoft/aspnet:4.7.1-windowsservercore-1709
 ---> dc3f4d701ead
Step 2/4 : ARG source
 ---> Using cache
 ---> 9b042835351f
Step 3/4 : WORKDIR /inetpub/wwwroot
 ---> Using cache
 ---> 0cb87dce5d0a
Step 4/4 : COPY ${source:-obj/Docker/publish} .
 ---> Using cache
 ---> fafda2039875
Successfully built fafda2039875
Successfully tagged webapp5:dev
docker-compose  -f "Z:\webapp5\docker-compose.yml" -f "Z:\webapp5\docker-compose.override.yml" -f "Z:\webapp5\obj\Docker\docker-compose.vs.debug.g.yml" -p dockercompose17244174905642050223 --no-ansi up -d --no-build --force-recreate --remove-orphans
Creating dockercompose17244174905642050223_webapp5_1 ... 
Creating dockercompose17244174905642050223_webapp5_1 ... done
Done!  Docker containers are ready.

Dockerfile 差異不大：

FROM microsoft/aspnet:4.7.1-windowsservercore-1709
ARG source
WORKDIR /inetpub/wwwroot
COPY ${source:-obj/Docker/publish} .

ARG source 就是宣告一個參數 source。在上面輸出訊息的 service/webapp5/build/args/source 被指定進來，其實展開後和我們手動的 Dockerfile 沒什麼差異。

如果是全新的 ASP.NET MVC 或 ASP.NET Web API 專案，那麼更簡單，在一開始開專案時就勾選「啟用 Docker Support」，等同於「專案 --> 新增 --> Docker Support」的動作。 不管是手動組態來支援 Docker 或 Docker Support 來產生 docker-compose 與 Dockerfile 的組態，你都能看到，要將現行 .NET Framework 架構的 ASP.NET MVC/Web API 專案放入 Docker Container 裡去運行都不是那麼困難。執行比較難的可能是 Windows Container 管理與操作，Windows Container 的文件資源不夠，還有週邊 Images 成熟度與配套不及 Linux Container 的事實。不過，如果你的執行環境原本就是 Windows/IIS 的話，那麼搞不好 Windows Container 反而是利多。

---

[工商服務]ASP.NET Web API 2 實戰訓練營 第三梯

04月14日~05月05日，我在 skilltree 開設三日實戰訓練營目前熱烈招生中。

如同本篇內容，我的課程內容包含大量實務上真實需求進而產生的實作，絕不是研討會上那種 Todo Demo 專案，完整的 REST/HTTP 理論加真實實務實作內容。有了完整的理論基礎，你才能打出拳拳到肉的招式，有了實戰範例的淬鍊，經驗值十倍奉還，輕鬆上場殺敵。

報名即將截止，報名網址：https://skilltree.my/events/8dbed