当前位置: 代码迷 >> 综合 >> 正式发布!Azure Functions OpenAPI Extension
  详细解决方案

正式发布!Azure Functions OpenAPI Extension

热度:18   发布时间:2024-01-12 07:41:25.0

5ae860851f54a886e385bd1110571576.png

微软中国MSDN  点击上方蓝字关注我们

距离Azure Functions OpenAPI Extension的预览版发布已有一年的时间,今天,我们很开心地宣布它已经正式发布了!该版本支持.NET Core 2.1 (LTS)、3.1 (LTS)、.NET 5 和 .NET 6 (LTS)的同时,它还支持Azure Functions运行时的进程内和进程外工作线程。

接下来,让我们看看如何在 Visual Studio 2022 中使用 .NET 6 中的 OpenAPI extension创建函数应用

In-Process Worker

在Visual Studio 2022中,你可以使用In-Process Worker在 .NET中创建函数应用:

选择.NET 6→选择左侧菜单的"Http trigger with OpenAPI"→在Authorization level中选择“Function”即可开始创建。

fca5c3c4a40fd3fe50d28250f9bbba69.png

你可以看到有几个decorator以OpenApi开头。由于此扩展的更新Visual Studio项目模板尚未发布,因此现在需要更新 OpenApi extension。选择Solution Explorer中的"Dependencies" 菜单,然后点击"Manage NuGet Packages..." 菜单。将现有的Microsoft.Azure.WebJobs.Extensions.OpenApi package更新为1.0.0。更新后,重建项目并通过单击顶部的“调试”按钮运行函数应用程序。

Out-of-Process Worker

在Visual Studio 2022中,您还可以使用Out-of-Process Worker在.NET中创建函数应用。由于此扩展的更新Visual Studio项目模板尚未推出,您现在需要使用现有的 HTTP触发器并添加NuGet package。创建方式如下:

c140c8db8901cb51cf9cb8eab871b388.png

添加 NuGet Package Microsoft.Azure.Functions.Worker.Extensions.OpenApi。安装后,更新 Program.cs 以激活扩展。删除ConfigureFunctionsWorkerDefaults(),并添加 ConfigureFunctionsWorkerDefaults(worker =>worker.UseNewtonsoftJson()) 和 ConfigureOpenApi()。然后,将OpenAPI相关decorator添加到函数应用尾端。完成更新后,通过单击顶部的“调试”按钮重建项目并运行函数应用程序。

从 .NET Core 3.1或.NET 5

迁移至 .NET 6

只需更新.csproj文件,package版本以及目标框架。然后将Azure Functions相关的NuGet packages更新至最新版本,包括OpenAPI extension。重新构建项目,单击顶部的“调试”按钮运行函数应用程序。接下来,打开Web浏览器进入http://localhost:7071/api/swagger/ui,你就可以看到Swagger UI页面了。

63f96e5b2b10e44be5544ffe960a31f2.png

c065e1efd5927c84321f22202e4d2ed9.png

更多细化的操作步骤请扫描二维码查看

a48629ed78161c961c3a35f3298a8720.png

7814a0832976b7f3870fa5ba7b8b110e.gif

   查看Azure Functions OpenAPI Extension  

  相关解决方案