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. Ces opérations vous permettent d’utiliser des données de configuration en bloc et d’échanger des données entre votre magasin App Configuration et le 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 pour ne pas avoir à entrer deux fois les mêmes données.

Cet article fournit un guide pour l’importation et l’exportation de données à l’aide du Portail Azure ou de Azure CLI. Si vous avez adopté Configuration sous forme de code et que vous 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 Push d’Azure Pipeline.

Importer des données

L’importation a pour effet d’acheminer les données de configuration d’une source existante vers un magasin App Configuration. Utilisez la fonction d’importation pour migrer des données dans un magasin App Configuration ou agréger des données issues de plusieurs sources.

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

• à partir d’un fichier de configuration dans Json, Yaml ou Propriétés
• à partir d’un magasin App Configuration
• à partir d’Azure App Service

Importer des données depuis un fichier de configuration

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

Portail

Sur le portail Azure, procédez comme suit :

1. Naviguez à votre magasin App Configuration et 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. Renseignez le formulaire avec les paramètres suivants :

   Paramètre	Description	Exemple
   Type de fichier	Sélectionnez le type de fichier à importer : YAML, Propriétés ou JSON.	Json

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

5. Renseignez la partie suivante du formulaire :

   Paramètre	Description	Exemple
   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 valeur clé App Configuration, notamment la clé, la valeur, l’étiquette, le type de contenu et les balises.	Par défaut
   Mode 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, toutes les valeurs de clé dans le magasin identiques à celles du fichier de configuration sont ignorées. 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.	Dé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.	Dé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 (:).	:
   Depth	facultatif. 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	facultatif. 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	facultatif. Si elle est spécifiée, l’étiquette fournie est affectée à toutes les valeurs de clé importées.	prod
   Ajouter le type de contenu	facultatif. S’il est spécifié, le type de contenu fourni est ajouté à toutes les valeurs de clé importées.	JSON (application/json)
   Ajouter des étiquettes	facultatif. 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 lancer l’importation.

Vous avez correctement importé des valeurs de clé à partir d’un fichier JSON. Les noms de clés ont été aplatis à 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 contenu de application/json et marquées avec tag: tag1.

Azure CLI

À partir d’Azure CLI, procédez comme suit. Si Azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

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

   Paramètre	Description	Exemple
   --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, properties 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	Description	Exemple
   --separator	facultatif. 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	facultatif. Le préfixe de clé est le 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é devant la propriété « clé » de chaque paire clé-valeur importée.	TestApp:
   --label	facultatif. Entrez une étiquette à attribuer à vos paires clé-valeur importées.	prod
   --content-type	facultatif. 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 paires clé-valeur et tous les indicateurs de fonctionnalité 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 clés-valeurs à partir d’un fichier JSON et vous les avez affectées à l’étiquette « prod » et au préfixe « TestApp ». Le séparateur « ; » est utilisé et toutes les paires clé-valeur que vous avez importées ont leur type de contenu défini sur « JSON ».

Pour accéder à plus de paramètres facultatifs et à d’autres exemples, 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, ou importer des valeurs d’un magasin App Configuration dans 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 clés-valeurs et des indicateurs de fonctionnalités à partir d’un magasin Azure App Configuration.

Portail

Sur le portail Azure, procédez comme suit :

1. Naviguez à votre magasin App Configuration et 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	Description	Exemple
   Abonnement	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
   Ressource	Sélectionnez le magasin App Configuration qui contient la configuration que vous souhaitez importer.	my-other-app-config-store

4. Renseignez la partie suivante du formulaire :

   Paramètre	Description	Exemple
   Mode de 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 de clé	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
   À une heure spécifique	facultatif. 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 00:00:00
   À partir d’une é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.	Décoché
   Ajouter un préfixe	facultatif. 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	facultatif. 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	facultatif. 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 lancer 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 de contenu application/json.

Azure CLI

