詳解給Ocelot做一個(gè)Docker鏡像
寫在前面
在微服務(wù)架構(gòu)中,ApiGateway起到了承前啟后,不僅可以根據(jù)客戶端進(jìn)行分類,也可以根據(jù)功能業(yè)務(wù)進(jìn)行分類,而且對(duì)于服務(wù)調(diào)用服務(wù)也起到了很好的接口作用。目前在各個(gè)云端中,基本上都提供了ApiGateway的功能(付費(fèi)功能),通過SDK或者在線進(jìn)行配置。
在.Net體系中,目前比較熱門的(短短1年時(shí)間已經(jīng)1000+stars了)
Ocelot,這是一個(gè)非常優(yōu)秀的基于 .Net Core的Api網(wǎng)關(guān)開源項(xiàng)目,我們的在隊(duì)長(zhǎng)也參與了開發(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ù)組成,我們通過編寫簡(jiǎn)單的命令,就能使用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倉(cāng)庫(kù)或者阿里云的容器管理進(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)橥ㄟ^鏡像生成很簡(jiǎn)單,而且配置文件更改后,只需要docker restart myocelot就能重新加載,非常簡(jiǎn)便。今天的內(nèi)容很簡(jiǎn)單,但很實(shí)用,當(dāng)然這個(gè)鏡像還是有點(diǎn)欠缺的,因?yàn)镺celot有很多功能,還需要在Startup.cs中注冊(cè)一些service才可以使用,博主有個(gè)想法,弄個(gè)專門的Ocelot Demo,只需要通過config文件就能自動(dòng)注冊(cè)相應(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是否有必要呢?
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
- .Net?Core微服務(wù)網(wǎng)關(guān)Ocelot集成Consul
- .Net?Core微服務(wù)網(wǎng)關(guān)Ocelot基礎(chǔ)介紹及集成
- ASP.NET Core Api網(wǎng)關(guān)Ocelot的使用初探
- ASP.NET Core3.1 Ocelot負(fù)載均衡的實(shí)現(xiàn)
- ASP.NET Core3.1 Ocelot認(rèn)證的實(shí)現(xiàn)
- ASP.NET Core3.1 Ocelot路由的實(shí)現(xiàn)
- .Net?Core微服務(wù)網(wǎng)關(guān)Ocelot超時(shí)、熔斷、限流
相關(guān)文章
docker安裝elastic?search和kibana的實(shí)現(xiàn)
本文主要介紹了docker安裝elastic?search和kibana的實(shí)現(xiàn),,文中通過示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-04-04Docker私有倉(cāng)庫(kù)管理和刪除本地倉(cāng)庫(kù)中的鏡像
這篇文章主要介紹了Docker私有倉(cāng)庫(kù)管理和刪除本地倉(cāng)庫(kù)中的鏡像,小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2019-01-01centos7更改docker倉(cāng)庫(kù)的方法
這篇文章主要介紹了centos7更改docker倉(cāng)庫(kù)的方法,小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2018-07-07淺談docker學(xué)習(xí)之docker數(shù)據(jù)卷(volume)
這篇文章主要介紹了淺談docker學(xué)習(xí)之docker數(shù)據(jù)卷(volume),小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2017-12-12Docker拉取鏡像失敗解決(connect: connection refused)
最近遇到Docker拉取centos鏡像時(shí)報(bào)錯(cuò),本文主要介紹了Docker拉取鏡像失敗解決(connect: connection refused),具有一定的參考價(jià)值,感興趣的可以了解一下2024-07-07詳解利用Dockerfile構(gòu)建mysql鏡像并實(shí)現(xiàn)數(shù)據(jù)的初始化及權(quán)限設(shè)置
本篇文章主要介紹了詳解利用Dockerfile構(gòu)建mysql鏡像并實(shí)現(xiàn)數(shù)據(jù)的初始化及權(quán)限設(shè)置 ,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2017-06-06