Ocelot(v7.0.6)使用小记

本次小记系列计划有如下内容

1、Ocelot(v7.0.6)使用小记

2、Swashbuckle.AspNetCore(v2.5.0)使用小记

3、Ocelot与Swashbuckle.AspNetCore集成使用小记

4、Consul使用小记

5、Nginx使用小记

6、IdentityServer4(2.2.0)使用小记

7、Dotnetcore.CAP使用小记

以上内容都是以《Ocelot(v7.0.6)使用小记》为基础的示例整合

========================================

本文不涉及任何概念，如果想了解Ocelot是什么，请自己在园子中搜索即可。

系统：Windows 10

IDE：vs2017最新版（截止到2018年7月）

SDK：.Net Core 2.1

涉及到的Nuget项目有：Ocelot(v7.0.6)

我们准备搭建2个WebAPI的空白项目

①DogService----用于被Ocelot访问

②CatService-----用于被Ocelot访问

我们现在开始建立第一个WebAPI的项目，如果下图所示

这里大家请注意，我现在使用的是asp.net core2.1版本的SDK，如果还是2.0版本的同学，强烈建议去下载2.1版本SDK

这里我们已经建立完了一个空的DogService的WebAPI项目了

我的VS可能是安装有问题，每次新建立的项目都会出现惊叹号，解决的方式是，关掉项目重新打开就好了，很奇怪。

现在我们建立第二个WebAPI的项目CatService，过程以及截图略过，跟DogService完全一样的流程

我们来修改一下默认生成的Controller控制器

我把原来values控制器里的默认方法都删除了，自己增加了一个Test方法，访问模式为POST，自定义的路由是api/findcat

我们来测试一下这个WebAPI能否正常访问，由于我使用的是POST的方式，所以我们来使用POSTMAN来进行访问测试

先通过命令行的方式运行这个CatService

显示的访问地址是 http://localhost:5000

接下来我们通过postman来访问一下这个地址，看看是否有正确的结果

结果是返回错误，没有得到任何信息，我们现在去startup代码片段里看一下

我们尝试着把使用https的这个设置去掉，继续在测试一下看是否好用

我们看到成功输出了 this is a cat 了，说明运行成功，然后我们通过同样的方式去测试一下DogService的WebAPI项目

我们看到DogService也成功运行了，好了，CatService与DotService已经准备完毕，接下来我们开始建立一个Gateway的项目（Ocelot）

我们右键点击GatewayAPI项目，选择管理Nuget程序包

我们查找Ocelot并且进行安装，安装量猛增啊，上周还是40K，本周就52K了，哈哈

如果中途出现了选择对话框，请选“我接受”即可。

如果出现以下提示，说明Ocelot安装成功了，我们进行下一步操作。

在GatewayAPI项目的startup文件的ConfigureServices方法中加入：services.AddOcelot(Configuration);

在GatewayAPI项目的startup文件的Configure方法中加入：app.UseOcelot().Wait();

我们在根目录新建一个名字叫做configuration.json的文件

下面是config文件的内容

{
  "ReRoutes": [
    //CatService
    {
      "DownstreamPathTemplate": "/api/findcat", //下游服务的访问路径
      "DownstreamScheme": "http", //下游服务是http还是https
      "DownstreamHostAndPorts": [ //下游服务的地址以及端口号
        {
          "Host": "localhost", //下游服务的地址
          "Port": "6002" //下游服务的端口号
        }
      ],
      "UpstreamPathTemplate": "/service/cat", //上游服务的访问路径
      "UpstreamHttpMethod": [ "GET", "POST" ] //上游服务的访问模式，本例里只用到了POST
    },
    //DogService
    {
      "DownstreamPathTemplate": "/api/finddog",
      "DownstreamScheme": "http",
      "DownstreamHostAndPorts": [
        {
          "Host": "localhost",
          "Port": "6002"
        }
      ],
      "UpstreamPathTemplate": "/service/dog",
      "UpstreamHttpMethod": [ "GET", "POST" ]
    }
  ]
}
/*
  上游与下游的解释：
  上游：用户访问Ocelot网关时的操作称为上游访问
  下游：Ocelot访问的具体WebAPI服务（本例中只用了WebAPI，当然还可能是其他类型服务）称为下游访问
*/