Importer ou exporter des données de configuration

Azure App Configuration prend en charge les opérations d’importation et d’exportation de données. Utilisez ces opérations pour utiliser des données de configuration en bloc et échanger des données entre votre magasin App Configuration et votre projet de code. Par exemple, vous pouvez configurer un magasin App Configuration pour les tests et un autre pour la production. Vous pouvez copier les paramètres d’application entre eux afin de ne pas avoir à entrer de données deux fois.

Cet article fournit un guide pour l’importation et l’exportation de données à l’aide du portail Azure ou d’Azure CLI. Si vous avez adopté configuration en tant que code et gérez vos configurations dans GitHub ou Azure DevOps, vous pouvez configurer l’importation continue du fichier de configuration à l’aide de GitHub Actions ou utiliser la tâche d’importation de pipeline Azure.

Importer des données

L’importation apporte des données de configuration dans un magasin App Configuration à partir d’une source existante. Utilisez la fonction d’importation pour migrer des données vers un magasin App Configuration ou agréger des données à partir de plusieurs sources.

Ce guide montre comment importer des données App Configuration :

• à partir d’un fichier de configuration dans JSON, YAML ou Properties
• depuis un répertoire App Configuration
• à partir d’Azure App Service
• à partir d’Azure Kubernetes Service ConfigMaps

Importer des données à partir d’un fichier de configuration

Suivez les étapes ci-dessous pour importer des valeurs de clé à partir d’un fichier.

Portal

À partir du portail Azure, procédez comme suit :

1. Accédez à votre magasin App Configuration, puis sélectionnez Importer/exporter dans le menu Opérations .

   

2. La case d’option Importer est sélectionnée par défaut. Sous Type de source, sélectionnez Fichier de configuration.

3. Remplissez le formulaire avec les paramètres suivants :

   Paramètre	Descriptif	Example
   Type de fichier	Sélectionnez le type de fichier à importer : YAML, Properties ou JSON.	JSON

4. Cliquez sur le bouton Parcourir , puis sélectionnez le fichier à importer.

5. Remplissez la partie suivante du formulaire :

   Paramètre	Descriptif	Example
   Profil de contenu de fichier	Sélectionnez un profil de contenu : par défaut ou KVSet. Le profil de contenu de fichier par défaut fait référence au schéma de fichier de configuration classique largement adopté par les frameworks ou systèmes de programmation existants, prend en charge les formats de fichier JSON, YAML ou Properties. Le profil de contenu de fichier KVSet fait référence à un schéma de fichier qui contient toutes les propriétés d’une clé-valeur App Configuration, notamment la clé, la valeur, l’étiquette, le type de contenu et les balises.	Par défaut
   Mode d’importation	Le mode d’importation est utilisé pour déterminer s’il faut ignorer les valeurs de clé identiques. Avec l’option Ignorer la correspondance, n'importe quels couples clé-valeur dans le stockage qui sont identiques à ceux du fichier de configuration sont ignorés. Avec l’option All , toutes les valeurs de clé dans le fichier de configuration sont mises à jour.	Ignorer la correspondance
   Exclure l’indicateur de fonctionnalité	Si cette option est activée, les indicateurs de fonctionnalité ne sont pas importés.	Non coché
   Strict	Si la case est cochée, toutes les valeurs de clé dans le magasin avec le préfixe et l’étiquette spécifiés qui ne sont pas inclus dans le fichier de configuration sont supprimées lorsque le profil de contenu fichier est défini sur Par défaut. Lorsque le profil de contenu de fichier est défini sur KVSet, toutes les valeurs clés du magasin qui ne sont pas incluses dans le fichier de configuration sont supprimées. Si la case n’est pas cochée, aucune clé-valeur dans le magasin n’est supprimée.	Non coché
   Séparateur	Le séparateur est le délimiteur utilisé pour aplatir les fichiers JSON ou YAML en clé-valeur. Elle sera ignorée pour les fichiers de propriétés et les indicateurs de fonctionnalité. Les valeurs prises en charge incluent le séparateur sans séparateur, la virgule (.), la virgule (,), le point-virgule (;), le trait d’union (-), le trait de soulignement (_), le trait de soulignement double (_), la barre oblique (/) et le signe deux-points (:).	:
   Profondeur	Optional. Profondeur pour aplatir des fichiers JSON ou YAML en paires clé-valeur. Par défaut, les fichiers sont aplatis au niveau le plus profond si un séparateur est sélectionné. Ce paramètre n’est pas applicable aux fichiers de propriétés ou aux indicateurs de fonctionnalité.
   Ajouter un préfixe	Optional. S’il est spécifié, un préfixe est ajouté aux noms de clés de toutes les valeurs de clé importées.	TestApp :
   Ajouter une étiquette	Optional. Si elle est spécifiée, l’étiquette fournie est affectée à toutes les valeurs de clé importées.	prod
   Ajouter un type de contenu	Optional. S’il est spécifié, le type de contenu fourni est ajouté à toutes les valeurs de clé importées.	JSON (application/json)
   Ajouter des balises	Optional. Si elle est spécifiée, les balises fournies sont ajoutées à toutes les valeurs de clé importées.	{tag : tag1}

6. Sélectionnez Appliquer pour poursuivre l’importation.

Vous avez correctement importé des valeurs de clé à partir d’un fichier JSON. Les noms de clés ont été aplatits à l’aide du : séparateur et préfixés par TestApp:. Toutes les valeurs de clé importées sont étiquetées comme prod, avec un type de application/jsoncontenu et marquées avec tag: tag1.

