我正在创建一个 V2 函数应用程序,并希望使用 Swagger/Open API 来处理文档,但 Azure V2 函数门户尚不支持它。
关于如何在 VSTS 中使用 Swagger 和 V2 函数在每个构建上创建文档,有什么建议吗?
TL;DR- 使用 NuGet 包通过 Azure Functions 呈现 Open API 文档和 Swagger UI。
UPDATE(2021-06-04)
微软最近宣布 Azure Functions 支持 OpenAPI https://aka.ms/azfunc-openapi-support在 //Build 事件期间。
The 外星人立方体扩展现已存档,不再受支持。请使用这个官方扩展 https://aka.ms/azfunc-openapi.
截至今天,它处于预览状态。虽然它还处于预览阶段,但它比 Aliencube 具有更多功能。
致谢2: 我还是维护官方的。
微软尚未正式开始支持 Open API(或 Swagger)。但目前有一个社区驱动的 NuGet 包可用:
Nuget > Aliencube.AzureFunctions.Extensions.OpenApi https://www.nuget.org/packages/Aliencube.AzureFunctions.Extensions.OpenApi/
这是它的博客文章:
在 Azure Functions 上引入 Swagger UI https://devkimchi.com/2019/02/02/introducing-swagger-ui-on-azure-functions/
基本上它的用法与 Swashbuckle 类似——使用装饰器。它同时支持 Azure Functions V1 和 V2。
致谢1:我是 NuGet 包的所有者。
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)