Skip to content

Latest commit

 

History

History
60 lines (54 loc) · 3.38 KB

README.md

File metadata and controls

60 lines (54 loc) · 3.38 KB
Raw

Ocelot使用案例

解决方案中各项目介绍

  • APIGatewayByOcelot：该项目的作用是API网关，采用 Ocelot 组件
  • ApiOne：该项目为下游API服务测试项目，需使用 Consul 组件注册自己
  • ApiTwo：该项目为下游API服务测试项目，需使用 Consul 组件注册自己
  • Ids4Center.Mvc：该项目是服务认证授权中心，使用 IdentityServer4 组件
  • AccessApiOne：客户端项目，访问需要授权的API接口

Consul服务治理

  1. 下载地址
  2. 解压下载完成之后的压缩包，通过cmd命令行定位到consul.exe所在的目录，运行命令：consul.exe agent --dev
  3. 通过浏览器访问：http://localhost:8500/ui ，此Consul管理端可以查看注册的服务信息

创建下游API服务项目

  1. 创建两个Asp.net Core WebApi项目
  2. 下载 Consul nuget包
  3. 在appsettings.json文件中配置Consul服务端信息 
        /*服务治理第三方组件Consul相关配置参数*/
   "ServiceDiscovery": {
 	"ServiceName": "ApiOne", //本WebApi项目的服务名称，可以随便取名，将显示Consul的管理页面上，届时通过该服务名查找可用的服务站点
 	"Consul": {
 	  "HttpEndpoint": "http://127.0.0.1:8500",
 	  "TcpEndpoint": {
 		"Address": "127.0.0.1",
 		"Port": 8600
 	  }
 	}
   }
  4. 编写服务注册代码，向Consul注册本项目提供的API服务，详见 RegisterToConsulExtension.cs 代码

APIGatewayByOcelot网关项目

  1. 下载 Ocelot nuget包，已经包含Consul的服务发现功能
  2. 添加Ocelot.json配置文件，配置参数详见文件。需要注意的是，如果下游API服务需要授权才能访问，只要添加如下配置参数，并在StartUp类中编写相关代码
"AuthenticationOptions": {
	"AuthenticationProviderKey": "TestKey",
	"AllowedScopes": []
  }

Ids4Center.Mvc认证授权中心

  1. 下载 IdentityServer4 nuget包
  2. 配置客户端和APIResource参数

AccessApiOne客户端

  1. 下载IdentityModel nuget包
  2. 由于ApiOne应用的API接口是需要授权后才能访问，不能通过浏览器直接访问，所以单独下一个客户端项目访问

运行解决方案

  1. 必须先运行Consul，cmd命令：consul.exe agent --dev
  2. 启动项目ApiOne和ApiTwo，你可以打开项目所在目录通过命令行命令，每个项目都可以运行多个实例，如：打开ApiOne项目根目录，直接运行如下命令

    dotnet run --ip 127.0.0.1 --port 8000
    dotnet run --ip 127.0.0.1 --port 8001
    这样就启动了ApiOne项目的两个实例，能接受ip和port参数是因为自己写的代码才支持这样运行，同理可以允许多个ApiTwo项目的实例

  3. 启动Ids4Center.Mvc项目，该项目的端口写死了12345，不需要改动，因为客户端项目AccessApiOne也是写死了这个端口
  4. 启动APIGatewayByOcelot网关项目，端口默认5000，SSL端口是5001。此时可以通过浏览器访问:https://localhost:5001/two/values 可以看到返回结果， 但访问 https://localhost:5001/one/values 时并未看到任何结果，通过F12查看请求，可以看到服务端返回401（未授权），若要访问该接口，可以启动 客户端AccessApiOne项目查看结果。