Azure CLI

À partir d’Azure CLI, suivez les étapes ci-dessous. Si azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

1. Entrez la commande az appconfig kv import d’importation et ajoutez les paramètres suivants :

   Paramètre	Descriptif	Example
   --name	Entrez le nom du magasin App Configuration dans lequel vous souhaitez importer des données.	my-app-config-store
   --source	Entrez file pour indiquer que vous importez des données de configuration d’application à partir d’un fichier.	file
   --path	Entrez le chemin d’accès local au fichier contenant les données que vous souhaitez importer.	C:/Users/john/Downloads/data.json
   --format	Entrez yaml, propriétés ou json pour indiquer le format du fichier que vous importez.	json

2. Si vous le souhaitez, ajoutez également les paramètres suivants :

   Paramètre	Descriptif	Example
   --separator	Optional. Le séparateur est le délimiteur permettant d’aplatir les clés-valeurs en JSON/YAML. Il est nécessaire pour exporter la structure hiérarchique et sera ignoré pour les fichiers de propriétés et les indicateurs de fonctionnalité. Sélectionnez l’une des options suivantes : ., ,:;/-, _, . —	;
   --prefix	Optional. Un préfixe de clé est la partie de début d’une clé. Les préfixes peuvent être utilisés pour gérer des groupes de paires clé-valeur dans un magasin de configuration. Ce préfixe est ajouté à l’avant de la propriété « key » de chaque clé-valeur importée.	TestApp:
   --label	Optional. Entrez une étiquette qui sera affectée à vos valeurs de clé importées.	prod
   --content-type	Optional. Entrez appconfig/kvset ou application/json pour indiquer que le contenu importé se compose d'une référence à Key Vault ou d'un fichier JSON.	application/json

   Exemple : importez toutes les valeurs clés et indicateurs de fonctionnalité à partir d’un fichier JSON, appliquez l’étiquette « prod » et ajoutez le préfixe « TestApp ». Ajoutez le type de contenu « application/json ».

   az appconfig kv import --name my-app-config-store --source file --path D:/abc.json --format json --separator ; --prefix TestApp: --label prod --content-type application/json
   

3. La ligne de commande affiche une liste des modifications à venir. Confirmez l’importation en sélectionnant y.

   

Vous avez importé des valeurs de clé à partir d’un fichier JSON, puis vous leur avez attribué l’étiquette « prod » et le préfixe « TestApp : ». Le séparateur « ; » est utilisé et toutes les valeurs clés que vous avez importées ont le type de contenu défini sur « JSON ».

Pour obtenir des paramètres et des exemples facultatifs, accédez à az appconfig kv import.

Importer des données à partir d’un magasin App Configuration

Vous pouvez importer des valeurs d’un magasin App Configuration vers un autre magasin App Configuration, ou importer des valeurs d’un magasin App Configuration vers le même magasin App Configuration afin de dupliquer ses valeurs et d’appliquer différents paramètres, tels que le nouveau type d’étiquette ou de contenu.

Suivez les étapes ci-dessous pour importer des indicateurs de clés et de fonctionnalités à partir d’un magasin Azure App Configuration.

Portal

À partir du portail Azure, procédez comme suit :

1. Accédez à votre magasin App Configuration, puis sélectionnez Importer/exporter dans le menu Opérations .

   

2. La case d’option Importer est sélectionnée par défaut. Sous Type de source, sélectionnez App Configuration.

3. Sélectionnez un magasin App Configuration à partir duquel importer des données, puis remplissez le formulaire avec les paramètres suivants :

   Paramètre	Descriptif	Example
   Subscription	Votre abonnement actuel est sélectionné par défaut.	my-subscription
   groupe de ressources	Sélectionnez un groupe de ressources qui contient le magasin App Configuration avec la configuration à importer. Votre groupe de ressources actuel est sélectionné par défaut.	my-resource-group
   Resource	Sélectionnez le magasin App Configuration qui contient la configuration à importer.	my-other-app-config-store

4. Remplissez la partie suivante du formulaire :

   Paramètre	Descriptif	Example
   Mode sélection	Indiquez s’il faut importer à partir de valeurs de clé régulières, qui est l’option par défaut ou à partir d’un instantané.	Par défaut
   Filtre principal	Permet de filtrer les valeurs de clé en fonction du nom de clé pour l’importation. Si aucune clé n’est spécifiée, toutes les clés sont éligibles.	Commence par le test
   À un moment spécifique	Optional. Renseignez ce champ pour importer des valeurs de clé à partir d’un point spécifique dans le temps dans le magasin de configuration sélectionné. Si vous ne le renseignez pas, ce champ est défini par défaut sur le point dans le temps actuel des paires clé-valeur.	28/07/2022 12:00:00
   Depuis l'étiquette	Sélectionnez une ou plusieurs étiquettes pour importer des valeurs de clé associées à ces étiquettes. Si aucune étiquette n’est sélectionnée, toutes les étiquettes sont éligibles.	prod
   Exclure l’indicateur de fonctionnalité	Si cette option est activée, les indicateurs de fonctionnalité ne sont pas importés.	Non coché
   Ajouter un préfixe	Optional. S’il est spécifié, un préfixe est ajouté aux noms de clés de toutes les valeurs de clé importées.	TestApp :
   Remplacer les étiquettes	Optional. Par défaut, les étiquettes d’origine des valeurs de clé source sont conservées. Pour les remplacer, cochez la case et entrez une nouvelle étiquette pour les valeurs de clé importées.	Nouveau
   Remplacer les types de contenu	Optional. Par défaut, les types de contenu d’origine des valeurs de clé source sont conservés. Pour les remplacer, cochez la case et entrez un nouveau type de contenu pour les valeurs de clé importées. Notez que le type de contenu des indicateurs de fonctionnalité ne peut pas être substitué.	JSON (application/json)

