寫在前面

在微服務(wù)架構(gòu)中，ApiGateway起到了承前啟后，不僅可以根據(jù)客戶端進行分類，也可以根據(jù)功能業(yè)務(wù)進行分類，而且對于服務(wù)調(diào)用服務(wù)也起到了很好的接口作用。目前在各個云端中，基本上都提供了ApiGateway的功能（付費功能），通過SDK或者在線進行配置。

在Java體系中有Zuul和Kong都是比較著名的。

在.Net體系中，目前比較熱門的（短短1年時間已經(jīng)1000+stars了）

Ocelot，這是一個非常優(yōu)秀的基于 .Net Core的Api網(wǎng)關(guān)開源項目，我們的在隊長也參與了開發(fā)，過年前又被納入了微軟eShop微服務(wù)架構(gòu)Demo項目中，作為其Api網(wǎng)關(guān)，目前正在整合中，有興趣可以關(guān)注項目中新的的Ocelot Branch。

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

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

創(chuàng)建Dockerfile代碼

Dockerfile只是一個文本文件，它每一行代表Docker鏡像的一個layer，每一行由命令加參數(shù)組成，我們通過編寫簡單的命令，就能使用docker工具生成docker鏡像。
首先你要在項目中創(chuàng)建Dockerfile，請記住，把你的Dockerfile放在sln目錄下，因為Dockerfile文件的build環(huán)境是按照你這個文件的目錄來的，切記，博主之前花了N天才發(fā)現(xià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

# 編譯以后，我們進行發(fā)布，并直接復制到app目錄
FROM build AS publish
RUN dotnet publish -c Release -o /app

# 設(shè)定app目錄為工作目錄
FROM base AS final
WORKDIR /app
COPY --from=publish /app .
# 掛載/app/configurations目錄
VOLUME /app/Configurations

ENTRYPOINT ["dotnet", "ApiGateway.Web.dll"]

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

生成Docker鏡像

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

docker build -t myocelot:v1 .

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

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

運行容器

當我們有了鏡像后，就可以運行容器了，因為博主用的是阿里云容器管理，所以我需要先把鏡像pull到運行環(huán)境（我用的是阿里云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。

隨后我們創(chuàng)建一個ocelot的配置文件目錄,并創(chuàng)建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就能重新加載，非常簡便。今天的內(nèi)容很簡單，但很實用，當然這個鏡像還是有點欠缺的，因為Ocelot有很多功能，還需要在Startup.cs中注冊一些service才可以使用，博主有個想法，弄個專門的Ocelot Demo，只需要通過config文件就能自動注冊相應(yīng)服務(wù)。

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

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

以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。

最新評論