环境:
- window10 x64
- vs2022 企业版 17.0.0
- .NET 6.0
- Ocelot 17.0.0
- Swashbuckle.AspNetCore 6.2.3
最近在做微服务的时候,由于我们是采用前后端分离来开发的,提供给前端的直接是Swagger,如果Swagger分布在各个API中,前端查看Swagger的时候非常不便,因此,我们试着将Swagger集中放到网关中。
第一步:在网关项目中修改Ocelot配置,获取项目的swagger.json不要授
{
"DownstreamPathTemplate": "/swagger/v1/swagger.json", //下游swagger
"DownstreamScheme": "http",
"ServiceName": "test01",
"LoadBalancerOptions": {
"Type": "RoundRobin" //轮询 //"LeastConnection":最少连接数服务器 "NoloadBalance":不负载均衡 "CookieStickySession":会话粘滞
},
"UseServiceDiscovery": true,
"UpstreamPathTemplate": "/test01/swagger.json", //上游swagger
"UpstreamHttpMethod": [ "GET", "POST", "DELETE", "PUT" ]
}
第二步:在ConfigureServices注入swagger
builder.Services.AddSwaggerGen(options =>
{
options.SwaggerDoc("ApiGateway", new OpenApiInfo { Title = "网关服务", Version = "v1" });
});
第三步:在Configure里配置下游swagger
var apis = new List<string> { "test01" };
app.UseSwagger()
.UseSwaggerUI(options =>
{
apis.ForEach(m =>
{
options.SwaggerEndpoint($"/{m}/swagger.json", m);
});
});
第四步:启动项目
成功请求到下游swagger !