5. Sélectionnez Appliquer pour poursuivre l’importation.

Vous avez importé des valeurs de clé à partir d’un magasin App Configuration à partir du 28 janvier 2021, à 12 heures, avec des noms de clés commençant par test et l’étiquette prod. Les noms de clés ont été précédés de TestApp:. Toutes les valeurs de clé importées ont été affectées à l’étiquette new et au type application/jsonde contenu.

Azure CLI

À partir d’Azure CLI, suivez les étapes ci-dessous. Si azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

1. Entrez la commande az appconfig kv import d’importation et entrez les paramètres suivants :

   Paramètre	Descriptif	Example
   --name	Entrez le nom du magasin App Configuration dans lequel vous souhaitez importer des données	my-app-config-store
   --source	Entrez appconfig pour indiquer que vous importez des données à partir d'une boutique App Configuration.	appconfig
   --src-name	Entrez le nom du magasin App Configuration à partir duquel vous souhaitez importer des données.	my-source-app-config
   --src-label	Limitez votre importation aux valeurs clés avec une étiquette spécifique. Si vous n’utilisez pas ce paramètre, seules les valeurs clés avec une étiquette Null sont importées. Prend en charge le signe en étoile comme filtre : entrez * pour toutes les étiquettes ; abc* pour toutes les étiquettes avec abc comme préfixe.	prod

2. Ajoutez éventuellement les paramètres suivants :

   Paramètre	Descriptif	Example
   --label	Optional. Entrez une étiquette qui sera affectée à vos valeurs de clé importées.	new
   --content-type	Optional. Entrez appconfig/kvset ou application/json pour indiquer que le contenu importé se compose d'une référence à Key Vault ou d'un fichier JSON. Le type de contenu ne peut être remplacé que par des clés-valeurs importées. Le type de contenu par défaut pour les indicateurs de fonctionnalité est « application/vnd.microsoft.appconfig.ff+json ; charset=utf-8' par défaut et n’est pas mis à jour par ce paramètre.	application/json

   Exemple : importez des valeurs clés et des indicateurs de fonctionnalité avec l’étiquette « prod » à partir d’une autre App Configuration, puis affectez-les à l’étiquette « new ». Ajoutez le type de contenu « application/json ».

   az appconfig kv import --name my-app-config-store --source appconfig --src-name my-source-app-config --src-label prod --label new --content-type application/json
   

3. La ligne de commande affiche une liste des modifications à venir. Confirmez l’importation en sélectionnant y.

   

Vous avez importé des paires clé-valeur avec l’étiquette « prod » à partir d’un magasin App Configuration, et vous leur avez attribué l’étiquette « new ». Toutes les valeurs de clé que vous avez importées ont le type de contenu défini sur « JSON ».

Pour obtenir des paramètres et des exemples facultatifs, accédez à az appconfig kv import.

Importer des données à partir d’Azure App Service

Suivez les étapes ci-dessous pour importer des valeurs clés à partir d’Azure App Service.

Note

App Service ne prend actuellement pas en charge les indicateurs de fonctionnalité. Tous les indicateurs de fonctionnalité importés dans App Service sont convertis automatiquement en valeurs clés. Vos ressources App Service ne peuvent contenir que des valeurs de clé.

Portal

À partir du portail Azure :

1. Accédez à votre magasin App Configuration, puis sélectionnez Importer/exporter dans le menu Opérations .

   

2. La case d’option Importer est sélectionnée par défaut. Sous Type de source, sélectionnez App Services.

3. Sélectionnez un magasin App Configuration à partir duquel importer des données, puis remplissez le formulaire avec les paramètres suivants :

   Paramètre	Descriptif	Example
   Subscription	Votre abonnement actuel est sélectionné par défaut.	my-subscription
   groupe de ressources	Sélectionnez un groupe de ressources qui contient App Service avec la configuration à importer.	my-resource-group
   Resource	Sélectionnez App Service qui contient la configuration à importer.	my-app-service

4. Remplissez la partie suivante du formulaire :

   Paramètre	Descriptif	Example
   Mettre à jour les paramètres pour référencer	Si cette option est cochée, les paramètres de l’application dans App Service sont mis à jour vers les références App Configuration pour les valeurs de clé importées. Cela vous permet de gérer les paramètres de votre application dans App Configuration à l’avenir. Votre App Service extrait automatiquement la valeur actuelle d’App Configuration. Pour en savoir plus, consultez Références de la configuration d'application pour App Service et Azure Functions.	Cochée
   Ajouter un préfixe	Optional. S’il est spécifié, un préfixe est ajouté aux noms de clés de toutes les valeurs de clé importées.	TestApp :
   Ajouter une étiquette	Optional. Si elle est spécifiée, l’étiquette fournie est affectée à toutes les valeurs de clé importées.	prod
   Ajouter un type de contenu	Optional. S’il est spécifié, le type de contenu fourni est ajouté à toutes les valeurs de clé importées.	JSON (application/json)

