如何在Azure Functions中运行Terraform脚本？需用Durable Functions并行部署资源

一、前置准备 #

• 确保你的Azure Functions环境已配置完成，优先选PowerShell或Python作为运行时（这俩对Terraform的支持更顺畅）
• 在Function App的应用设置里配置Terraform所需的Azure认证变量：ARM_SUBSCRIPTION_ID、ARM_TENANT_ID、ARM_CLIENT_ID、ARM_CLIENT_SECRET，绝对别把密钥硬编码到代码里
• 要么把Terraform二进制文件打包进Function部署包，要么写个启动脚本在运行时自动下载对应版本的Terraform（推荐后者，能避免部署包体积过大）

二、Durable Functions核心结构设计 #

Durable Functions需要三个核心组件，各司其职：

1. Client函数（触发入口） #

用来启动整个编排流程，比如用HTTP触发器接收部署请求，把要部署的资源列表传进去。PowerShell示例代码：

param($Request, $TriggerMetadata)

$instanceId = Start-DurableOrchestration -FunctionName "TerraformParallelDeployOrchestrator" -Input $Request.Body.resourceGroups
Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = 202
    Body = @{
        instanceId = $instanceId
        statusQueryGetUri = "https://$($env:WEBSITE_HOSTNAME)/api/orchestrators/$instanceId"
    }
})

2. Orchestrator函数（并行编排核心） #

这是控制并行逻辑的关键，负责拆分任务、并行调用Activity函数。注意：Orchestrator必须是确定性的，不能有随机操作或依赖系统时间的逻辑。示例代码：

param($Context)

$resourceGroups = $Context.Input
$tasks = @()

# 给每个资源组创建一个并行执行的Activity任务
foreach ($rg in $resourceGroups) {
    $task = Start-DurableActivityFunction -FunctionName "RunTerraformDeployment" -Input $rg
    $tasks += $task
}

# 等待所有并行任务完成
$results = Wait-DurableActivityFunction -Task $tasks

return $results

3. Activity函数（实际执行Terraform） #

每个Activity对应一个独立的资源部署任务，负责跑Terraform的init、plan、apply流程。示例代码：

param($Context)

$rgConfig = $Context.Input
$workingDir = Join-Path $env:TEMP "terraform-$($rgConfig.name)"

# 创建临时工作目录，复制对应资源的Terraform配置（可以从Blob下载，或者打包在Function里）
New-Item -ItemType Directory -Path $workingDir -Force
Copy-Item -Path "./terraform-configs/$($rgConfig.type)/*" -Destination $workingDir -Recurse

Set-Location $workingDir

# 初始化Terraform
terraform init -input=false

# 执行部署，传入资源组名称、地域等变量
terraform apply -input=false -auto-approve -var "resource_group_name=$($rgConfig.name)" -var "location=$($rgConfig.location)"

# 捕获部署状态和输出
$output = terraform output -json
$status = if ($LASTEXITCODE -eq 0) { "Success" } else { "Failed" }

# 清理临时目录，避免占用存储
Remove-Item $workingDir -Recurse -Force

return @{
    resourceGroupName = $rgConfig.name
    status = $status
    output = $output
}

三、并行部署的关键注意事项 #

• 状态隔离：并行部署最容易踩的坑是Terraform状态文件冲突。必须用Azure Blob存储作为Terraform远程后端，给每个资源组分配独立的state文件路径：
  在Terraform配置里添加：

  backend "azurerm" {
    resource_group_name  = "tf-state-rg"
    storage_account_name = "tfstatestorageacc"
    container_name       = "tfstate"
    key                  = "${var.resource_group_name}/terraform.tfstate"
  }
  

• 错误处理：在Orchestrator里加异常捕获逻辑，比如某个Activity失败时，你可以选择继续等待其他任务完成，或者终止整个流程。示例：

  try {
      $results = Wait-DurableActivityFunction -Task $tasks
  } catch {
      Write-Error "部署失败：$_"
      # 根据业务需求，可选抛出异常终止编排，或者记录错误继续执行
      throw $_
  }
  

• 性能调优：根据Function App的定价层调整并发数，比如用Premium层能获得更多并行执行槽位，避免因为资源限制导致任务排队。

四、部署与测试 #

1. 把所有函数代码和Terraform配置文件打包部署到Azure Functions
2. 调用Client函数的HTTP端点，传入JSON格式的资源列表：

   {
       "resourceGroups": [
           {
               "name": "vm-rg",
               "type": "vm",
               "location": "eastus"
           },
           {
               "name": "storage-rg",
               "type": "storage",
               "location": "westus"
           }
       ]
   }
   

3. 通过返回的状态查询URL，查看并行部署的实时进度和最终结果

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