如何通过Terraform将Azure容器应用导入为API管理API？

核心问题拆解 #

你碰到的核心障碍有两个：

• Azure Container App的访问URL是动态生成的，无法提前硬编码
• azurerm_api_management_api的import块仅支持导入API的OpenAPI定义，而非直接关联Container App资源

实现步骤 #

1. 获取Container App的动态FQDN

Terraform的azurerm_container_app资源会自动输出fqdn属性，直接引用该属性即可获取容器应用的完整访问地址，无需手动拼接。

2. 确保容器应用暴露OpenAPI定义

你的容器应用必须提供可公开访问的Swagger/OpenAPI JSON端点（比如常见的/swagger/v1/swagger.json），这是APIM识别并导入API的必要前提。

3. 编写Terraform配置

结合以上两点，修改APIM API的配置，动态关联Container App的FQDN与Swagger端点：

# 定义Azure Container App资源
resource "azurerm_container_app" "example_api" {
  name                = "example-container-app"
  resource_group_name = azurerm_resource_group.example.name
  environment_id      = azurerm_container_app_environment.example.id

  template {
    container {
      name   = "api-service"
      image  = "${azurerm_container_registry.example.login_server}/api-image:latest"
      cpu    = "0.5"
      memory = "1.0Gi"

      ports {
        port     = 80
        protocol = "TCP"
      }
    }
  }

  ingress {
    external_enabled = true
    target_port      = 80
  }
}

# 配置APIM并导入Container App的API定义
resource "azurerm_api_management_api" "example" {
  name                = "example-api"
  resource_group_name = azurerm_resource_group.example.name
  api_management_name = azurerm_api_management.example.name
  revision            = "1"
  display_name        = "Example API"
  path                = "example"
  protocols           = ["https"]

  import {
    content_format = "swagger-link-json"
    # 动态拼接容器应用的FQDN和Swagger端点
    content_value  = "https://${azurerm_container_app.example_api.fqdn}/swagger/v1/swagger.json"
  }
}

Azure DevOps流水线集成要点 #

• 拆分流水线阶段：先完成Container App的部署（通过Terraform或Azure CLI），确保资源状态同步到Terraform状态文件
• 再执行APIM配置的Terraform部署，此时可正确获取容器应用的动态FQDN
• 若用Azure CLI部署Container App，可通过az containerapp show --name <app-name> --resource-group <rg-name> --query properties.configuration.ingress.fqdn -o tsv命令提取FQDN，传递给后续Terraform步骤作为变量

额外注意事项 #

• 网络连通性：如果Container App配置了VNet隔离，需将APIM加入同一VNet或配置对等连接，确保APIM能访问到Swagger端点
• 自定义域名：若使用自定义域名访问Container App，直接替换azurerm_container_app.example_api.fqdn为你的自定义域名即可
• 无Swagger定义场景：若API未提供Swagger，可手动编写OpenAPI JSON文件，通过content_format = "swagger-json"和content_value传入文件内容（或本地文件路径）

内容的提问来源于stack exchange，提问作者Al Imran