基于Azure DevOps部署Azure Synapse自托管集成运行时的CI/CD指导咨询

一、自托管IR的部署方式 #

自托管IR是运行在私有环境的资源，没法直接通过ARM模板一键部署，得先在目标环境提前配置好：

• 手动创建：打开目标Synapse工作区，进入「集成运行时」页面，选「自托管」类型，跟着向导完成节点注册，记好IR的名称，后续要和ARM模板里的名称对应上。
• 脚本化创建：用Azure PowerShell命令New-AzSynapseIntegrationRuntime创建自托管IR的基础资源，之后可以手动注册节点，或者用注册密钥自动完成（适合批量部署多环境的场景）。

二、关联链接服务的参数化配置 #

链接服务里引用自托管IR的部分要和目标环境的IR名称匹配，同时敏感信息别硬编码，用Key Vault管理：

1. 在ARM模板的参数文件里加自托管IR名称的参数，示例：

"parameters": {
  "selfHostedIRName": {
    "type": "string",
    "defaultValue": "MySelfHostedIR"
  }
}

2. 修改链接服务的ARM模板，把IR名称换成参数引用：

"typeProperties": {
  "connectVia": {
    "referenceName": "[parameters('selfHostedIRName')]",
    "type": "IntegrationRuntimeReference"
  }
}

3. 像数据库密码这类敏感凭据，改成引用Key Vault的密钥：

"typeProperties": {
  "password": {
    "type": "AzureKeyVaultSecret",
    "store": {
      "referenceName": "[parameters('keyVaultName')]",
      "type": "LinkedServiceReference"
    },
    "secretName": "SqlServerPassword"
  }
}

三、Azure DevOps管道配置步骤 #

1. 模板导出与存储：从源Synapse工作区导出ARM模板，把模板和参数文件存到Azure Repos仓库，注意别包含自托管IR的定义（因为目标环境已经提前建好了）。
2. 管道阶段拆分：
   • 第一阶段：用Azure PowerShell任务检查目标环境的自托管IR是否存在，不存在就自动创建（可选，适合需要高自动化的场景）。
   • 第二阶段：用「Azure Resource Group Deployment」任务部署Synapse资源，指定模板文件和对应环境的参数文件，确保参数里的IR名称和目标环境一致。
   • 第三阶段：如果有需要，用PowerShell任务更新链接服务的凭据引用，前提是要确保Azure DevOps的服务主体有Key Vault的访问权限。

四、关键注意事项 #

• 部署前要确认目标环境的自托管IR节点处于在线状态，不然依赖它的链接服务会报错。
• 不同环境（开发/测试/生产）的IR名称可以统一，也可以通过参数文件区分，避免环境混淆。
• 给Azure DevOps的服务主体配置好权限：至少要有Synapse Contributor权限，以及Key Vault的Secrets User权限，确保能正常读取密钥和部署资源。

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