5. Sélectionnez Appliquer pour poursuivre l’importation.

Vous avez importé tous les paramètres d’application à partir d’un App Service en tant que valeurs clés, puis vous leur avez attribué l’étiquette prod et le préfixe TestApp:. Toutes les valeurs clés que vous avez importées ont le type de contenu défini comme application/json.

Azure CLI

À partir d’Azure CLI, suivez les étapes ci-dessous. Si azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

1. Entrez la commande az appconfig kv import d’importation et ajoutez les paramètres suivants :

   Paramètre	Descriptif	Example
   --name	Entrez le nom du magasin App Configuration dans lequel vous souhaitez importer des données.	my-app-config-store
   --source	Entrez appservice pour indiquer que vous importez des données de configuration d’application à partir d’Azure App Service.	appservice
   --appservice-account	Entrez l’ID ARM d’App Service ou utilisez le nom d’App Service, s’il se trouve dans le même abonnement et le même groupe de ressources que App Configuration.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service ou my-app-service

2. Si vous le souhaitez, ajoutez également les paramètres suivants :

   Paramètre	Descriptif	Example
   --prefix	Optional. Un préfixe de clé correspond au début d’une propriété « clé » d’une paire clé-valeur. Les préfixes peuvent être utilisés pour gérer des groupes de paires clé-valeur dans un magasin de configuration. Ce préfixe est ajouté à l’avant de la propriété « key » de chaque clé-valeur importée.	TestApp:
   --label	Optional. Entrez une étiquette qui sera affectée à vos valeurs de clé importées. Si vous ne spécifiez pas d’étiquette, l’étiquette Null est affectée à vos valeurs de clé.	prod
   --content-type	Optional. Entrez appconfig/kvset ou application/json pour indiquer que le contenu importé se compose d’une référence Key Vault ou d’un fichier JSON.	application/json

   Pour obtenir la valeur pour --appservice-account, utilisez la commande az webapp show --resource-group <resource-group> --name <resource-name>.

   Exemple : importez tous les paramètres d’application à partir de votre App Service en tant que valeurs clés avec l’étiquette « prod », dans votre magasin App Configuration et ajoutez un préfixe « TestApp : ».

   az appconfig kv import --name my-app-config-store --source appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service --label prod --prefix TestApp:
   

3. La ligne de commande affiche une liste des modifications à venir. Confirmez l’importation en sélectionnant y.

   

Vous avez importé tous les paramètres d’application à partir de votre App Service en tant que valeurs de clé, leur avez attribué l’étiquette « prod » et ajouté un préfixe « TestApp : ». Toutes les valeurs clés que vous avez importées ont le type de contenu défini sur « JSON ».

Pour obtenir des paramètres et des exemples facultatifs, accédez à az appconfig kv import.

Importer des données à partir d’Azure Kubernetes Service ConfigMaps

Suivez les étapes ci-dessous pour importer des valeurs clés à partir d’Azure Kubernetes Service ConfigMaps. La prise en charge du portail pour cette fonctionnalité est en cours de développement, utilisez Azure CLI pour importer à partir d’AKS.

Portal

La prise en charge du portail Azure pour cette fonctionnalité est en cours de développement.

Azure CLI

À partir d’Azure CLI, suivez les étapes ci-dessous. Si azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

1. Entrez la commande az appconfig kv import d’importation et ajoutez les paramètres suivants :

   Paramètre	Descriptif	Example
   --name	Entrez le nom du magasin App Configuration dans lequel vous souhaitez importer des données.	my-app-config-store
   --source	Entrez aks pour indiquer que vous importez des données de configuration d’application depuis Azure Kubernetes Service.	aks
   --aks-cluster	Entrez l’ID ARM d’Azure Kubernetes Service ou utilisez le nom d’Azure Kubernetes Service, s’il se trouve dans le même abonnement et le même groupe de ressources que App Configuration.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster ou my-aks-cluster
   --configmap-namespace	Entrez l’espace de noms du ConfigMap que vous souhaitez importer.	default
   --configmap-name	Entrez le nom du ConfigMap que vous souhaitez importer.	my-configmap

2. Si vous le souhaitez, ajoutez également les paramètres suivants :

   Paramètre	Descriptif	Example
   --prefix	Optional. Un préfixe de clé correspond au début d’une propriété « clé » d’une paire clé-valeur. Les préfixes peuvent être utilisés pour gérer des groupes de paires clé-valeur dans un magasin de configuration. Ce préfixe est ajouté à l’avant de la propriété « key » de chaque clé-valeur importée.	TestApp:
   --label	Optional. Entrez une étiquette qui sera affectée à vos valeurs de clé importées. Si vous ne spécifiez pas d’étiquette, l’étiquette Null est affectée à vos valeurs de clé.	test
   --content-type	Optional. Entrez appconfig/kvset ou application/json pour indiquer que le contenu importé se compose d’une référence Key Vault ou d’un fichier JSON.	application/json
   --format	Optional. Entrez yaml, propriétés ou json pour indiquer le format de ConfigMap que vous importez.	json
   --separator	Optional. Le séparateur est le délimiteur permettant d’aplatir les clés-valeurs. Il est nécessaire pour exporter la structure hiérarchique et sera ignoré pour les fichiers de propriétés et les indicateurs de fonctionnalité. Sélectionnez l’une des options suivantes : ., ,:;/-, _, . —	;

   Pour obtenir la valeur pour --aks-cluster, utilisez la commande az aks show --resource-group <resource-group> --name <aks-cluster-name>.

   Exemple : importez tous les paramètres de votre configmap AKS en tant que valeurs clés avec l’étiquette « test », dans votre magasin App Configuration, puis ajoutez un préfixe « TestApp : ».

   az appconfig kv import --name my-app-config-store --source aks --aks-cluster /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster --configmap-namespace default --configmap-name my-configmap --label test --prefix TestApp:
   