À partir d’Azure CLI, procédez comme suit. Si Azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

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

   Paramètre	Description	Exemple
   --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’un magasin App Configuration.	appconfig
   --src-name	Entrez le nom du magasin App Configuration depuis lequel vous souhaitez importer des données.	my-source-app-config
   --src-label	Limitez votre importation aux paires clé-valeur portant une étiquette spécifique. Si vous n’utilisez pas ce paramètre, seules les paires clé-valeur portant une étiquette Null sont importées. Prend en charge le symbole étoile comme filtre : entrez * pour toutes les étiquettes; abc* pour toutes les étiquettes avec abc comme préfixe.	prod

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

   Paramètre	Description	Exemple
   --label	facultatif. Entrez une étiquette à attribuer à vos paires clé-valeur importées.	new
   --content-type	facultatif. 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 les paires clé-valeur et indicateurs de fonctionnalités portant l’étiquette « prod » à partir d’un autre magasin App Configuration, puis attribuez-leur l’étiquette « nouveau ». 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 paires clé-valeur que vous avez importées ont leur type de contenu défini sur « JSON ».

Pour accéder à plus de paramètres facultatifs et à d’autres exemples, accédez à az appconfig kv import.

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

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

Notes

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

Portail

À partir du portail Azure :

1. Naviguez à votre magasin App Configuration et 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	Description	Exemple
   Abonnement	Votre abonnement actuel est sélectionné par défaut.	my-subscription
   Groupe de ressources	Sélectionnez un groupe de ressources qui contient le App Service avec la configuration à importer.	my-resource-group
   Ressource	Sélectionnez le App Service qui contient la configuration que vous souhaitez importer.	my-app-service

4. Renseignez la partie suivante du formulaire :

   Paramètre	Description	Exemple
   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 Utiliser des références App Configuration pour App Service et Azure Functions.	Activée
   Ajouter un préfixe	facultatif. 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	facultatif. Si elle est spécifiée, l’étiquette fournie est affectée à toutes les valeurs de clé importées.	prod
   Ajouter le type de contenu	facultatif. 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 lancer l’importation.

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

Azure CLI

À partir d’Azure CLI, procédez comme suit. Si Azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

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

   Paramètre	Description	Exemple
   --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 AppService ou le nom AppService, s’il se trouve dans le même abonnement et le même groupe de ressources que la configuration d’application.	/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	Description	Exemple
   --prefix	facultatif. 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é devant la propriété « clé » de chaque paire clé-valeur importée.	TestApp:
   --label	facultatif. Entrez une étiquette à attribuer à vos paires clé-valeur importées. Si vous ne spécifiez pas d’étiquette, l’étiquette null est affectée à vos clés-valeurs.	prod
   --content-type	facultatif. 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 clés-valeurs avec l’étiquette « prod », dans votre magasin App Configuration, puis 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 instance App Service en tant que clés-valeurs, vous leur avez attribué l’étiquette « prod » et vous avez ajouté un préfixe « TestApp: ». Toutes les paires clé-valeur que vous avez importées ont leur type de contenu défini sur « JSON ».

Pour accéder à plus de paramètres facultatifs et à d’autres exemples, accédez à az appconfig kv import.

Exporter des données

L’exportation a pour effet d’écrire les données de configuration stockées dans App Configuration dans une autre destination. Utilisez la fonction d’exportation, par exemple, pour enregistrer les données d’un magasin App Configuration dans un fichier pouvant être incorporé à votre code d’application pendant le déploiement.

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

• vers un fichier de configuration dans Json, Yaml ou Propriétés
• vers un magasin App Configuration
• vers une ressource Azure App Service

Exporter des données dans un fichier de configuration

Suivez les étapes ci-dessous pour exporter les données de configuration d’un magasin d’App Configuration vers un fichier JSON, YAML ou de propriétés.

Portail

Dans le portail Azure, suivez ces étapes :

