Partage via

Démarrage rapide : créer un magasin Azure App Configuration à l’aide de Bicep

  • Article

Ce guide de démarrage rapide décrit l’utilisation de Bicep pour :

  • déployer un magasin App Configuration.
  • créer des paires clé-valeur dans un magasin App Configuration.
  • lire des paires clé-valeur dans un magasin App Configuration.

Bicep est un langage spécifique à un domaine (DSL) qui utilise la syntaxe déclarative pour déployer des ressources Azure. Il fournit une syntaxe concise, une cohérence des types fiable et une prise en charge de la réutilisation du code. Bicep offre la meilleure expérience de création pour vos solutions d’infrastructure en tant que code dans Azure.

Prérequis

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Autorisation

Vous devez disposer d’un rôle de contributeur ou de propriétaire dans Azure Resource Manager pour pouvoir gérer la ressource Azure App Configuration avec un fichier Bicep. L’accès aux données Azure App Configuration (valeurs clés, captures instantanées) nécessite un rôle Azure Resource Manager et un rôle de plan de données Azure App Configuration supplémentaire lorsque le mode d’authentification ARM du magasin de configuration est défini sur mode d’authentification ARM pass-through.

Important

La configuration du mode d’authentification ARM nécessite la version 2023-08-01-preview ou ultérieure de l’API du plan de contrôle App Configuration.

Examiner le fichier Bicep

Le fichier Bicep utilisé dans ce guide de démarrage rapide est tiré des modèles de démarrage rapide Azure.

Notes

Les fichiers Bicep utilisent le même moteur sous-jacent que les modèles ARM. Tous les conseils, notes et informations importantes figurant dans le guide de démarrage rapide du modèle ARM s’appliquent ici. Il est recommandé de référencer ces informations lors de l’utilisation de fichiers 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
}

Deux ressources Azure sont définies dans le fichier Bicep :

Avec ce fichier Bicep, nous créons une clé avec deux valeurs différentes, dont l’une possède une étiquette unique.

Déployer le fichier Bicep

  1. Enregistrez le fichier Bicep en tant que main.bicep sur votre ordinateur local.

  2. Déployez le fichier Bicep à l’aide d’Azure CLI ou d’Azure PowerShell.

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

    Notes

    Remplacez <store-name> par le nom de votre magasin App Configuration.

    Une fois le déploiement terminé, un message doit s’afficher pour indiquer que le déploiement a réussi.

Vérifier les ressources déployées

Utilisez Azure CLI ou Azure PowerShell pour lister les ressources déployées dans le groupe de ressources.

az resource list --resource-group exampleRG

Vous pouvez également utiliser le portail Azure pour répertorier les ressources :

  1. Connectez-vous au portail Azure.
  2. Dans la zone de recherche, entrez App Configuration, puis sélectionnez App Configuration dans la liste.
  3. Sélectionnez la ressource App Configuration tout juste créée.
  4. Sous Opérations, sélectionnez Explorateur de configurations.
  5. Vérifiez que deux paires clé/valeur existent.

Nettoyer les ressources

Quand vous n’avez plus besoin du groupe de ressources ni de ses ressources, utilisez Azure CLI ou Azure PowerShell pour les supprimer.

az group delete --name exampleRG

Vous pouvez également utiliser le portail Azure pour supprimer le groupe de ressources :

  1. Accédez à votre groupe de ressources.
  2. Sélectionnez Supprimer le groupe de ressources.
  3. Un onglet s’affiche. Entrez le nom du groupe de ressources, puis sélectionnez Supprimer.

Étapes suivantes

Pour en savoir plus sur l’ajout d’un indicateur de fonctionnalité et d’une référence Key Vault à un magasin App Configuration, consultez les exemples de modèles ARM ci-dessous.