3. La ligne de commande affiche une liste des modifications à venir. Confirmez l’importation en sélectionnant y.

   

Vous avez importé tous les paramètres de votre ConfigMap AKS en tant que valeurs clés, leur avez attribué l’étiquette « test », puis ajouté un préfixe « TestApp : ».

Pour obtenir des paramètres et des exemples facultatifs, accédez à az appconfig kv import.

Exportation des données

Exportez les données de configuration stockées dans App Configuration vers une autre destination. Utilisez la fonction d’exportation, par exemple, pour enregistrer des données d’un magasin App Configuration dans un fichier qui peut être incorporé dans votre code d’application pendant le déploiement.

Ce guide montre comment exporter des données App Configuration :

• dans un fichier de configuration dans JSON, YAML ou Properties
• vers un magasin App Configuration
• vers une ressource Azure App Service

Exporter des données vers un fichier de configuration

Procédez comme suit pour exporter des données de configuration d’un magasin App Configuration vers un fichier JSON, YAML ou Properties.

Portal

À partir du portail Azure, procédez comme suit :

1. Accédez à votre magasin App Configuration, puis sélectionnez Importer/exporter.

   

2. Sélectionnez la case d’option Exporter et, sous Type cible, sélectionnez Fichier de configuration.

3. Remplissez le formulaire avec les paramètres suivants :

   Paramètre	Descriptif	Example
   Type de fichier	Sélectionnez le type de fichier à exporter : YAML, Properties ou JSON.	JSON
   Profil de contenu de fichier	Sélectionnez un profil de contenu : par défaut ou KVSet. Le profil de contenu de fichier par défaut fait référence au schéma de fichier de configuration classique largement adopté par les frameworks ou systèmes de programmation existants, prend en charge les formats de fichier JSON, YAML ou Properties. Le profil de contenu de fichier KVSet fait référence à un schéma de fichier qui contient toutes les propriétés d’une clé-valeur App Configuration, notamment la clé, la valeur, l’étiquette, le type de contenu et les balises.	Par défaut
   Mode sélection	Indiquez s’il faut exporter à partir de valeurs de clé standard, qui est l’option par défaut ou à partir d’un instantané.	Par défaut
   Filtre principal	Permet de filtrer les valeurs de clé en fonction du nom de clé pour l’exportation. Si aucune clé n’est spécifiée, toutes les clés sont éligibles.	Commence par TestApp :
   À un moment spécifique	Optional. Renseignez ce champ pour exporter des valeurs de clé à partir d’un point spécifique dans le temps dans le magasin de configuration sélectionné. Si vous ne le renseignez pas, ce champ est défini par défaut sur le point dans le temps actuel des paires clé-valeur.	28/07/2022 12:00:00
   Depuis l'étiquette	Sélectionnez l’étiquette pour exporter les valeurs de clé associées à ces étiquettes. Si aucune étiquette n’est sélectionnée, toutes les étiquettes sont éligibles. Notez que vous ne pouvez sélectionner qu’une seule étiquette lors de l’exportation avec le profil de contenu de Default fichier. Pour exporter des valeurs de clé avec plusieurs étiquettes, utilisez le profil de contenu de KVSet fichier.	prod
   Supprimer le préfixe	Optional. S’il est spécifié, le préfixe est supprimé des noms de clés de toutes les valeurs de clé exportées qui le contiennent.	TestApp :
   Séparateur	Le séparateur est le délimiteur utilisé pour segmenter les noms de clés et reconstruire des configurations hiérarchiques pour les fichiers JSON ou YAML à partir de valeurs clés. Elle sera ignorée pour les fichiers de propriétés et les indicateurs de fonctionnalité. Les valeurs prises en charge incluent aucun séparateur, point (.), virgule (,), point-virgule (;), trait d’union (-), trait de soulignement (_), trait de soulignement double (_), barre oblique (/) et deux-points (:).	:

4. Sélectionnez Exporter pour terminer l’exportation.

Vous avez exporté des valeurs de clé à partir d’un magasin App Configuration à partir du 28 juillet 2021, à 12 heures, avec des noms de clés commençant par TestApp: et par l’étiquette prod vers un fichier JSON. Le préfixe TestApp: a été supprimé des noms de clés, et le séparateur : a été utilisé pour segmenter les noms de clés et reconstruire le format JSON hiérarchique.

Azure CLI

À partir d’Azure CLI, suivez les étapes ci-dessous. Si azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

