正式釋出!Azure Functions OpenAPI Extension

微軟技術棧發表於2021-12-13

距離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”即可開始建立。

e9589b7771d331a4715c40c6ef682f31.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。建立方式如下:

935c1de7f5b550e1b8c3d4ac2ed6dbdd.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/swa...,你就可以看到Swagger UI頁面了。

ba82d6041092cf5ca4ff52c846804f7.png

更多細化的操作步驟請掃描二維碼檢視

f99ace62aae5b080405cab695c0bccf0.png

相關文章