寫在前面

在微服務架構中，ApiGateway起到了承前啟后，不僅可以根據客戶端進行分類，也可以根據功能業務進行分類，而且對于服務調用服務也起到了很好的接口作用。目前在各個云端中，基本上都提供了ApiGateway的功能（付費功能），通過SDK或者在線進行配置。
在Java體系中有Zuul和Kong都是比較著名的。
在.Net體系中，目前比較熱門的（短短1年時間已經1000+stars了）
Ocelot，這是一個非常優秀的基于 .Net Core的Api網關開源項目，我們的在隊長也參與了開發，過年前又被納入了微軟eShop微服務架構Demo項目中，作為其Api網關，目前正在整合中，有興趣可以關注項目中新的的Ocelot Branch。

基本的使用方式在園中已有博主寫過了，不過內容是之前版本的，新版本稍微有點不同，還是建議大家看文檔。通過文檔我們了解，Ocelot是通過一個json文件進行配置的，所以在使用的時候我們只需要修改這個json文件就可以了，每次為不同的ApiGateway創建不同的項目比較麻煩，So，今天來講下如何把Ocelot做成一個Docker鏡像，這樣使用的時候只需要輸入一條docker指令即可。

今天的Dockerfile我是Fork了Ocelot項目后在自己的Branch中弄的，直接是項目引用，這只是范例而已，你可以重新創建一個專門的項目，通過Nuget管理添加對Ocelot的引用。

創建Dockerfile代碼

Dockerfile只是一個文本文件，它每一行代表Docker鏡像的一個layer，每一行由命令加參數組成，我們通過編寫簡單的命令，就能使用docker工具生成docker鏡像。
首先你要在項目中創建Dockerfile，請記住，把你的Dockerfile放在sln目錄下，因為Dockerfile文件的build環境是按照你這個文件的目錄來的，切記，博主之前花了N天才發現這個弱智的問題。docker command對文件名對大小寫敏感。

直接上代碼：

FROM microsoft/aspnetcore:2.0 AS base #基于asp.net core 2.0鏡像 WORKDIR /app EXPOSE 80# 先使用asp.net core build鏡像，然后復制項目到/src目錄 FROM microsoft/aspnetcore-build:2.0 AS build WORKDIR /src COPY *.sln ./ COPY demos/ApiGateway.Web/ApiGateway.Web.csproj demos/ApiGateway.Web/ COPY src/Ocelot/Ocelot.csproj src/Ocelot/RUN dotnet restoreCOPY . . WORKDIR /src/demos/ApiGateway.Web RUN dotnet add package BuildBundlerMinifier #這里添加了對bundle的支持，你可以不使用，因為我更改了樣式，所以這里加上了這個。 RUN dotnet restore RUN dotnet build -c Release -o /app# 編譯以后，我們進行發布，并直接復制到app目錄 FROM build AS publish RUN dotnet publish -c Release -o /app# 設定app目錄為工作目錄 FROM base AS final WORKDIR /app COPY --from=publish /app . # 掛載/app/configurations目錄 VOLUME /app/ConfigurationsENTRYPOINT ["dotnet", "ApiGateway.Web.dll"]

上面就是我的Dockerfile文件了，我在項目中并沒有把configuration.json文件放到項目根目錄，而是另外創建了一個Configurations目錄，這樣我掛載目錄，可以在多個容器中共享數據。

生成Docker鏡像

如果你的機器上裝了Docker，那可以通過命令工具，在項目的根目錄運行：

docker build -t myocelot:v1 .

注意這個命令后的.一定不要忘記哦

如果你機器上沒有安裝Docker，也沒有關系，可以通過Docker倉庫或者阿里云的容器管理進行生成，他們都是免費的，博主使用的是阿里云容器管理創建的，這樣每次代碼改動，它會自動生成新的鏡像。

運行容器

當我們有了鏡像后，就可以運行容器了，因為博主用的是阿里云容器管理，所以我需要先把鏡像pull到運行環境（我用的是阿里云ECS）

docker pull registry.cn-hangzhou.aliyuncs.com/jamesying/ocelot-demo docker tag registry.cn-hangzhou.aliyuncs.com/jamesying/ocelot-demo myocelot:v1

博主通過pull命令拉了鏡像后又通過tag命令重新命名了tagname。

隨后我們創建一個ocelot的配置文件目錄,并創建configurations.json文件：

mkdir /home/ocelot touch /home/ocelot/configurations.json

下面通過vi工具配置你自己的config，下面是博主的：

{"ReRoutes": [{"DownstreamPathTemplate": "/api/values/{id}","DownstreamScheme": "http","DownstreamHostAndPorts": [{"Host": "localhost","Port": 6002},{"Host": "localhost","Port": 6001}],"LoadBalancer": "RoundRobin","UpstreamPathTemplate": "/api/v1/values/{id}","DownstreamHealthcheckPath": "/hc?apikey=testapi","UpstreamHttpMethod": [ "GET", "Put", "Delete" ]}],"GlobalConfiguration": {} }

后面我們來運行容器：

docker run --name myocelot -p 6008:80 -v /home/ocelot:/app/configurations -d ocelot:v1

成功運行以后，我們就可以通過6008端口訪問了，你可以通過 http://ocelot.jcsoft.xyz:6008 看下Demo。下圖為演示截圖：

寫在最后

為什么會有這個鏡像呢，因為通過鏡像生成很簡單，而且配置文件更改后，只需要docker restart myocelot就能重新加載，非常簡便。今天的內容很簡單，但很實用，當然這個鏡像還是有點欠缺的，因為Ocelot有很多功能，還需要在Startup.cs中注冊一些service才可以使用，博主有個想法，弄個專門的Ocelot Demo，只需要通過config文件就能自動注冊相應服務。

或許你從Demo中看到了樓主對Ocelot的改動，樓主增加了 DownstreamHealthcheckPath屬性，這個是為了對下游服務器進行Healthcheck的，而且樓主也PR給了Ocelot的項目負責人，不過Tom不太清楚這個屬性有何用，所以我準備做個Demo給他看下，這個屬性很有用，除了可以通過試圖查看下游服務器狀態，同時也可以在LoadBalance的時候把無效的服務器給忽略掉。

大家覺得Healthcheck是否有必要呢？

總結

以上是生活随笔為你收集整理的给Ocelot做一个Docker 镜像的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。