1. Naviguer à votre magasin App Configuration et sélectionnez Importer/Exporter.

   

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

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

   Paramètre	Description	Exemple
   Type de fichier	Sélectionnez le type de fichier à exporter : YAML, Propriétés 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 valeur clé App Configuration, notamment la clé, la valeur, l’étiquette, le type de contenu et les balises.	Par défaut
   Mode de 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 de clé	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 :
   À une heure spécifique	facultatif. 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 00:00:00
   À partir d’une é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 fichier Default. Pour exporter des valeurs de clé avec plusieurs étiquettes, utilisez le profil de contenu de fichier KVSet.	prod
   Supprimer le préfixe	facultatif. 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, procédez comme suit. Si Azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

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

   Paramètre	Description	Exemple
   --name	Entrez le nom du magasin App Configuration qui contient les clés-valeurs 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 les paires clé-valeur et indicateurs de fonctionnalité portant cette étiquette. Si vous ne spécifiez pas d’étiquette, par défaut, vous exportez uniquement les paires clé-valeur et indicateurs de fonctionnalité sans étiquette. Vous pouvez entrer une étiquette, entrer plusieurs étiquettes en utilisant le séparateur ,, ou utiliser * pour prendre en compte toutes les étiquettes.	prod

   Important

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

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

   Paramètre	Description	Exemple
   --separator	facultatif. 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	facultatif. Ce préfixe est tronqué de la propriété « clé » de chaque paire clé-valeur. Le préfixe de clé est le 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 paires clé-valeur et tous les indicateurs de fonctionnalité portant l’étiquette « prod » dans 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 clés-valeurs exportées vers le fichier. 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 » dans un fichier de configuration, et vous avez supprimé le préfixe « TestApp ». Les valeurs sont séparées par « ; » dans le fichier.

Pour accéder à plus de paramètres facultatifs et à d’autres exemples, accédez à az appconfig kv export.

Exporter les données vers un magasin App Configuration

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

Vous pouvez exporter des valeurs d’un magasin App Configuration vers un autre, ou exporter des valeurs d’un magasin App Configuration dans 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.

Portail

Sur le portail Azure, procédez comme suit :

1. Naviguer à 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 de cible, sélectionnez App Configuration.

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

   Paramètre	Description	Exemple
   Mode de 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 de clé	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 :
   À une heure spécifique	facultatif. 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 00:00:00
   À partir d’une é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.	Décoché

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

   Paramètre	Description	Exemple
   Abonnement	Votre abonnement actuel est sélectionné par défaut.	my-subscription
   Resource group	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
   Ressource	Sélectionnez le magasin App Configuration dans lequel vous souhaitez exporter la configuration.	my-other-app-config-store

5. Renseignez la partie suivante du formulaire :

   Paramètre	Description	Exemple
   Supprimer le préfixe	facultatif. 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	facultatif. 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	facultatif. 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 lancer 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é le préfixe de clé TestApp:, et ont affecté l’étiquette new et le type de contenu application/json.

Azure CLI

À partir d’Azure CLI, procédez comme suit. Si Azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

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

   Paramètre	Description	Exemple
   --name	Entrez le nom du magasin App Configuration qui contient les clés-valeurs 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 les paires clé-valeur et indicateurs de fonctionnalité portant cette étiquette. Si vous ne spécifiez pas d’étiquette, par défaut, vous exportez uniquement les paires clé-valeur et indicateurs de fonctionnalité sans étiquette. Vous pouvez entrer une étiquette, entrer plusieurs étiquettes en utilisant le séparateur suivant , ou utiliser * pour intégrer toutes les étiquettes au compte.	prod

   Important

   Si les paires clé-valeur à 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 paires clé-valeur sans étiquette sont exportées. Utilisez un signe virgule (,) pour sélectionner plusieurs étiquettes ou utilisez * 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	Description	Exemple
   --dest-label	facultatif. Entrez une étiquette de destination pour affecter cette étiquette aux clés-valeurs exportées.	new

   Exemple : Exportez les paires clé-valeur et indicateurs de fonctionnalité portant l’étiquette « prod » vers un autre magasin App Configuration et ajoutez l’étiquette de destination « nouveau ».

   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 clés-valeurs 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 accéder à plus de paramètres facultatifs et à d’autres exemples, accédez à az appconfig kv import.

