寫在前面

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

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

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

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

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

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

創(chuàng)建Dockerfile代碼

Dockerfile只是一個(gè)文本文件，它每一行代表Docker鏡像的一個(gè)layer，每一行由命令加參數(shù)組成，我們通過編寫簡單的命令，就能使用docker工具生成docker鏡像。
首先你要在項(xiàng)目中創(chuàng)建Dockerfile，請(qǐng)記住，把你的Dockerfile放在sln目錄下，因?yàn)镈ockerfile文件的build環(huán)境是按照你這個(gè)文件的目錄來的，切記，博主之前花了N天才發(fā)現(xiàn)這個(gè)弱智的問題。docker command對(duì)文件名對(duì)大小寫敏感。

直接上代碼：

FROM microsoft/aspnetcore:2.0 AS base #基于asp.net core 2.0鏡像
WORKDIR /app
EXPOSE 80

# 先使用asp.net core build鏡像，然后復(fù)制項(xiàng)目到/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
#這里添加了對(duì)bundle的支持，你可以不使用，因?yàn)槲腋牧藰邮剑赃@里加上了這個(gè)。
RUN dotnet restore
RUN dotnet build -c Release -o /app

# 編譯以后，我們進(jìn)行發(fā)布，并直接復(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文件了，我在項(xiàng)目中并沒有把configuration.json文件放到項(xiàng)目根目錄，而是另外創(chuàng)建了一個(gè)Configurations目錄，這樣我掛載目錄，可以在多個(gè)容器中共享數(shù)據(jù)。

生成Docker鏡像

如果你的機(jī)器上裝了Docker，那可以通過命令工具，在項(xiàng)目的根目錄運(yùn)行：

docker build -t myocelot:v1 .

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

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

運(yùn)行容器

當(dāng)我們有了鏡像后，就可以運(yùn)行容器了，因?yàn)椴┲饔玫氖前⒗镌迫萜鞴芾?，所以我需要先把鏡像pull到運(yùn)行環(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)建一個(gè)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": {}
}

后面我們來運(yùn)行容器：

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

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

寫在最后

為什么會(huì)有這個(gè)鏡像呢，因?yàn)橥ㄟ^鏡像生成很簡單，而且配置文件更改后，只需要docker restart myocelot就能重新加載，非常簡便。今天的內(nèi)容很簡單，但很實(shí)用，當(dāng)然這個(gè)鏡像還是有點(diǎn)欠缺的，因?yàn)镺celot有很多功能，還需要在Startup.cs中注冊一些service才可以使用，博主有個(gè)想法，弄個(gè)專門的Ocelot Demo，只需要通過config文件就能自動(dòng)注冊相應(yīng)服務(wù)。

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

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

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

最新評(píng)論