少年击剑更吹箫，剑气箫心一例消。这篇文章主要讲述.NET 5 支持 Azure Functions OpenAPI 扩展啦相关的知识，希望能为你提供帮助。
今年5月，在 Build大会上，Azure FunctionsOpenAPI的功能支持（预览版）正式宣布。 当时，它最高支持 v3 运行时——.NET Core 3.1 版本。 最近，它发布了 .NET 5 隔离工作器支持包作为预览。在这篇文章中，我将回顾如何使用它并将其部署到 Azure。
在 .NET 5 中创建 Azure Functions 应用程序让我们使用Visual Studio来完成这个练习。在创建应用程序时，使用"
.NET 5(隔离)"
运行时和"
Http触发器"
。
文章图片
然后您将找到带有默认代码的HTTP端点。现在，在解决方案资源管理器上选择NuGet包管理器菜单。
文章图片
在NuGet包管理器屏幕中，勾选" 包括预发布" 复选框，然后搜索Microsoft.Azure.Functions.Worker.Extensions.OpenApi包。在撰写本文时，NuGet打包程序版本是v0.8.1-preview。
文章图片
OpenAPI扩展现在已经安装。
配置 HostBuilder安装OpenAPI扩展之后，让我们配置HostBuilder。首先，打开Program.cs文件并删除现有的ConfigureFunctionsWorkerDefaults()方法。这是因为该方法默认使用System.Text.Json，我们不会使用它。
```c#
public static void Main(){
var host = new HostBuilder()
// ???????????????????? 删除以下这行 ????????????????????
.ConfigureFunctionsWorkerDefaults()
// ???????????????????? 删除以上这行 ????????????????????
.Build();
host.Run();
}
然后，按此顺序添加ConfigureFunctionsWorkerDefaults(worker =\\&
gt;
worker. usenewtonsoftjson())和ConfigureOpenApi()方法。第一个方法明确声明要使用Newtonsoft.Json包，下一个导入额外的OpenAPI相关端点。
```C#
public static void Main()
{
var host = new HostBuilder()
// ???????????????????? Add these lines below ????????????????????
.ConfigureFunctionsWorkerDefaults(worker =>
worker.UseNewtonsoftJson())
.ConfigureOpenApi()
// ???????????????????? Add these lines above ????????????????????
.Build();
host.Run();
}至此，配置完毕。 让我们继续。
添加 OpenAPI 修饰符【.NET 5 支持 Azure Functions OpenAPI 扩展啦】添加 OpenAPI 相关的修饰符，如下所示。 这与现有方法完全相同，所以我不会讲得太深。
```C#
// ???????????????????? 在下面添加OpenAPI 相关的修饰符????????????????????
[OpenApiOperation(operationId: " greeting" , tags: new[] { " greeting" }, Summary = " Greetings" , Description = " This shows a welcome message." , Visibility = OpenApiVisibilityType.Important)]
[OpenApiSecurity(" function_key" , SecuritySchemeType.ApiKey, Name = " code" , In = OpenApiSecurityLocationType.Query)]
[OpenApiResponseWithBody(statusCode: HttpStatusCode.OK, contentType: " text/plain" , bodyType: typeof(string), Summary = " The response" , Description = " This returns the response" )]
// ???????????????????? 在上面添加OpenAPI 相关的修饰符 ????????????????????
[Function(" Function1" )]
public static HttpResponseData Run([HttpTrigger(AuthorizationLevel.Function, " get" , " post" )] HttpRequestData req,
FunctionContext executionContext)
{
...
}
一旦你完成了修饰符的添加，你就完成了!让我们运行这个应用程序。## 运行 Swagger UI通过输入 F5 键或单击 [Visual Studio](https://visualstudio.microsoft.com/?WT_mc_id=dotnet-38365-juyoo)上的调试按钮运行Function应用程序。
您将看到控制台中添加了OpenAPI相关的端点。
在web浏览器上运行[http://localhost:7071/api/swagger/ui](http://localhost:7071/api/swagger/ui)端点，您将看到Swagger UI页面。现在已正确实施具有 OpenAPI 功能的 Azure Function 应用。## 部署 Azure Function App – Windows你确认你的 Azure Function 应用工作正常。现在需要部署该项目。首先，单击解决方案资源管理器中的&
quot;
发布&
quot;
菜单。
选择&
quot;
Azure&
quot;
，然后选择&
quot;
Azure Functions App (Windows)&
quot;
。
您可以使用现有的 Function 应用程序实例或通过单击 :heavy\\_plus\\_sign: 按钮来创建一个新的应用程序实例。 这一次，让我们使用当前实例。一旦部署完成，在web浏览器上打开Azure Functions URL，你就会看到Swagger UI页面。
## 部署 Azure Function 应用 - Linux这一次，让我们将相同的应用程序部署到Linux实例。除此之外，让我们使用GitHub Actions。为了做到这一点，你必须将这个应用程序上传到GitHub存储库。因此，移动到&
quot;
Git Changes&
quot;
窗格并创建一个Git仓库。
如果你已经在[Visual Studio](https://visualstudio.microsoft.com/?WT_mc_id=dotnet-38365-juyoo)中登录了GitHub，你就可以创建一个存储库并推送代码。
一旦推送了所有代码，请访问 GitHub 以检查您的存储库是否已实际上传所有代码。
让我们回到发布屏幕，点击&
quot;
:heavy\\_plus\\_sign: New&
quot;
按钮来创建一个新的发布配置文件。
然后会出现一个类似的弹出窗口。这次让我们使用&
quot;
Azure Function App (Linux)&
quot;
菜单。
如前所述，您可以使用现有的实例或创建新的实例。我们就用现有的吧。
在前面的部署练习中，我们没有GitHub存储库。因此，我们不得不使用本地部署的方法。但这一次，我们有GitHub存储库，这意味着我们有选择。因此，这次我们不选择相同的部署方法，而是选择GitHub Actions。
GitHub Actions 工作流现已自动生成。 但这需要一个新的commit。
移至&
quot;
Git Changes&
quot;
窗格，输入如下所示的提交消息，单击&
quot;
Commit All&
quot;
按钮，然后推送更改。
当您实际访问您的 GitHub 存储库时，您的 GitHub 操作工作流会运行buil和部署。
一旦部署结束，打开一个新的web浏览器，访问Azure Functions应用程序URL，并发现Swagger UI页面被正确地呈现。
到目前为止，我们已经学习了如何创建一个[支持](https://github.com/Azure/azure-functions-openapi-extension/releases/tag/v0.8.1-preview)[OpenAPI](https://github.com/Azure/azure-functions-openapi-extension/releases/tag/v0.8.1-preview)的[Azure Functions](https://docs.microsoft.com/en-us/azure/azure-functions/functions-overview?WT.mc_id=dotnet-38365-juyoo)应用程序，在.Net 5独立的工作环境中运行，并无需离开[Visual Studio](https://visualstudio.microsoft.com/?WT_mc_id=dotnet-38365-juyoo)就将其部署到Azure。我猜理论上它也可以在。Net 6上很好运行。如果你好奇，请部署它，并在[https://github.com/Azure/azure-functions-openapi-extension/issues](https://github.com/Azure/azure-functions-openapi-extension/issues)上告诉我们！## 参考资料- Github 存储库: [Azure Functions OpenAPI扩展](https://github.com/Azure/azure-functions-openapi-extension/issues)- Microsoft 文档:[在Visual Studio中使用Azure Function和API管理集成创建无服务器API(预览版)](https://docs.microsoft.com/en-us/azure/azure-functions/openapi-apim-integrate-visual-studio?WT.mc_id=dotnet-38365-juyoo)- Microsoft学习平台: [Azure Functions: 发现OpenAPI和Power应用](https://www.youtube.com/playlist?list=PLlrxD0HtieHgTvUJGCtActXrPAI0XfXOa)推荐阅读
- go实现进程监控并启动
- 一个不起眼却非常实用的功能介绍
- 性能环境之docker操作指南3（全网最全）
- 一起玩转树莓派（12）——U型光电传感器
- 华为音频编辑服务带你一键伴奏分离！
- 记一次pg_rman备份postgresql数据库报段错误的处理过程
- win7系统端口139与455关闭可有效果保护电脑安全
- win7系统如何不待机 设置Win7不待机的技巧
- 用usb安装win7系统旗舰版需占用多大空间?