我开发了一个基于微服务(11 个微服务)的项目并用于Ocelat
api 网关,但我正在努力生成微服务 api 文档,Ocelat
说使用这种方式通过在网关项目中创建 swagger json 文件并添加所有 api 端点来生成文档:
app.Map("/swagger/v1/swagger.json", b =>
{
b.Run(x =>
File.ReadAllTextAsync(Path.Combine(AppContext.BaseDirectory,
"ApiDocumentation/Swagger.json"))
.ContinueWith(readTask => x.Response.WriteAsync(readTask.Result))
);
但是每次更改我的微服务 api 时,我都必须编辑此文件并再次部署网关项目,但我想自动生成 api 网关文档。
我已经阅读了这个存储库MMLib.SwaggerForOcelot但我认为应该有另一种更好的方法。
我正在使用 .net core 3.1 和 Swashbuckle.AspNetCore 5.4.1。