本篇同步發文在個人Blog: 一袋.NET要扛幾樓？打造容器化的ASP.NET Core網站！系列文章 - (7) 建立商品服務的Api - 5

 1. 建立Dockerfile

　　在CatalogApi專案右鍵=>加入=>Dokcer支援，選擇目標平台Linux，將會在根目錄新增Dockerfile檔案，但這Dokcerfile有一些Bug，因為我的專案目錄設計方式，會讓VS產生錯誤的連結，所以需要再手動修改，變成下方的內容。其內容主要功能是在Docker容器內載入NET Core SDK編譯我們的程式碼，將編譯後的目錄檔案複製到Runtime環境的/app目錄，再用NET Core Runtime執行商品服務的Api系統。

    FROM mcr.microsoft.com/dotnet/core/sdk:3.1-buster AS build
    
    WORKDIR /code
    EXPOSE 80
    
    COPY . .
    
    RUN dotnet restore
    
    RUN dotnet publish -o /out/ -c Release
    
    FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim AS base
    
    COPY --from=build /out /app/
    
    WORKDIR /app
    
    ENTRYPOINT ["dotnet", "CatalogApi.dll"]

 2. 修改dokcer-compose.yml

之前已經在docker-compose.yml加入SQL Server的image，而這次要加上商品服務的Api，如下方的yml。主要的參數包含：

• build的dockerfile：Dockerfile的檔名
• build的context：我們商品服務Api的Dockerfile所在的目錄
• image：這商品服務Api的image命名
• environment：這些參數將會覆蓋appSettings.json的內容，包含資料庫的連線資訊、外部連到此服務的URL。其中ExternalCatalogBaseUrl的{}值會從.env檔的內容做替換
• ports：將此Api的80 port對應為本機的7000
• depends_on：需要先等SQL Server的容器啟動完，才輪到此Api啟動容器
• networks：新增一個frontend網路區域，之後會和網頁前端系統互通

    version: "3.4"
    
    networks:
       frontend:
       backend:
       
    services:
       catalog:
          build:
             context: .\src\Services\CatalogApi
             dockerfile: Dockerfile
          image: rpgshop/catalog
          environment:
             - DatabaseServer=mssqlserver
             - DatabaseName=CatalogDb
             - DatabaseUser=sa
             - DatabasePassword=JustTest!
             - ExternalCatalogBaseUrl=http://${RPGSHOP_EXTERNAL_DNS_NAME_OR_IP}:7000
          container_name: rpgcatalogapi
          ports:
             - "7000:80"
          networks:
             - backend
             - frontend
          depends_on:
             - mssqlserver
    
       mssqlserver:
          image: "microsoft/mssql-server-linux:latest"
          ports:
             - "1445:1433"
          container_name: rpgmssqlcontainer
          environment:
             - ACCEPT_EULA=Y
             - SA_PASSWORD=JustTest!
          networks:
             - backend

 3. 建立.env檔

　　.env檔是一種環境變數檔，用key=value的方式寫在此檔案，目前我們只需要放一筆資料：

RPGSHOP_EXTERNAL_DNS_NAME_OR_IP=docker.for.win.localhost

　　這是前述的ExternalCatalogBaseUrl的值會被替換，而docker.for.win.localhost是docker內建在Windows的host。

 4. 用cmd執行docker-compose

　　用cmd在docker-compose.yml所在位置輸入指令：

    docker-compose up

　　執行完後，在瀏覽器輸入http://docker.for.win.localhost:7000/swagger ，將看見容器化的商品服務API，如圖1，且使用try it out都是正常運作。

圖1

這一系列的專案將開在這Github：RPGShopOnContainers，會依照文章的主題進度區分資料夾，有需要的人可自行pull / download～

下一篇將建立一套網站前端，整合商品服務的API作商品呈現。