如何通过Azure DevOps部署非Git集成ADF的ARM模板并替换文本

没问题，我来一步步帮你搞定这个流程——从让Azure DevOps Pipeline获取到你的ARM模板，到替换指定文本，再部署到目标ADF实例，全程给你讲明白：

首先得让DevOps能访问到你导出的ARM模板。你可以把下载好的模板文件（一般是arm-template.json和arm-template-parameters.json）上传到Azure DevOps的Git仓库里——不管是新建一个专门的仓库，还是放到现有仓库的某个目录下都行，比如/adf-deployment-templates这个路径。

推荐用YAML格式的Pipeline，灵活性更高，也方便版本控制。下面是完整的Pipeline示例，我会拆解开每个部分的作用：

2.1 基础Pipeline配置 #

先定义触发条件和运行代理：

trigger:
  branches:
    include:
      - main  # 你上传模板的分支名称
pool:
  vmImage: 'ubuntu-latest'  # 用Ubuntu代理，方便执行Shell脚本

2.2 用Shell脚本替换JSON文本 #

你要替换的路径文本可以用Linux的sed命令轻松实现，这是Pipeline里做简单文本替换的常用方式。添加一个脚本步骤：

steps:
- script: |
    # 替换主模板里的路径字符串
    sed -i 's/instance01\/tmp\/file/instance02\/tmp\/file/g' $(Build.SourcesDirectory)/adf-deployment-templates/arm-template.json
    # 如果参数文件里也有需要替换的内容，同样执行sed命令
    sed -i 's/instance01\/tmp\/file/instance02\/tmp\/file/g' $(Build.SourcesDirectory)/adf-deployment-templates/arm-template-parameters.json
  displayName: 'Replace placeholder paths in ARM templates'

👉 注意：因为路径里的/是sed的默认分隔符，所以要转义成\/，不然sed会识别错误；g表示全局替换，会把文件里所有匹配的字符串都换掉。

2.3 部署ARM模板到目标ADF #

接下来用Azure Resource Manager模板部署任务，把修改后的模板部署到目标ADF实例。首先要确保你已经在Azure DevOps里创建了Azure服务连接，授权它访问目标订阅和ADF资源。然后添加部署步骤：

- task: AzureResourceManagerTemplateDeployment@3
  inputs:
    deploymentScope: 'Resource Group'
    azureResourceManagerConnection: '<你的Azure服务连接名称>'
    subscriptionId: '<目标ADF所在的订阅ID>'
    action: 'Create Or Update Resource Group'
    resourceGroupName: '<目标ADF所在的资源组名称>'
    location: '<资源组区域，比如East US>'
    templateLocation: 'Linked artifact'
    csmFile: '$(Build.SourcesDirectory)/adf-deployment-templates/arm-template.json'
    csmParametersFile: '$(Build.SourcesDirectory)/adf-deployment-templates/arm-template-parameters.json'
    deploymentMode: 'Incremental'  # 增量部署，不会删除目标ADF里的现有资源
    deploymentName: 'ADFDeploymentPipeline'

👉 关于deploymentMode：选Incremental是最安全的，只会添加或更新模板中定义的资源，不会改动目标ADF里已有的其他内容；如果需要完全覆盖（清空目标ADF再部署），可以选Complete，但一定要谨慎使用。

• 如果你的ARM模板里有敏感信息（比如数据库连接字符串），别硬编码在参数文件里，建议用Azure Key Vault存储，然后在Pipeline里引用密钥，安全性更高。
• 测试阶段可以先在非生产环境跑一遍Pipeline，确认文本替换和部署都正常后，再推广到生产环境。
• 如果有大量需要替换的变量，也可以用Azure DevOps的变量组来管理，然后在Pipeline里用变量替换语法（比如${{ variables.myVariable }}），比sed更灵活，但sed对于简单的单文本替换已经足够高效了。

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