1. Entrez la commande az appconfig kv export d’exportation et ajoutez les paramètres suivants :

   Paramètre	Descriptif	Example
   --name	Entrez le nom du magasin App Configuration qui contient les valeurs clés que vous souhaitez exporter.	my-app-config-store
   --destination	Entrez file pour indiquer que vous exportez des données dans un fichier.	file
   --path	Entrez le chemin d’accès où vous souhaitez enregistrer le fichier.	C:/Users/john/Downloads/data.json
   --format	Entrez yaml, properties ou json pour indiquer le format du fichier que vous souhaitez exporter.	json
   --label	Entrez une étiquette pour exporter des valeurs de clé et des indicateurs de fonctionnalité avec cette étiquette. Si vous ne spécifiez pas d’étiquette, par défaut, vous exportez uniquement les indicateurs de clé et de fonctionnalité sans étiquette. Vous pouvez entrer une étiquette, entrer plusieurs étiquettes en les ,séparant, ou utiliser * pour prendre en compte toutes les étiquettes.	prod

   Important

   Si vous ne sélectionnez pas d’étiquette, seules les valeurs clés sans étiquettes seront exportées. Pour exporter une clé-valeur avec une étiquette, vous devez sélectionner son étiquette.

2. Si vous le souhaitez, ajoutez également les paramètres suivants :

   Paramètre	Descriptif	Example
   --separator	Optional. Le séparateur est le délimiteur permettant d’aplatir les clés-valeurs en JSON/YAML. Il est nécessaire pour exporter la structure hiérarchique et sera ignoré pour les fichiers de propriétés et les indicateurs de fonctionnalité. Sélectionnez l’une des options suivantes : ., ,:;/-, _, . —	;
   --prefix	Optional. Ce préfixe est tronqué de la propriété « clé » de chaque paire clé-valeur. Un préfixe de clé est la partie de début d’une clé. Les préfixes peuvent être utilisés pour gérer des groupes de paires clé-valeur dans un magasin de configuration. Le préfixe est ignoré pour les indicateurs de fonctionnalités.	TestApp:

   Exemple : exportez toutes les valeurs de clé et tous les indicateurs de fonctionnalité avec l’étiquette « prod » vers un fichier JSON.

   az appconfig kv export --name my-app-config-store --label prod --destination file --path D:/abc.json --format json --separator ; --prefix TestApp:
   

3. La ligne de commande affiche une liste de valeurs clés exportées vers le fichier. Confirmez l’exportation en sélectionnant y.

   

Les indicateurs de fonctionnalité variant sont exportés vers un fichier à l’aide du schéma Microsoft Feature Management, tandis que d’autres indicateurs de fonctionnalité sont exportés à l’aide du schéma de gestion des fonctionnalités .NET pour la compatibilité. Pour exporter des indicateurs de fonctionnalité exclusivement à l’aide du schéma Microsoft Feature Management, définissez la variable d’environnement AZURE_APPCONFIG_FM_COMPATIBLE sur False.

Vous avez exporté des valeurs de clé et des indicateurs de fonctionnalité qui ont l’étiquette « prod » dans un fichier de configuration et ont supprimé le préfixe « TestApp ». Les valeurs sont séparées par « ; » dans le fichier.

Pour obtenir des paramètres et des exemples facultatifs, accédez à az appconfig kv export.

Exporter des données vers un stockage App Configuration

Suivez les étapes ci-dessous pour exporter des indicateurs de clés et de fonctionnalités vers un magasin Azure App Configuration.

Vous pouvez exporter des valeurs d’un magasin App Configuration vers un autre magasin App Configuration, ou exporter des valeurs d’un magasin App Configuration vers le même magasin App Configuration afin de dupliquer ses valeurs et d’appliquer différents paramètres, tels que le nouveau type d’étiquette ou de contenu.

Portal

À partir du portail Azure, procédez comme suit :

1. Accédez à votre magasin App Configuration qui contient les données que vous souhaitez exporter, puis sélectionnez Importer/exporter dans le menu Opérations .

   

2. Sélectionnez la case d’option Exporter et, sous Type cible, sélectionnez App Configuration.

3. Remplissez le formulaire avec les paramètres suivants :

   Paramètre	Descriptif	Example
   Mode sélection	Indiquez s’il faut exporter à partir de valeurs de clé standard, qui est l’option par défaut ou à partir d’un instantané.	Par défaut
   Filtre principal	Permet de filtrer les valeurs de clé en fonction du nom de clé pour l’exportation. Si aucune clé n’est spécifiée, toutes les clés sont éligibles.	Commence par TestApp :
   À un moment spécifique	Optional. Renseignez ce champ pour exporter des valeurs de clé à partir d’un point spécifique dans le temps dans le magasin de configuration sélectionné. Si vous ne le renseignez pas, ce champ est défini par défaut sur le point dans le temps actuel des paires clé-valeur.	28/07/2022 12:00:00
   Depuis l'étiquette	Sélectionnez une ou plusieurs étiquettes pour exporter les valeurs de clé associées à ces étiquettes. Si aucune étiquette n’est sélectionnée, toutes les étiquettes sont éligibles.	prod
   Exclure l’indicateur de fonctionnalité	Si cette option est cochée, les indicateurs de fonctionnalité ne sont pas exportés.	Non coché

4. Sélectionnez le magasin de destination, remplissez le formulaire avec les paramètres suivants :

   Paramètre	Descriptif	Example
   Subscription	Votre abonnement actuel est sélectionné par défaut.	my-subscription
   groupe de ressources	Sélectionnez un groupe de ressources qui contient le magasin App Configuration dans lequel vous souhaitez exporter la configuration. Votre groupe de ressources actuel est sélectionné par défaut.	my-resource-group
   Resource	Sélectionnez le magasin App Configuration dans lequel vous souhaitez exporter la configuration.	my-other-app-config-store

