Azure Front Door部署What-If未显示自定义域名变更问题咨询

1. 确认条件开关参数值 #

自定义域名资源customDomainNew依赖customDomainDeploy条件判断，检查ci.json参数文件中customDomainDeploy的值是否设为true。如果该值为false，此资源会被跳过，路由中对它的引用也不会生效，What-If自然不会显示相关变更。

2. 验证路由资源的定义一致性 #

• 确认路由资源frontdoorendpointFrontEnd的名称frontend-v2和父资源frontdoorEndpointDefault（目标AFD端点）与现有环境中的资源完全匹配。如果名称或父资源指向错误，Bicep会认为是创建新路由而非修改现有路由，或者无法匹配到目标资源。
• 检查路由properties中省略的...部分，确保其他属性与现有资源的配置一致。如果存在未显式声明的属性差异，What-If可能会忽略部分变更，或者误判为无变更。

3. 统一API版本 #

自定义域名使用2022-05-01-preview，路由使用2022-11-01-preview，API版本不一致可能导致Azure资源管理器无法正确解析资源依赖和变更。将两个资源的API版本统一为同一稳定版（如2023-05-01）或同一预览版，避免版本差异带来的检测异常。

4. 检查资源引用的有效性 #

确保frontdoorProfile和frontdoorEndpointDefault的引用正确指向目标Front Door Premium配置文件和端点。如果父资源引用错误，自定义域名和路由资源会被部署到错误的目标，或者无法关联到现有资源，导致What-If无法检测到预期变更。

5. 调整What-If的检测范围 #

如果部分资源被标记为Ignore，可尝试以下操作：

• 改用资源组级部署命令az deployment group create（若所有目标资源都在同一资源组），缩小检测范围提升准确性。
• 添加--include-all-resources参数，强制What-If检测所有相关资源的变更：

  az deployment sub create -l eastus -f ./main.bicep -p ./Parameters/ci.json -w --include-all-resources
  

6. 排查Bicep的隐式依赖问题 #

确认customDomainNew和路由资源之间的依赖关系是否被正确识别。如果Bicep未自动推断依赖，可手动添加dependsOn：

resource frontdoorendpointFrontEnd 'Microsoft.Cdn/profiles/afdendpoints/routes@2023-05-01' = {
  parent: frontdoorEndpointDefault
  name: 'frontend-v2'
  dependsOn: [customDomainNew]
  properties: {
    customDomains: [
      { id: customDomainApp.id }
      { id: customDomainNew.id } 
    ]
    // 其他属性
  }
}

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