Поделиться через

Краткое руководство: создание хранилища Конфигурации приложений Azure с помощью Bicep

  • Статья

В этом кратком руководстве описывается, как использовать Bicep для выполнения следующих задач:

  • Развертывание хранилища Конфигурации приложений.
  • Создание пар "ключ —значение" в хранилище Конфигурации приложений.
  • Считывание пар "ключ —значение" в хранилище Конфигурации приложений.

Bicep — это предметно-ориентированный язык (DSL), который использует декларативный синтаксис для развертывания ресурсов Azure. Он обеспечивает краткий синтаксис, надежную безопасность типов и поддержку повторного использования кода. Bicep предлагает лучшие возможности для разработки решений Azure типа "инфраструктура как код".

Необходимые компоненты

Если у вас нет подписки Azure, создайте бесплатную учетную запись, прежде чем приступить к работе.

Авторизация

Для управления ресурсом Конфигурация приложений Azure с помощью Bicep-файла требуется роль Azure Resource Manager, например участник или владелец. Для доступа к данным Конфигурация приложений Azure (ключ-значения, моментальные снимки) требуется роль Azure Resource Manager и дополнительная роль плоскости данных Конфигурация приложений Azure, когда для режима проверки подлинности ARM хранилища конфигурации задан режим сквозной проверки подлинности ARM.

Внимание

Для настройки режима проверки подлинности ARM требуется Конфигурация приложений версия 2023-08-01-preview API уровня управления или более поздней версии.

Проверка BICEP-файла

Файл Bicep, используемый в этом кратком руководстве, взят из шаблонов быстрого запуска Azure.

Примечание.

Файлы Bicep используют тот же базовый механизм, что и шаблоны ARM. Все советы, примечания и важные сведения, приведенные в кратком руководстве по шаблону ARM, применимы и к этому руководству. Эти сведения полезны при работе с файлами Bicep.

@description('Specifies the name of the App Configuration store.')
param configStoreName string

@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@2021-10-01-preview' = {
  name: configStoreName
  location: location
  sku: {
    name: 'standard'
  }
}

resource configStoreKeyValue 'Microsoft.AppConfiguration/configurationStores/keyValues@2021-10-01-preview' = [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:

С помощью этого файла Bicep мы создадим один ключ с двумя разными значениями, одно из которых имеет уникальную метку.

Развертывание BICEP-файла

  1. Сохраните файл Bicep с именем main.bicep на локальном компьютере.

  2. Разверните файл Bicep с помощью Azure CLI или Azure PowerShell.

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

    Примечание.

    Замените параметр <store-name> именем хранилища Конфигурации приложений.

    После завершения развертывания должно отобразиться сообщение о том, что развертывание успешно выполнено.

Просмотр развернутых ресурсов

Используйте Azure CLI или Azure PowerShell для получения списка ресурсов, развернутых в группе ресурсов.

az resource list --resource-group exampleRG

Для вывода списка ресурсов также можно использовать портал Azure.

  1. Войдите на портал Azure.
  2. В поле поиска введите Конфигурация приложений, а затем выберите Конфигурация приложений из списка.
  3. Выберите созданный ресурс Конфигурации приложений.
  4. В разделе Операции выберите Обозреватель конфигураций.
  5. Убедитесь, что существует две пары "ключ-значение".

Очистка ресурсов

Чтобы удалить группу ресурсов и ее ресурсы, используйте портал Azure CLI или Azure PowerShell.

az group delete --name exampleRG

Удалить группу ресурсов также можно с помощью портала Azure:

  1. Перейдите к группе ресурсов.
  2. Выберите команду Удалить группу ресурсов.
  3. Откроется вкладка. Введите имя группы ресурсов, а затем нажмите кнопку Удалить.

Следующие шаги

Дополнительные сведения о добавлении флагов функций и ссылок Key Vault в хранилище службы "Конфигурация приложений" см. в примерах шаблонов ARM.