給Ocelot做一個Docker 鏡像


寫在前面

在微服務架構中,ApiGateway起到了承前啟后,不僅可以根據客戶端進行分類,也可以根據功能業務進行分類,而且對於服務調用服務也起到了很好的接口作用。目前在各個雲端中,基本上都提供了ApiGateway的功能(付費功能),通過SDK或者在線進行配置。
在Java體系中有ZuulKong都是比較著名的。
在.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 restore

COPY . .
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/Configurations

ENTRYPOINT ["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。下圖為演示截圖:
image

寫在最后

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

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

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


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM