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 importer et exporter des données avec App Configuration. Si vous souhaitez configurer une synchronisation continue avec votre référentiel GitHub, consultez Actions GitHub et Tâches Azure Pipelines.

Vous pouvez importer ou exporter des données en utilisant le portail Azure ou Azure CLI.

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.

Notes

L’importation d’indicateurs de fonctionnalités à partir d’un fichier n’est pas prise en charge. Si un fichier de configuration contient des indicateurs de fonctionnalités, ils seront importés automatiquement en tant que clés-valeurs régulières.

Portail

Sur le portail Azure, procédez comme suit :

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

   

2. Sous l’onglet Importer, sélectionnez Fichier de configuration sous Service source.

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

   Paramètre	Description	Exemple
   Pour le langage	Choisissez le langage du fichier que vous importez : .NET, Java (Spring) et Autre.	.NET
   Type de fichier	Sélectionnez le type de fichier que vous importez : Yaml, Propriétés ou Json.	Json

4. Sélectionnez l’icône Dossier, puis accédez au fichier à importer.

   Notes

   Un message s’affiche à l’écran, indiquant que le fichier a bien été récupéré.

5. Renseignez la partie suivante du formulaire :

   Paramètre	Description	Exemple
   Séparateur	Le séparateur est le caractère analysé dans votre fichier de configuration importé pour séparer les paires clé-valeur ajoutées à votre magasin de configuration. Sélectionnez l’une des options suivantes : ., ,, :, ;, /, -, _, —.	;
   Préfixe	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. Le préfixe entré est ajouté devant la propriété « clé » de chaque paire clé-valeur que vous importez à partir de ce fichier.	TestApp :
   Étiquette	facultatif. Sélectionnez une étiquette existante ou entrez une nouvelle étiquette à attribuer à vos paires clé-valeur importées.	prod
   Type de contenu	facultatif. Indiquez si vous importez un fichier JSON ou des références Key Vault. Pour plus d’informations sur les références Key Vault, accédez à Utiliser des références Key Vault dans une application ASP.NET Core.	JSON (application/json)

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

Vous avez importé des clés-valeurs à partir d’un fichier JSON, 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 ».

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, 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. Accédez à votre magasin App Configuration et sélectionnez Importer/exporter dans le menu Opérations.

   

2. Sous l’onglet Importer, sélectionnez App Configuration sous Service source.

3. Sélectionnez Sélectionner une ressource, remplissez le formulaire avec les paramètres suivants, puis sélectionnez Appliquer :

   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

   Notes

   Le message « Clés d’accès récupérées avec succès » indique que la connexion avec le magasin App Configuration a réussi. »

4. Renseignez la partie suivante du formulaire :

   Paramètre	Description	Exemple
   À partir d’une étiquette	Sélectionnez au moins une étiquette pour importer des valeurs avec les étiquettes correspondantes. L’option Tout sélectionner permet d’importer des paires clé-valeur avec n’importe quelle étiquette. L’option (Aucune étiquette) limite l’importation aux paires clé-valeur sans étiquette.	prod
   À une heure spécifique	facultatif. Remplissez le champ pour importer des paires clé-valeur à partir d’un point spécifique dans le temps. Il s’agit du point dans le temps des paires clé-valeur dans le magasin de configuration sélectionné. Format : « YYYY-MM-DDThh:mm:ssZ ». Ce champ est défini par défaut sur le point dans le temps actuel des paires clé-valeur si vous ne le renseignez pas.	28/07/2022 00:00:00
   Remplacer les étiquettes de valeur-clé par défaut	facultatif. Par défaut, les éléments importés utilisent leur étiquette actuelle. Cochez la case et entrez une étiquette pour remplacer ces valeurs par défaut par une étiquette personnalisée.	nouveau
   Remplacez le type de contenu à valeur clé par défaut	facultatif. Par défaut, les éléments importés utilisent leur type de contenu actuel. Cochez la case et sélectionnez Key Vault Reference ou JSON (application/json) sous Type de contenu 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 » et n’est pas mis à jour par ce paramètre.	JSON (application/json)

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