5. Remplissez la partie suivante du formulaire :

   Paramètre	Descriptif	Example
   Supprimer le préfixe	Optional. S’il est spécifié, le préfixe est supprimé des noms de clés de toutes les valeurs de clé exportées qui le contiennent.	TestApp :
   Remplacer les étiquettes	Optional. Par défaut, les étiquettes d’origine des valeurs de clé source sont conservées. Pour les remplacer, cochez la case et entrez une nouvelle étiquette pour les valeurs de clé exportées.	Nouveau
   Remplacer les types de contenu	Optional. Par défaut, les types de contenu d’origine des valeurs de clé source sont conservés. Pour les remplacer, cochez la case et entrez un nouveau type de contenu pour les valeurs de clé exportées. Notez que le type de contenu des indicateurs de fonctionnalité ne peut pas être substitué.	JSON (application/json)

6. Sélectionnez Appliquer pour poursuivre l’exportation.

Vous avez exporté des valeurs de clé à partir d’un magasin App Configuration depuis le 28 juillet 2022, à 12h00, avec des noms de clés commençant par TestApp: et par l’étiquette prod vers un autre magasin App Configuration. Toutes les valeurs de clé exportées ont été rognées du préfixe de clé TestApp:, et ont été affectées l’étiquette new et le type de contenu application/json.

Azure CLI

À partir d’Azure CLI, suivez les étapes ci-dessous. Si azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

1. Entrez la commande az appconfig kv export d’exportation et entrez les paramètres suivants :

   Paramètre	Descriptif	Example
   --name	Entrez le nom du magasin App Configuration qui contient les valeurs clés que vous souhaitez exporter.	my-app-config-store
   --destination	Entrez appconfig pour indiquer que vous exportez des données vers un magasin App Configuration.	appconfig
   --dest-name	Entrez le nom du magasin App Configuration vers lequel vous souhaitez exporter des données.	my-other-app-config-store
   --label	Entrez une étiquette pour exporter des valeurs de clé et des indicateurs de fonctionnalité avec cette étiquette. Si vous ne spécifiez pas d’étiquette, par défaut, vous exporterez uniquement les indicateurs de clé et de fonctionnalité sans étiquette. Vous pouvez entrer une étiquette, entrer plusieurs étiquettes en les ,séparant, ou utiliser * pour prendre toutes les étiquettes dans le compte.	prod

   Important

   Si les valeurs clés que vous souhaitez exporter ont des étiquettes, vous devez utiliser la commande --label et entrer les étiquettes correspondantes. Si vous ne sélectionnez pas d’étiquette, seules les valeurs clés sans étiquettes seront exportées. Utilisez un signe de virgule (,) pour sélectionner plusieurs étiquettes ou pour * inclure toutes les étiquettes, y compris l’étiquette Null (aucune étiquette).

2. Si vous le souhaitez, ajoutez également le paramètre suivant :

   Paramètre	Descriptif	Example
   --dest-label	Optional. Entrez une étiquette de destination pour affecter cette étiquette aux valeurs de clé exportées.	new

   Exemple : exporter des valeurs clés et des indicateurs de fonctionnalité avec l’étiquette « prod » dans un autre magasin App Configuration et ajouter l’étiquette de destination « new ».

   az appconfig kv export --name my-app-config-store --destination appconfig --dest-name my-other-app-config-store --dest-label new --label prod
   

3. La ligne de commande affiche une liste de valeurs clés exportées vers les fichiers. Confirmez l’exportation en sélectionnant y.

   

Vous avez exporté les clés-valeurs et les indicateurs de fonctionnalités qui ont l’étiquette « prod » à partir d’un magasin App Configuration et vous leur avez attribué l’étiquette « new ».

Pour obtenir des paramètres et des exemples facultatifs, accédez à az appconfig kv import.

Exporter des données vers Azure App Service

Suivez les étapes ci-dessous pour exporter des valeurs clés vers Azure App Service.

Note

L’exportation des indicateurs de fonctionnalités vers App Service n’est pas prise en charge.

Portal

À partir du portail Azure, procédez comme suit :

1. Accédez à votre magasin App Configuration, puis sélectionnez Importer/exporter dans le menu Opérations .

   

2. Sélectionnez la case d’option Exporter et, sous Type cible, sélectionnez App Services.

3. L’option Exporter en tant que référence est cochée par défaut. Lorsque la case est cochée, les paramètres de l’application dans App Service sont ajoutés en tant que références App Configuration pour les valeurs de clé exportées. Cela vous permet de gérer vos paramètres dans App Configuration, avec votre App Service qui extrait automatiquement les valeurs actuelles d’App Configuration. Pour en savoir plus, consultez Références de la configuration d'application pour App Service et Azure Functions. Si la case est décochée, la clé et la valeur sont directement exportées vers App Service. N’oubliez pas d’exporter à nouveau vos données chaque fois que vous apportez des modifications dans App Configuration pour vous assurer que votre application récupère les mises à jour.

4. Remplissez le formulaire avec les paramètres suivants :

   Paramètre	Descriptif	Example
   Mode sélection	Indiquez s’il faut exporter à partir de valeurs de clé standard, qui est l’option par défaut ou à partir d’un instantané.	Par défaut
   Filtre principal	Permet de filtrer les valeurs de clé en fonction du nom de clé pour l’exportation. Si aucune clé n’est spécifiée, toutes les clés sont éligibles.	Commence par TestApp :
   À un moment spécifique	Optional. Renseignez ce champ pour exporter des valeurs de clé à partir d’un point spécifique dans le temps dans le magasin de configuration sélectionné. Si vous ne le renseignez pas, ce champ est défini par défaut sur le point dans le temps actuel des paires clé-valeur.	28/07/2022 12:00:00
   Depuis l'étiquette	Sélectionnez une étiquette pour exporter les valeurs de clé associées à cette étiquette.	prod

