详解给Ocelot做一个Docker镜像

写在前面

在微服务架构中，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 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。下图为演示截图：

写在最后

为什么会有这个镜像呢，因为通过镜像生成很简单，而且配置文件更改后，只需要docker restart myocelot就能重新加载，非常简便。今天的内容很简单，但很实用，当然这个镜像还是有点欠缺的，因为ocelot有很多功能，还需要在startup.cs中注册一些service才可以使用，博主有个想法，弄个专门的ocelot demo，只需要通过config文件就能自动注册相应服务。

或许你从demo中看到了楼主对ocelot的改动，楼主增加了 downstreamhealthcheckpath属性，这个是为了对下游服务器进行healthcheck的，而且楼主也pr给了ocelot的项目负责人，不过tom不太清楚这个属性有何用，所以我准备做个demo给他看下，这个属性很有用，除了可以通过试图查看下游服务器状态，同时也可以在loadbalance的时候把无效的服务器给忽略掉。

大家觉得healthcheck是否有必要呢？

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。