部署新键值前能否清空App Configuration所有键值？Bicep增量模式疑问

增量模式下Bicep只会管理模板中定义的资源，不会主动删除模板外的键值对。要实现「先清空再同步」的全量替换效果，有以下几种实用方案：

方案1：CI/CD流程前置删除命令 #

在执行Bicep部署前，先通过Azure CLI清空目标App Configuration的所有键值对，再进行增量部署。这种方式简单直接，适合嵌入GitHub Actions、Azure DevOps Pipeline等自动化流程。

示例Azure CLI脚本：

# 若CI/CD环境未自动登录，先完成身份验证
az login --service-principal -u $SP_ID -p $SP_SECRET --tenant $TENANT_ID

# 清空指定App Configuration的所有键值对
az appconfig kv delete --name <你的App配置实例名> --resource-group <资源组名> --all --yes

# 执行Bicep增量部署
az deployment group create --resource-group <资源组名> --template-file main.bicep --mode Incremental

注意：执行命令的账号/服务主体需拥有Microsoft.AppConfiguration/configurationStores/keyValues/delete权限。

方案2：Bicep嵌入部署脚本自动清空 #

把清空逻辑整合到Bicep文件中，使用Microsoft.Resources/deploymentScripts资源在部署键值对前自动执行删除操作。

示例Bicep代码：

param appConfigName string
param resourceGroupName string
param kvPairs array

// 部署脚本：清空所有键值对
resource clearKvScript 'Microsoft.Resources/deploymentScripts@2020-10-01' = {
  name: 'ClearAppConfigKv'
  location: resourceGroup().location
  kind: 'AzureCLI'
  properties: {
    azCliVersion: '2.50.0'
    scriptContent: '''
      az appconfig kv delete --name ${appConfigName} --resource-group ${resourceGroupName} --all --yes
    '''
    cleanupPreference: 'OnSuccess' // 成功后自动清理脚本资源
    timeout: 'PT5M'
  }
}

// 引用已存在的App Configuration实例
resource appConfigResource 'Microsoft.AppConfiguration/configurationStores@2023-03-01' existing = {
  name: appConfigName
}

// 部署键值对，依赖清空脚本执行完成
resource appConfigKv 'Microsoft.AppConfiguration/configurationStores/keyValues@2023-03-01' = [for kv in kvPairs: {
  parent: appConfigResource
  name: kv.key
  properties: {
    value: kv.value
    contentType: kv.contentType
  }
  dependsOn: [clearKvScript]
}]

注意：需确保部署账号拥有执行脚本和删除键值对的权限，同时根据实际情况调整脚本超时时间。

方案3：针对App Configuration实例单独使用完整模式 #

增量模式是针对资源组的，但可以通过嵌套部署，将完整模式的作用范围限定在App Configuration实例上，这样只会同步模板内的键值对、删除模板外的条目，不会影响资源组中的其他资源。

主Bicep文件示例：

param appConfigName string
param kvPairs array

// 引用已存在的App Configuration实例
resource appConfigResource 'Microsoft.AppConfiguration/configurationStores@2023-03-01' existing = {
  name: appConfigName
}

// 嵌套部署：仅对App Configuration实例使用完整模式
module kvDeployment 'kv-deployment.bicep' = {
  name: 'AppConfigKvFullDeployment'
  scope: appConfigResource // 限定部署范围到目标实例
  params: {
    kvPairs: kvPairs
  }
  deploymentMode: 'Complete' // 完整模式仅作用于该实例的键值对
}

配套的kv-deployment.bicep文件（仅定义键值对）：

param kvPairs array

resource appConfigKv 'Microsoft.AppConfiguration/configurationStores/keyValues@2023-03-01' = [for kv in kvPairs: {
  name: kv.key
  properties: {
    value: kv.value
    contentType: kv.contentType
  }
}]

这种方式纯Bicep实现，无需额外脚本，且不会误删资源组内其他资源，是最优雅的解决方案。

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