Vous avez importé des paires clé-valeur et des indicateurs de fonctionnalité avec l’étiquette « prod » à partir d’un magasin App Configuration le 28 janvier 2021 à 12 heures, puis 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 ».

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. Accédez à votre magasin App Configuration et sélectionnez Importer/exporter dans le menu Opérations.

   

2. Sous l’onglet Importer, sélectionnez App Services sous Service source.

3. Sélectionnez Sélectionner une ressource, remplissez le formulaire avec les paramètres suivants, puis sélectionnez Appliquer :

   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

   Notes

   Un message s’affiche, indiquant le nombre de paires clé-valeurs correctement extraites de la ressource App Service source.

4. Renseignez la partie suivante du formulaire :

   Paramètre	Description	Exemple
   Préfixe	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é « key » de chaque paire clé-valeur importée.	TestApp :
   Étiquette	facultatif. Sélectionnez une étiquette existante ou entrez une nouvelle étiquette à attribuer à vos paires clé-valeur importées.	prod
   Type de contenu	facultatif. Indiquez si le fichier que vous importez est une référence Key Vault ou un fichier JSON. Pour plus d’informations sur les références Key Vault, accédez à Utiliser des références Key Vault dans une application ASP.NET Core.	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 « 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 de configuration d’application vers un fichier Json, Yaml ou de propriétés.

Remarque

L’exportation d’indicateurs de fonctionnalités à partir d’un magasin App Configuration vers un fichier de configuration n’est actuellement prise en charge que dans l’interface CLI.

Portail

Dans le portail Azure, suivez ces étapes :

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

   

2. Sous l’onglet Exporter, sélectionnez Fichier de configuration sous Service cible.

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

   Paramètre	Description	Exemple
   Préfixe	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.	TestApp :
   À partir d’une étiquette	Sélectionnez une étiquette existante pour limiter l’exportation aux paires clé-valeur qui ont une étiquette spécifique. Si vous ne sélectionnez pas d’étiquette, par défaut, seules les paires clé-valeur avec l’étiquette « Sans étiquette » sont exportées. Voir la remarque ci-dessous.	prod
   À une heure spécifique	facultatif. Remplissez le champ pour importer des paires clé-valeur à partir d’un point spécifique dans le temps. Il s’agit du point dans le temps des paires clé-valeur dans le magasin de configuration sélectionné. Format : « YYYY-MM-DDThh:mm:ssZ ». Ce champ est défini par défaut sur le point dans le temps actuel des paires clé-valeur si vous ne le renseignez pas.	28/07/2022 00:00:00
   Type de fichier	Sélectionnez le type de fichier que vous exportez : Yaml, Propriétés ou Json.	JSON
   Séparateur	Le séparateur est le délimiteur permettant d’aplatir les clés-valeurs en Json/Yaml. Il prend en charge la structure hiérarchique de la configuration et ne s’applique pas aux fichiers de propriétés et aux indicateurs de fonctionnalités. Sélectionnez l’une des options suivantes : ., ,, :, ;, /, -_, — ou (Aucun séparateur).	;

   Important

   Si vous ne sélectionnez pas d’étiquette de début, 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. Notez que vous ne pouvez sélectionner qu’une seule étiquette par exportation dans le portail, si vous souhaitez exporter les clés-valeurs avec toutes les étiquettes spécifiées, utilisez l’interface CLI.

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

Vous avez exporté des clés-valeurs qui ont l’étiquette « prod » à partir d’un fichier de configuration, à leur état du 28/07/2021 minuit, et vous avez supprimé le préfixe « TestApp ». Les valeurs sont séparées par « ; » dans le fichier.

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. Accédez au magasin App Configuration qui contient les données que vous souhaitez exporter, puis sélectionnez Importer/exporter dans le menu Opérations.

   

2. Sous l’onglet Exporter, sélectionnez App Configuration sous Service cible.

3. Sélectionnez Sélectionner une ressource, remplissez le formulaire avec les paramètres suivants, puis sélectionnez Appliquer :

   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.	my-resource-group
   Ressource	Sélectionnez le magasin App Configuration qui contient la configuration que vous souhaitez importer.	my-app-config-store

4. La page affiche désormais le service cible et l’ID de ressource sélectionnés. L’action Sélectionner une ressource vous permet de basculer vers un autre magasin App Configuration source.

   Notes

   Un message s’affiche à l’écran, indiquant que les paires clé-valeur ont bien été extraites.

