将功能定义定义为API管理，作为CI流程的一部分

Question

我们希望在每部部署Azure函数的情况下将函数定义导入函数定义的过程自动化。在Azure门户中，有一种非常简单的方法可以通过UI导入函数定义，但是它们似乎并不是任何API/CLI/POWERSHELL库来自动化此过程。

我们设法创建了一个解决方法，该解决方法涉及使用C＃保持函数应用程序的最新定义。 OpenAPI库，然后使用az apim导入 cli命令作为我们部署管道的一部分，但感觉就像额外的工作保持OpenAPI定义的最新定义，并且在我们功能的每个端点上都准确，并且最可取要自动将门户网站在引擎盖下导入函数应用程序时所做的事情（这不需要OpenAPI定义在源代码中保持最新状态）。任何帮助将不胜感激。

我们正在为CI/CD管道和释放使用Azure DevOps。

Answer 1

您有一些选择。您没有指定您是否已经有一些现有的基础架构CI工具，但是我最熟悉在Terraform中这样做。

有关如何将Terraform设置到管道中的教程。

一旦您将Terraform整合到了Terraform之后，就可以轻松将API定义添加到您的APIM实例中。并将其链接到您的功能后端。

文章及其一些代码样本：

resource "azurerm_api_management_backend" "example" {
  name                = "example-backend"
  resource_group_name = data.azurerm_resource_group.example.name
  api_management_name = data.azurerm_api_management.example.name
  protocol            = "http"
  url                 = "https://${azurerm_function_app.example.name}.azurewebsites.net/api/"

  credentials {
    header = {
      "x-functions-key" = "${data.azurerm_function_app_host_keys.example.default_function_key}"
    }
  }
}

resource "azurerm_api_management_api" "example" {
  name                = "example-api"
  resource_group_name = data.azurerm_resource_group.example.name
  api_management_name = data.azurerm_api_management.example.name
  revision            = "1"
  display_name        = "Example API"
  path                = "example"
  protocols           = ["https"]

  import {
    content_format = "openapi"
    content_value  = file("${path.module}/FuncOpenAPI3.yml")
  }
}

resource "azurerm_api_management_api_policy" "example" {
  api_name            = azurerm_api_management_api.example.name
  api_management_name = azurerm_api_management_api.example.api_management_name
  resource_group_name = azurerm_api_management_api.example.resource_group_name

  xml_content = <<XML
<policies>
  <inbound>
    <base/>
    <set-backend-service backend-id="example-backend" />
  </inbound>
</policies>
XML
}

现在，正如您在本文中看到的那样，它谈到了导入OpenAPI文件以定义实际API。没有一个很好的方法可以自动执行此操作，但是有一种使用Swagger的内置的Tofile工具：

<Target Name="PostBuild" AfterTargets="PostBuildEvent">
    <Exec Command="dotnet tool restore" />
    <Exec Command="dotnet swagger tofile --output swagger.json $(OutputPath)\$(AssemblyName).dll v1 " />
</Target>

当您在管道中运行构建时，将生成此文件，然后您可以在基础架构阶段将其引用OpenAPI文件自动在APIM中生成该API。