Exporter des données vers Azure App Service

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

Remarque

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

Portail

Sur le portail Azure, procédez comme suit :

1. Naviguez à votre magasin App Configuration et sélectionnez Importer/Exporter dans le menu Opérations.

   

2. Sélectionnez la case d’option Exporter et sous Type de 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 Utiliser des références App Configuration 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. Renseignez le formulaire avec les paramètres suivants :

   Paramètre	Description	Exemple
   Mode de 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 de clé	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 :
   À une heure spécifique	facultatif. 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 00:00:00
   À partir d’une é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	Description	Exemple
   Abonnement	Votre abonnement actuel est sélectionné par défaut.	my-subscription
   Resource group	Sélectionnez un groupe de ressources qui contient l’App Service dans lequel vous souhaitez exporter la configuration.	my-resource-group
   Ressource	Sélectionnez App Service dans lequel vous souhaitez exporter la configuration.	my-app-service

6. Vous pouvez également renseigner la partie suivante du formulaire :

   Paramètre	Description	Exemple
   Supprimer le préfixe	facultatif. 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 lancer 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 permettant d’exporter les paires clé-valeur en tant que références, les paires clé-valeur exportées sont indiquées en tant que références App Configuration dans la colonne « Source » des paramètres de configuration de vos ressources App Service.

Azure CLI

À partir d’Azure CLI, procédez comme suit. Si Azure CLI n’est pas installé localement, vous pouvez éventuellement utiliser Azure Cloud Shell.

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

   Paramètre	Description	Exemple
   --name	Entrez le nom du magasin App Configuration qui contient les clés-valeurs 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 AppService ou le nom AppService, s’il se trouve dans le même abonnement et le même groupe de ressources que la configuration d’application.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service ou my-app-service
   --label	Optionnel. Entrez une étiquette pour exporter les paires clé-valeur et indicateurs de fonctionnalité portant cette étiquette. Si vous ne spécifiez pas d’étiquette, par défaut, vous exportez uniquement les paires clé-valeur et 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	Description	Exemple
   --prefix	facultatif. Ce préfixe est tronqué de la propriété « clé » d’une paire clé-valeur exportée. Le préfixe de clé est le 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 clés-valeurs 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 présente la liste des paires clé-valeur exportées vers une ressource App Service. Confirmez l’exportation en sélectionnant y.

   

   Vous avez exporté toutes les paires clé-valeur ayant l’étiquette « prod » vers une ressource Azure App Service, et vous avez supprimé le préfixe « TestApp: ».

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

   Paramètre	Description
   --export-as-reference -r	facultatif. Spécifiez si les paires clé-valeur sont exportées vers App Service en tant que références App Configuration. Plus d’informations

   Exemple : Exportez toutes les paires clé-valeur portant l’étiquette « prod » en tant que références App Configuration vers 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 présente la liste des paires clé-valeur exportées en tant que références App Configuration vers une ressource App Service. Confirmez l’exportation en sélectionnant y.

   

   Vous avez exporté toutes les paires clé-valeur portant l’étiquette « prod » en tant que références App Configuration vers une ressource Azure App Service. Dans votre ressource App Service, les paires clé-valeur importées sont indiquées en tant que références App Configuration dans la colonne « Source ».

   

Pour accéder à plus de paramètres facultatifs et à d’autres exemples, accédez à az appconfig kv export.

Messages d’erreur

Les messages d’erreur suivants peuvent s’afficher quand vous importez ou exportez des paires clé-valeur App Configuration :

• L’accès public est désactivé pour votre magasin ou vous accédez à partir d’un point de terminaison privé qui ne se trouve 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