5. Renseignez la partie suivante du formulaire :

   Paramètre	Description	Exemple
   À partir d’une étiquette	Sélectionnez au moins une étiquette pour exporter des valeurs avec les étiquettes correspondantes. L’option Sélectionner tout permet d’exporter des paires clé-valeur avec n’importe quelle étiquette. L’option (Aucune étiquette) limite l’exportation aux paires clé-valeur sans étiquette.	prod
   À une heure spécifique	facultatif. Remplissez le champ pour importer des paires clé-valeur à partir d’un point spécifique dans le temps. Il s’agit du point dans le temps des paires clé-valeur dans le magasin de configuration sélectionné. Format : « YYYY-MM-DDThh:mm:ssZ ». Ce champ est défini par défaut sur le point dans le temps actuel des paires clé-valeur si vous ne le renseignez pas.	28/07/2022 00:00:00
   Remplacer les étiquettes de valeur-clé par défaut	facultatif. Par défaut, les éléments importés utilisent leur étiquette actuelle. Cochez la case et entrez une étiquette pour remplacer ces valeurs par défaut par une étiquette personnalisée.	nouveau

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

Vous avez exporté des clés-valeurs et des indicateurs de fonctionnalités qui ont l’étiquette « prod » à partir d’un magasin App Configuration, à leur état du 28/07/2022 minuit, et vous leur avez attribué l’étiquette « nouveau ».

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.

Notes

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

Portail

Sur le portail Azure, procédez comme suit :

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

   

2. Sous l’onglet Exporter , sélectionnez App Services sous Service cible.

3. Sélectionnez Sélectionner une ressource, remplissez le formulaire avec les paramètres suivants, puis sélectionnez Appliquer :

   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 à exporter.	my-resource-group
   Ressource	Sélectionnez le App Service qui contient la configuration que vous souhaitez exporter.	my-app-service

4. La page affiche désormais le service cible et l’ID de ressource sélectionnés. L’action Sélectionner une ressource vous permet de basculer vers une autre ressource App Service cible.

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

   Paramètre	Description	Exemple
   Préfixe	facultatif. Ce préfixe est tronqué de la propriété « clé » de chaque 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. Le préfixe est ignoré pour les indicateurs de fonctionnalités.	TestApp :
   Exporter en tant que référence	facultatif. Cochez cette case pour exporter les paires clé-valeur vers App Service en tant que références App Configuration. En savoir plus
   À une heure spécifique	facultatif. Remplissez le champ pour exporter des paires clé-valeur à partir d’un point spécifique dans le temps. Il s’agit du point dans le temps des paires clé-valeur dans le magasin de configuration sélectionné. Format : « YYYY-MM-DDThh:mm:ssZ ». Ce champ est défini par défaut sur le point dans le temps actuel des paires clé-valeur si vous ne le renseignez pas.	28/07/2022 00:00:00
   À partir d’une étiquette	facultatif. Sélectionnez une étiquette existante pour limiter l’exportation aux paires clé-valeur qui ont une étiquette spécifique. Si vous ne sélectionnez pas d’étiquette, seules les paires clé-valeur avec l’étiquette « Sans étiquette » sont exportées.	prod

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

Vous avez exporté les clés-valeurs qui ont l’étiquette « prod » à partir d’un fichier de configuration, à leur état à partir du 28/07/2021 minuit, et avez supprimé le préfixe « TestApp ». Les paires clé-valeur ont été exportées avec un type de contenu au format JSON.

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 :

• Le fichier sélectionné doit être compris entre 1 et 2 097 152 octets. : votre fichier est trop volumineux. Sélectionnez un fichier plus petit.
• 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. Pour importer des paires clé-valeur à partir d’un magasin App Configuration, vous avez besoin d’avoir accès à ce magasin. Si nécessaire, activez l’accès public pour le magasin source ou accédez-y à partir d’un point de terminaison privé approuvé. Si vous venez d’activer l’accès public, attendez jusqu’à 5 minutes pour que le cache soit actualisé.

Étapes suivantes

Intégrer à un pipeline CI/CD