Azure DevOps发布管道中如何排除appsettings.json的CheckSiteNode参数

问题根源 #

你之前误用了XML转换格式的.transform文件处理JSON格式的appsettings.json，这种配置完全不生效——XML转换逻辑只针对XML文件，对JSON无效。以下是两种可行的解决方法：

方案一：利用Azure DevOps变量替换（推荐） #

1. 清理无效配置：删除appsettings.json.transform文件，取消File transform任务中的「XML转换」勾选，仅保留「JSON变量替换」选项。
2. 创建节点专属变量组：
   • 在Azure DevOps的「库」中，分别为Acc和Prod的3个节点创建变量组，比如Acc-Node1-Vars、Acc-Node2-Vars、Prod-Node3-Vars等。
   • 每个变量组内添加CheckSiteNode变量，对应设置值："This is node 1."、"This is node 2."（注意值需带引号，匹配JSON字符串格式）。
3. 配置发布作业：
   • 为Acc/Prod的每个节点创建独立的发布作业，每个作业关联对应的节点变量组。
   • 在File transform任务中，设置目标文件为**/appsettings.json，确保「JSON变量替换」已启用。
   • 基础版appsettings.json中可保留CheckSiteNode占位项（比如"CheckSiteNode": ""），变量替换会自动覆盖为节点专属值；若要彻底移除基础配置中的该项，可结合下方脚本先删除再添加。

方案二：PowerShell脚本动态修改配置文件 #

如果变量组方式不够灵活，可通过脚本在部署阶段动态调整配置：

1. 在发布管道中添加「PowerShell任务」，放置在File transform任务之前。
2. 使用以下脚本（根据实际节点标识调整判断逻辑）：

# 获取当前部署的节点标识（假设作业名称包含Node1/Node2/Node3）
$nodeId = "$(Release.DeploymentName)"
# 定位appsettings.json路径
$configFile = Get-ChildItem -Path "$(System.DefaultWorkingDirectory)" -Filter "appsettings.json" -Recurse | Select-Object -First 1 -ExpandProperty FullName

# 读取并转换JSON配置
$configContent = Get-Content $configFile -Raw | ConvertFrom-Json
# 移除原有CheckSiteNode项
$configContent.PSObject.Properties.Remove("CheckSiteNode")

# 根据节点添加专属配置
switch ($nodeId) {
    "Node1" { $configContent | Add-Member -MemberType NoteProperty -Name "CheckSiteNode" -Value "This is node 1." }
    "Node2" { $configContent | Add-Member -MemberType NoteProperty -Name "CheckSiteNode" -Value "This is node 2." }
    "Node3" { $configContent | Add-Member -MemberType NoteProperty -Name "CheckSiteNode" -Value "This is node 3." }
}

# 将修改后的配置写回文件
$configContent | ConvertTo-Json -Depth 10 | Set-Content $configFile

3. 确保脚本中的节点标识变量（如$(Release.DeploymentName)）能正确匹配你的部署作业命名。

注意事项 #

• 确认File transform任务的目标文件路径能准确匹配到appsettings.json，避免路径错误导致替换失效。
• 使用变量组时，需注意变量的作用域（环境/节点），防止不同节点间的变量冲突。
• 脚本方式需确保PowerShell任务拥有足够的文件修改权限。

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