5. Sélectionnez un magasin de destination et remplissez le formulaire avec les paramètres suivants :

   Paramètre	Descriptif	Example
   Subscription	Votre abonnement actuel est sélectionné par défaut.	my-subscription
   groupe de ressources	Sélectionnez un groupe de ressources qui contient l’App Service dans lequel vous souhaitez exporter la configuration.	my-resource-group
   Resource	Sélectionnez App Service dans lequel vous souhaitez exporter la configuration.	my-app-service

6. Renseignez éventuellement la partie suivante du formulaire :

   Paramètre	Descriptif	Example
   Supprimer le préfixe	Optional. S’il est spécifié, le préfixe est supprimé des noms de clés de toutes les valeurs de clé exportées qui le contiennent.	TestApp :

7. Sélectionnez Appliquer pour poursuivre l’exportation.

Vous avez exporté des valeurs de clé à partir d’un magasin App Configuration depuis le 28 juillet 2022, à 12 heures, avec des noms de clés commençant par TestApp: et par l’étiquette prod vers les paramètres d’application d’une ressource App Service. Le préfixe TestApp: a été supprimé des noms de clés exportés.

Si vous avez coché la case pour exporter des valeurs de clé en tant que références, les valeurs de clé exportées sont indiquées en tant que références App Configuration dans la colonne « Source » de vos paramètres de configuration des ressources App Service.

Azure CLI

À partir d’Azure CLI, suivez les étapes ci-dessous. Si azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

1. Entrez la commande az appconfig kv export d’exportation et entrez les paramètres suivants :

   Paramètre	Descriptif	Example
   --name	Entrez le nom du magasin App Configuration qui contient les valeurs clés que vous souhaitez exporter.	my-app-config-store
   --destination	Entrez appservice pour indiquer que vous exportez des données vers App Service.	appservice
   --appservice-account	Entrez l’ID ARM d’App Service ou utilisez le nom d’App Service, s’il se trouve dans le même abonnement et le même groupe de ressources que App Configuration.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service ou my-app-service
   --label	Optional. Entrez une étiquette pour exporter des valeurs de clé et des indicateurs de fonctionnalité avec cette étiquette. Si vous ne spécifiez pas d’étiquette, par défaut, vous exporterez uniquement les valeurs clés et les indicateurs de fonctionnalité sans étiquette.	prod

   Pour obtenir la valeur pour --appservice-account, utilisez la commande az webapp show --resource-group <resource-group> --name <resource-name>.

2. Si vous le souhaitez, ajoutez également un préfixe :

   Paramètre	Descriptif	Example
   --prefix	Optional. Ce préfixe est tronqué de la propriété « clé » d’une paire clé-valeur exportée. Un préfixe de clé est la partie de début d’une clé. Les préfixes peuvent être utilisés pour gérer des groupes de paires clé-valeur dans un magasin de configuration.	TestApp:

   Exemple : exportez toutes les valeurs de clé avec l’étiquette « prod » vers une application App Service et supprimez le préfixe « TestApp ».

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service/config/web --label prod --prefix TestApp:
   

   La ligne de commande affiche une liste de valeurs clés exportées vers une ressource App Service. Confirmez l’exportation en sélectionnant y.

   

   Vous avez exporté toutes les valeurs de clé avec l’étiquette « prod » vers une ressource Azure App Service et supprimé le préfixe « TestApp : ».

3. Spécifiez éventuellement un indicateur à exporter en tant que référence App Configuration.

   Paramètre	Descriptif
   --export-as-reference -r	Optional. Spécifiez si les valeurs de clé sont exportées vers App Service en tant que références App Configuration. En savoir plus.

   Exemple : exportez toutes les valeurs clés avec l’étiquette « prod » comme références de configuration d’application à une application App Service.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account "/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service" --label prod --export-as-reference
   

   La ligne de commande affiche une liste de valeurs clés exportées en tant que références de configuration d’application à une ressource App Service. Confirmez l’exportation en sélectionnant y.

   

   Vous avez exporté toutes les valeurs de clé avec l’étiquette « prod » comme références de configuration d’application à une ressource Azure App Service. Dans votre ressource App Service, les valeurs de clé importées sont indiquées en tant que références App Configuration dans la colonne « Source ».

   

Pour obtenir des paramètres et des exemples facultatifs, accédez à az appconfig kv export.

Messages d’erreur

Vous pouvez rencontrer les messages d’erreur suivants lors de l’importation ou de l’exportation de valeurs clés App Configuration :

• L’accès public est désactivé pour votre magasin ou vous accédez à partir d’un point de terminaison privé qui n’est pas dans les configurations de point de terminaison privé du magasin. Si votre magasin App Configuration dispose de points de terminaison privés activés, vous ne pouvez y accéder qu’à partir du réseau virtuel configuré par défaut. Vérifiez que la machine exécutant le portail Azure ou l’interface CLI est jointe au même réseau virtuel que le point de terminaison privé. Si vous venez d’activer l’accès au réseau public à votre magasin App Configuration, attendez au moins 5 minutes avant de réessayer d’autoriser l’actualisation du cache.

Étapes suivantes

Intégrer à un pipeline CI/CD