你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：使用 Bicep 创建 Azure 应用程序配置存储

项目
05/30/2024

本快速入门介绍如何使用 Bicep：

部署应用程序配置存储。
在应用程序配置存储创建关键值。
读取应用程序配置存储的密钥值。

Bicep 是一种特定于域的语言 (DSL)，使用声明性语法来部署 Azure 资源。它提供简明的语法、可靠的类型安全性以及对代码重用的支持。 Bicep 会针对你的 Azure 基础结构即代码解决方案提供最佳创作体验。

先决条件

如果没有 Azure 订阅，请在开始之前创建一个免费帐户。

授权

要使用 Bicep 文件管理 Azure 应用程序配置资源，需要 Azure 资源管理器角色，例如参与者或所有者。当配置存储的 ARM 身份验证模式设置为直通 ARM 身份验证模式时，访问 Azure 应用程序配置数据（密钥/值、快照）需要 Azure 资源管理器角色和其他 Azure 应用程序配置数据平面角色。

重要

配置 ARM 身份验证模式需要应用配置控制平面 API 版本 2023-08-01-preview 或更高版本。

查阅 Bicep 文件

本快速入门中使用的 Bicep 文件来自 Azure 快速入门模板。

注意

Bicep 文件使用与 ARM 模板相同的基础引擎。 ARM 模板快速入门中提供的所有提示、说明和重要信息在此处都适用。建议在处理 Bicep 文件时参考此信息。

@description('Specifies the name of the App Configuration store.')
param configStoreName string = 'appconfig${uniqueString(resourceGroup().id)}'

@description('Specifies the Azure location where the app configuration store should be created.')
param location string = resourceGroup().location

@description('Specifies the names of the key-value resources. The name is a combination of key and label with $ as delimiter. The label is optional.')
param keyValueNames array = [
  'myKey'
  'myKey$myLabel'
]

@description('Specifies the values of the key-value resources. It\'s optional')
param keyValueValues array = [
  'Key-value without label'
  'Key-value with label'
]

@description('Specifies the content type of the key-value resources. For feature flag, the value should be application/vnd.microsoft.appconfig.ff+json;charset=utf-8. For Key Value reference, the value should be application/vnd.microsoft.appconfig.keyvaultref+json;charset=utf-8. Otherwise, it\'s optional.')
param contentType string = 'the-content-type'

@description('Adds tags for the key-value resources. It\'s optional')
param tags object = {
  tag1: 'tag-value-1'
  tag2: 'tag-value-2'
}

resource configStore 'Microsoft.AppConfiguration/configurationStores@2024-05-01' = {
  name: configStoreName
  location: location
  sku: {
    name: 'standard'
  }
}

resource configStoreKeyValue 'Microsoft.AppConfiguration/configurationStores/keyValues@2024-05-01' = [for (item, i) in keyValueNames: {
  parent: configStore
  name: item
  properties: {
    value: keyValueValues[i]
    contentType: contentType
    tags: tags
  }
}]

output reference_key_value_value string = configStoreKeyValue[0].properties.value
output reference_key_value_object object = {
  name: configStoreKeyValue[1].name
  properties: configStoreKeyValue[1].properties
}

该 Bicep 文件中定义了两个 Azure 资源：

Microsoft.AppConfiguration/configurationStores：创建应用程序配置存储。
Microsoft.AppConfiguration/configurationStores/keyValues：在应用程序配置存储中创建一个键值。

使用此 Bicep 文件，我们将创建一个具有两个不同值的键，其中一个具有唯一标签。

部署 Bicep 文件

将该 Bicep 文件另存为本地计算机上的 main.bicep。

使用 Azure CLI 或 Azure PowerShell 来部署该 Bicep 文件。

CLI
PowerShell

az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters configStoreName=<store-name>

New-AzResourceGroup -Name exampleRG -Location eastus
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -configStoreName "<store-name>"

注意

将 <存储区名称> 替换为应用程序配置存储的名称。

部署完成后，应会看到一条指出部署成功的消息。

查看已部署的资源

使用 Azure CLI 或 Azure PowerShell 列出资源组中已部署的资源。

CLI
PowerShell

az resource list --resource-group exampleRG

Get-AzResource -ResourceGroupName exampleRG

还可使用 Microsoft Azure 门户列出资源：

登录到 Azure 门户。
在搜索框中，输入应用程序配置，然后从列表中选择应用程序配置。
选择新创建的应用程序配置资源。
在“操作”下，选择“配置资源管理器”。
验证有两个键值。

清理资源

如果不再需要资源组及其资源，请使用 Azure CLI 或 Azure PowerShell 将其删除。

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

还可以使用 Microsoft Azure 门户删除资源组：

导航到资源组。
选择“删除资源组”。
将显示一个选项卡。输入资源组名称，然后选择“删除”。

后续步骤

若要了解如何将功能标志和 Key Vault 引用添加到应用程序配置存储，请查看 ARM 模板示例。

通过