Importare o esportare dati di configurazione

Configurazione app di Azure supporta le operazioni di importazione ed esportazione dei dati. Usare queste operazioni per usare i dati di configurazione in blocco e scambiare dati tra l'archivio di Configurazione app e il progetto di codice. Ad esempio, è possibile configurare un archivio di Configurazione app per i test e un altro per la produzione. È possibile copiare le impostazioni dell'applicazione tra di esse in modo che non sia necessario immettere i dati due volte.

Questo articolo fornisce una guida per l'importazione e l'esportazione dei dati tramite il portale di Azure o l'interfaccia della riga di comando di Azure. Se è stata adottata la configurazione come codice e si gestiscono le configurazioni in GitHub o Azure DevOps, è possibile configurare l'importazione continua dei file di configurazione usando GitHub Actions o usare l'attività di importazione della pipeline di Azure.

Importa dati

L'importazione porta i dati di configurazione in un archivio di Configurazione app da un'origine esistente. Usare la funzione di importazione per eseguire la migrazione dei dati in un archivio di Configurazione app o aggregare i dati da più origini.

Questa guida illustra come importare i dati di Configurazione app:

• da un file di configurazione in JSON, YAML o proprietà
• da uno store di Configurazione App
• da Servizio app di Azure
• dalle ConfigMaps del servizio Kubernetes di Azure

Importare dati da un file di configurazione

Seguire questa procedura per importare i valori chiave da un file.

Portal

Nel portale di Azure seguire questa procedura:

1. Passare all'archivio di Configurazione app e selezionare Importa/esporta dal menu Operazioni .

   

2. Il pulsante di opzione Importa è selezionato per impostazione predefinita. In Tipo di origine selezionare File di configurazione.

3. Compilare il modulo con i parametri seguenti:

   Parametro	Description	Example
   Tipo di file	Selezionare il tipo di file per l'importazione: YAML, Proprietà o JSON.	JSON

4. Fare clic sul pulsante Sfoglia e selezionare il file da importare.

5. Compilare la parte successiva del modulo:

   Parametro	Description	Example
   Profilo del contenuto del file	Selezionare un profilo di contenuto: predefinito o KVSet. Il profilo contenuto file predefinito si riferisce allo schema di file di configurazione convenzionale ampiamente adottato dai framework di programmazione o dai sistemi esistenti, supporta i formati di file JSON, YAML o Properties. Il profilo di contenuto del file KVSet fa riferimento a uno schema di file che contiene tutte le proprietà di un valore chiave di Configurazione app, tra cui chiave, valore, etichetta, tipo di contenuto e tag.	Predefinita
   Modalità di importazione	La modalità di importazione viene utilizzata per determinare se ignorare valori di chiave identici. Con l'opzione Ignora corrispondenza , tutti i valori chiave nell'archivio uguali a quelli nel file di configurazione vengono ignorati. Con l'opzione Tutti , tutti i valori chiave nel file di configurazione vengono aggiornati.	Ignora corrispondenza
   Escludi flag di funzionalità	Se selezionato, i flag di funzionalità non verranno importati.	Non selezionata
   Strict	Se la casella è selezionata, tutti i valori chiave nell'archivio con il prefisso e l'etichetta specificati non inclusi nel file di configurazione vengono eliminati quando il profilo contenuto file è impostato su Predefinito. Quando il profilo contenuto file è impostato su KVSet, tutti i valori chiave nell'archivio non inclusi nel file di configurazione vengono eliminati. Se la casella è deselezionata, non verrà eliminato alcun valore chiave nell'archivio.	Non selezionata
   Separatore	Il separatore è il delimitatore usato per appiattire i file JSON o YAML in formato chiave-valore. Verrà ignorato per i file di proprietà e i flag di funzionalità. I valori supportati includono nessun separatore, punto (.), virgola (,), punto e virgola (;), trattino (-), carattere di sottolineatura doppia (_), carattere di sottolineatura doppia (__), barra (/) e due punti (:).	:
   Profondità	Optional. Profondità per rendere flat i file JSON o YAML in coppie chiave-valore. Per impostazione predefinita, i file vengono appiattiti al livello più profondo se è selezionato un separatore. Questa impostazione non è applicabile ai file di proprietà o ai flag di funzionalità.
   Aggiungere il prefisso	Optional. Se specificato, verrà aggiunto un prefisso ai nomi di chiave di tutti i valori chiave importati.	TestApp:
   Aggiungi etichetta	Optional. Se specificato, l'etichetta specificata verrà assegnata a tutti i valori chiave importati.	prod
   Aggiungere il tipo di contenuto	Optional. Se specificato, il tipo di contenuto specificato verrà aggiunto a tutti i valori chiave importati.	JSON (application/json)
   Aggiungere tag	Optional. Se specificato, i tag specificati verranno aggiunti a tutti i valori chiave importati.	{tag: tag1}

6. Selezionare Applica per procedere con l'importazione.

I valori chiave sono stati importati correttamente da un file JSON. I nomi delle chiavi sono stati resi piatti usando il : separatore e preceduti da TestApp:. Tutti i valori chiave importati vengono etichettati come prod, con un tipo di contenuto di application/jsone contrassegnati con tag: tag1.

CLI di Azure

Dall'interfaccia della riga di comando di Azure seguire questa procedura. Se l'interfaccia della riga di comando di Azure non è installata in locale, è possibile usare facoltativamente Azure Cloud Shell.

1. Immettere il comando az appconfig kv import import e aggiungere i parametri seguenti:

   Parametro	Description	Example
   --name	Immettere il nome dell'archivio di Configurazione app in cui si desidera importare i dati.	my-app-config-store
   --source	Immettere file per indicare che si stanno importando i dati di configurazione dell'app da un file.	file
   --path	Immettere il percorso locale del file contenente i dati da importare.	C:/Users/john/Downloads/data.json
   --format	Immettere yaml, proprietà o json per indicare il formato del file che si sta importando.	json

2. Facoltativamente, aggiungere anche i parametri seguenti:

   Parametro	Description	Example
   --separator	Optional. Il separatore è il delimitatore per rendere flat i valori chiave in JSON/YAML. È necessario per esportare la struttura gerarchica e verrà ignorato per i file di proprietà e i flag di funzionalità. Selezionare una delle opzioni seguenti: ., ,, :, ;/, -, _—.	;
   --prefix	Optional. Un prefisso di chiave è la parte iniziale di una chiave. I prefissi possono essere usati per gestire i gruppi di valori chiave in un archivio di configurazione. Questo prefisso verrà aggiunto alla parte anteriore della proprietà "key" di ogni chiave-valore importato.	TestApp:
   --label	Optional. Immettere un'etichetta che verrà assegnata ai valori chiave importati.	prod
   --content-type	Optional. Immettere appconfig/kvset o application/json per dichiarare che il contenuto importato è costituito da un riferimento a Key Vault o da un file JSON.	application/json

   Esempio: importare tutti i valori chiave e i flag di funzionalità da un file JSON, applicare l'etichetta "prod" e aggiungere il prefisso "TestApp". Aggiungere il tipo di contenuto "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. Nella riga di comando viene visualizzato un elenco delle modifiche in arrivo. Confermare l'importazione selezionando y.

   

I valori chiave sono stati importati da un file JSON e sono stati assegnati l'etichetta "prod" e il prefisso "TestApp:". Il separatore ";" viene usato e tutti i valori chiave importati hanno il tipo di contenuto impostato come "JSON".

Per altri parametri e esempi facoltativi, vedere az appconfig kv import.

Importare dati da un archivio di Configurazione app

È possibile importare valori da un archivio di Configurazione app a un altro archivio di Configurazione app oppure importare valori da un archivio di Configurazione app allo stesso archivio di Configurazione app per duplicarne i valori e applicare parametri diversi, ad esempio una nuova etichetta o un tipo di contenuto.

Seguire questa procedura per importare i valori chiave e i flag di funzionalità da un archivio di Configurazione app di Azure.

Portal

Nel portale di Azure seguire questa procedura:

1. Passare all'archivio di Configurazione app e selezionare Importa/esporta dal menu Operazioni .

   

2. Il pulsante di opzione Importa è selezionato per impostazione predefinita. In Tipo di origine selezionare Configurazione app.

3. Selezionare un archivio di Configurazione app da cui importare i dati e compilare il modulo con i parametri seguenti:

   Parametro	Description	Example
   Subscription	La sottoscrizione corrente è selezionata per impostazione predefinita.	my-subscription
   Gruppo di risorse	Selezionare un gruppo di risorse che contiene l'archivio di Configurazione app con la configurazione da importare. Il gruppo di risorse corrente è selezionato per impostazione predefinita.	my-resource-group
   Risorsa	Selezionare l'archivio di Configurazione app che contiene la configurazione da importare.	my-other-app-config-store

4. Compilare la parte successiva del modulo:

   Parametro	Description	Example
   Modalità di selezione	Selezionare se importare da valori chiave normali, ovvero l'opzione predefinita o da uno snapshot.	Predefinita
   Filtro chiavi	Usato per filtrare i valori chiave in base al nome della chiave per l'importazione. Se non vengono specificate chiavi, tutte le chiavi sono idonee.	Inizia con il test
   In un momento specifico	Optional. Compilare questo campo per importare i valori chiave da un punto specifico nel tempo nell'archivio di configurazione selezionato. Per impostazione predefinita, quando lasciato vuoto questo campo viene impostato sul punto corrente nell'orario delle coppie chiave-valore.	28/07/2022 12:00:00
   Da etichetta	Selezionare una o più etichette per importare i valori chiave associati a tali etichette. Se non è selezionata alcuna etichetta, tutte le etichette sono idonee.	prod
   Escludi flag di funzionalità	Se selezionato, i flag di funzionalità non verranno importati.	Non selezionata
   Aggiungere il prefisso	Optional. Se specificato, verrà aggiunto un prefisso ai nomi di chiave di tutti i valori chiave importati.	TestApp:
   Esegui override delle etichette	Optional. Per impostazione predefinita, le etichette originali dei valori chiave di origine vengono mantenute. Per eseguirne l'override, selezionare la casella e immettere una nuova etichetta per i valori chiave importati.	Nuovo
   Sovrascrivere i tipi di contenuto	Optional. Per impostazione predefinita, i tipi di contenuto originali dei valori chiave di origine vengono mantenuti. Per eseguirne l'override, selezionare la casella e immettere un nuovo tipo di contenuto per i valori chiave importati. Si noti che non è possibile eseguire l'override del tipo di contenuto dei flag di funzionalità.	JSON (application/json)

5. Selezionare Applica per procedere con l'importazione.

Hai importato valori chiave da un archivio di configurazione dell'app in data 28 gennaio 2021, alle 00:00, con i nomi delle chiavi che iniziano con test e l'etichetta prod. I nomi delle chiavi sono stati preceduti da TestApp:. A tutti i valori chiave importati sono stati assegnati l'etichetta new e il tipo di application/jsoncontenuto .

CLI di Azure

Dall'interfaccia della riga di comando di Azure seguire questa procedura. Se l'interfaccia della riga di comando di Azure non è installata in locale, è possibile usare facoltativamente Azure Cloud Shell.

1. Immettere il comando az appconfig kv import import e immettere i parametri seguenti:

   Parametro	Description	Example
   --name	Immettere il nome dell'archivio di Configurazione app in cui si desidera importare i dati	my-app-config-store
   --source	Immettere appconfig per indicare che si stanno importando dati da un archivio di Configurazione app.	appconfig
   --src-name	Immettere il nome dell'archivio di Configurazione app da cui si desidera importare i dati.	my-source-app-config
   --src-label	Limitare l'importazione ai valori chiave con un'etichetta specifica. Se non si usa questo parametro, verranno importati solo i valori chiave con un'etichetta Null. Supporta il segno stella come filtro: immettere * per tutte le etichette; abc* per tutte le etichette con abc come prefisso.	prod

2. Facoltativamente, aggiungere i parametri seguenti:

   Parametro	Description	Example
   --label	Optional. Immettere un'etichetta che verrà assegnata ai valori chiave importati.	new
   --content-type	Optional. Immettere appconfig/kvset o application/json per dichiarare che il contenuto importato è costituito da un riferimento a Key Vault o da un file JSON. Il tipo di contenuto può essere sottoposto a override solo per i valori chiave importati. Il tipo di contenuto predefinito per i flag di funzionalità è "application/vnd.microsoft.appconfig.ff+json; charset=utf-8' per impostazione predefinita e non viene aggiornato da questo parametro.	application/json

   Esempio: importare i valori chiave e i flag di funzionalità con l'etichetta "prod" da un'altra configurazione app e assegnarle l'etichetta "new". Aggiungere il tipo di contenuto "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. Nella riga di comando viene visualizzato un elenco delle modifiche in arrivo. Confermare l'importazione selezionando y.

   

Hai importato i valori chiave dall'archivio di App Configuration con l'etichetta "prod" e hai assegnato loro l'etichetta "new". Tutti i valori chiave importati hanno impostato il tipo di contenuto come "JSON".

Per altri parametri e esempi facoltativi, vedere az appconfig kv import.

Importare dati dal servizio app di Azure

Seguire questa procedura per importare i valori chiave dal servizio app di Azure.

Annotazioni

Il servizio app attualmente non supporta i flag di funzionalità. Tutti i flag di funzionalità importati nel servizio app vengono convertiti automaticamente in valori chiave. Le risorse del servizio app possono contenere solo valori chiave.

Portal

Nel portale di Azure:

1. Passare all'archivio di Configurazione app e selezionare Importa/esporta dal menu Operazioni .

   

2. Il pulsante di opzione Importa è selezionato per impostazione predefinita. In Tipo di origine selezionare Servizi app.

3. Selezionare un archivio di Configurazione app da cui importare i dati e compilare il modulo con i parametri seguenti:

   Parametro	Description	Example
   Subscription	La sottoscrizione corrente è selezionata per impostazione predefinita.	my-subscription
   Gruppo di risorse	Selezionare un gruppo di risorse che contiene il servizio app con la configurazione da importare.	my-resource-group
   Risorsa	Selezionare il servizio app che contiene la configurazione da importare.	my-app-service

4. Compilare la parte successiva del modulo:

   Parametro	Description	Example
   Aggiornare le impostazioni per fare riferimento	Se selezionata, le impostazioni dell'app nel Servizio app verranno aggiornate ai riferimenti di Configurazione app per i valori chiave importati. In questo modo è possibile gestire le impostazioni dell'app in Configurazione app in futuro. Il servizio App Service recupererà automaticamente il valore corrente da App Configuration. Per maggiori informazioni, vedere Usare i riferimenti di Configurazione app per il Servizio app e Funzioni di Azure.	Selezionato
   Aggiungere il prefisso	Optional. Se specificato, verrà aggiunto un prefisso ai nomi di chiave di tutti i valori chiave importati.	TestApp:
   Aggiungi etichetta	Optional. Se specificato, l'etichetta specificata verrà assegnata a tutti i valori chiave importati.	prod
   Aggiungere il tipo di contenuto	Optional. Se specificato, il tipo di contenuto specificato verrà aggiunto a tutti i valori chiave importati.	JSON (application/json)

5. Selezionare Applica per procedere con l'importazione.

Tutte le impostazioni dell'applicazione sono state importate da un servizio app come valori chiave e sono state assegnate l'etichetta prod e il prefisso TestApp:. Tutti i valori chiave importati hanno impostato il tipo di contenuto come application/json.

CLI di Azure

Dall'interfaccia della riga di comando di Azure seguire questa procedura. Se l'interfaccia della riga di comando di Azure non è installata in locale, è possibile usare facoltativamente Azure Cloud Shell.

1. Immettere il comando az appconfig kv import import e aggiungere i parametri seguenti:

   Parametro	Description	Example
   --name	Immettere il nome dell'archivio di Configurazione app in cui si desidera importare i dati.	my-app-config-store
   --source	Immettere appservice per indicare che si stanno importando i dati di configurazione dell'app dal servizio app di Azure.	appservice
   --appservice-account	Immettere l'ID ARM del servizio app o usare il nome del servizio app, se si trova nella stessa sottoscrizione e nello stesso gruppo di risorse di Configurazione app.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service o my-app-service

2. Facoltativamente, aggiungere anche i parametri seguenti:

   Parametro	Description	Example
   --prefix	Optional. Un prefisso di chiave è la parte iniziale della proprietà "key" di un valore chiave. I prefissi possono essere usati per gestire i gruppi di valori chiave in un archivio di configurazione. Questo prefisso verrà aggiunto alla parte anteriore della proprietà "key" di ogni chiave-valore importato.	TestApp:
   --label	Optional. Immettere un'etichetta che verrà assegnata ai valori chiave importati. Se non si specifica un'etichetta, l'etichetta Null verrà assegnata ai valori chiave.	prod
   --content-type	Optional. Immettere appconfig/kvset o application/json per indicare che il contenuto importato è costituito da un riferimento a Key Vault o da un file JSON.	application/json

   Per ottenere il valore per --appservice-account, usare il comando az webapp show --resource-group <resource-group> --name <resource-name>.

   Esempio: importare tutte le impostazioni dell'applicazione dal servizio app come valori chiave con l'etichetta "prod", nell'archivio di Configurazione app e aggiungere un prefisso "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. Nella riga di comando viene visualizzato un elenco delle modifiche in arrivo. Confermare l'importazione selezionando y.

   

Tutte le impostazioni dell'applicazione sono state importate dal tuo servizio App come valori chiave, a cui è stata assegnata l'etichetta "prod" e aggiunto il prefisso "TestApp:". Tutti i valori chiave importati hanno il tipo di contenuto impostato come "JSON".

Per altri parametri e esempi facoltativi, vedere az appconfig kv import.

Importare dati da ConfigMap del servizio Azure Kubernetes

Seguire questa procedura per importare i valori chiave da ConfigMap del servizio Azure Kubernetes. Il supporto del portale per questa funzionalità è in fase di sviluppo, si prega di utilizzare l'Azure CLI per importare da AKS.

Portal

Il supporto del portale di Azure per questa funzionalità è in fase di sviluppo.

CLI di Azure

Dall'interfaccia della riga di comando di Azure seguire questa procedura. Se l'interfaccia della riga di comando di Azure non è installata in locale, è possibile usare facoltativamente Azure Cloud Shell.

1. Immettere il comando az appconfig kv import import e aggiungere i parametri seguenti:

   Parametro	Description	Example
   --name	Immettere il nome dell'archivio di Configurazione app in cui si desidera importare i dati.	my-app-config-store
   --source	Immettere aks per indicare che si stanno importando i dati di configurazione dell'app dal servizio Azure Kubernetes.	aks
   --aks-cluster	Immettere l'ID ARM del servizio Azure Kubernetes o usare il nome del servizio Azure Kubernetes, se si trova nella stessa sottoscrizione e nello stesso gruppo di risorse di Configurazione app.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster o my-aks-cluster
   --configmap-namespace	Immettere lo spazio dei nomi dell'oggetto ConfigMap da importare.	default
   --configmap-name	Immettere il nome dell'oggetto ConfigMap da importare.	my-configmap

2. Facoltativamente, aggiungere anche i parametri seguenti:

   Parametro	Description	Example
   --prefix	Optional. Un prefisso di chiave è la parte iniziale della proprietà "key" di un valore chiave. I prefissi possono essere usati per gestire i gruppi di valori chiave in un archivio di configurazione. Questo prefisso verrà aggiunto alla parte anteriore della proprietà "key" di ogni chiave-valore importato.	TestApp:
   --label	Optional. Immettere un'etichetta che verrà assegnata ai valori chiave importati. Se non si specifica un'etichetta, l'etichetta Null verrà assegnata ai valori chiave.	test
   --content-type	Optional. Immettere appconfig/kvset o application/json per indicare che il contenuto importato è costituito da un riferimento a Key Vault o da un file JSON.	application/json
   --format	Optional. Immettere yaml, proprietà o json per indicare il formato di ConfigMap che si sta importando.	json
   --separator	Optional. Il separatore è il delimitatore per rendere flat le coppie chiave-valore. È necessario per esportare la struttura gerarchica e verrà ignorato per i file di proprietà e i flag di funzionalità. Selezionare una delle opzioni seguenti: ., ,, :, ;/, -, _—.	;

   Per ottenere il valore per --aks-cluster, usare il comando az aks show --resource-group <resource-group> --name <aks-cluster-name>.

   Esempio: importare tutte le impostazioni dal tuo AKS Configmap come valori chiave con l'etichetta "test" nel tuo archivio di Configurazione app, e aggiungere il prefisso "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. Nella riga di comando viene visualizzato un elenco delle modifiche in arrivo. Confermare l'importazione selezionando y.

   

Tutte le impostazioni sono state importate dalla ConfigMap AKS come coppie chiave-valore, è stata loro assegnata l'etichetta "test" e aggiunto un prefisso "TestApp:".

Per altri parametri e esempi facoltativi, vedere az appconfig kv import.

Esportazione dei dati

L'esportazione scrive i dati di configurazione archiviati in Configurazione dell'app verso un'altra destinazione. Usare la funzione di esportazione, ad esempio, per salvare i dati da un archivio di Configurazione app in un file che può essere incorporato nel codice dell'applicazione durante la distribuzione.

Questa guida illustra come esportare i dati di Configurazione app:

• in un file di configurazione in JSON, YAML o proprietà
• a un Archivio di configurazione app
• a una risorsa del Servizio App di Azure

Esportare i dati in un file di configurazione

Seguire questa procedura per esportare i dati di configurazione da un archivio di Configurazione app in un file JSON, YAML o Proprietà.

Portal

Nel portale di Azure seguire questa procedura:

1. Vai al tuo archivio di configurazione dell'app e seleziona Importa/Esporta.

   

2. Selezionare il pulsante di opzione Esporta e in Tipo di destinazione selezionare File di configurazione.

3. Compilare il modulo con i parametri seguenti:

   Parametro	Description	Example
   Tipo di file	Selezionare il tipo di file per l'esportazione: YAML, Proprietà o JSON.	JSON
   Profilo del contenuto del file	Selezionare un profilo di contenuto: predefinito o KVSet. Il profilo contenuto file predefinito si riferisce allo schema di file di configurazione convenzionale ampiamente adottato dai framework di programmazione o dai sistemi esistenti, supporta i formati di file JSON, YAML o Properties. Il profilo di contenuto del file KVSet fa riferimento a uno schema di file che contiene tutte le proprietà di un valore chiave di Configurazione app, tra cui chiave, valore, etichetta, tipo di contenuto e tag.	Predefinita
   Modalità di selezione	Selezionare se esportare da valori chiave normali, ovvero l'opzione predefinita o da uno snapshot.	Predefinita
   Filtro chiavi	Usato per filtrare i valori chiave in base al nome della chiave per l'esportazione. Se non vengono specificate chiavi, tutte le chiavi sono idonee.	Inizia con TestApp:
   In un momento specifico	Optional. Compilare questo campo per esportare i valori chiave da un punto specifico nel tempo nell'archivio di configurazione selezionato. Per impostazione predefinita, quando lasciato vuoto questo campo viene impostato sul punto corrente nell'orario delle coppie chiave-valore.	28/07/2022 12:00:00
   Da etichetta	Selezionare l'etichetta per esportare i valori chiave associati a tali etichette. Se non è selezionata alcuna etichetta, tutte le etichette sono idonee. Si noti che è possibile selezionare un'etichetta solo durante l'esportazione con il profilo di contenuto del Default file. Per esportare i valori chiave con più etichette, usare il profilo del contenuto del KVSet file.	prod
   Rimuovere il prefisso	Optional. Se specificato, il prefisso verrà rimosso dai nomi delle chiavi di tutti i valori chiave esportati che lo contengono.	TestApp:
   Separatore	Il separatore è il delimitatore usato per segmentare i nomi delle chiavi e ricostruire le configurazioni gerarchiche per i file JSON o YAML da valori chiave. Verrà ignorato per i file di proprietà e i flag di funzionalità. I valori supportati non includono separatore, punto (.), virgola (,), punto e virgola (;), trattino (-), carattere di sottolineatura doppia (_), carattere di sottolineatura doppia (__), barra (/) e due punti (:).	:

4. Selezionare Esporta per completare l'esportazione.

Hai esportato i valori delle chiavi da un archivio di Configurazione App il 28 luglio 2021 alle 12:00, con nomi di chiavi che iniziano con TestApp: e l'etichetta prod, in un file JSON. Il prefisso TestApp: è stato tagliato dai nomi delle chiavi e il separatore : è stato usato per segmentare i nomi delle chiavi e ricostruire il formato JSON gerarchico.

CLI di Azure

Dall'interfaccia della riga di comando di Azure seguire questa procedura. Se l'interfaccia della riga di comando di Azure non è installata in locale, è possibile usare facoltativamente Azure Cloud Shell.

1. Immettere il comando az appconfig kv export export e aggiungere i parametri seguenti:

   Parametro	Description	Example
   --name	Immettere il nome dell'archivio di Configurazione app che contiene i valori chiave da esportare.	my-app-config-store
   --destination	Immettere file per indicare che si stanno esportando i dati in un file.	file
   --path	Immettere il percorso in cui si desidera salvare il file.	C:/Users/john/Downloads/data.json
   --format	Immettere yamlo propertiesjson per indicare il formato del file da esportare.	json
   --label	Immettere un'etichetta per esportare i valori chiave e i flag di funzionalità con questa etichetta. Se non si specifica un'etichetta, per impostazione predefinita, si esportano solo i valori chiave e i flag di funzionalità senza etichetta. È possibile immettere un'etichetta, immettere diverse etichette separandole con ,o usare * per tenere conto di tutte le etichette.	prod

   Importante

   Se non si seleziona un'etichetta, verranno esportati solo i valori chiave senza etichette. Per esportare un valore chiave con un'etichetta, è necessario selezionarne l'etichetta.

2. Facoltativamente, aggiungere anche i parametri seguenti:

   Parametro	Description	Example
   --separator	Optional. Il separatore è il delimitatore per rendere flat i valori chiave in JSON/YAML. È necessario per esportare la struttura gerarchica e verrà ignorato per i file di proprietà e i flag di funzionalità. Selezionare una delle opzioni seguenti: ., ,, :, ;/, -, _—.	;
   --prefix	Optional. Prefisso da tagliare dalla proprietà "chiave" di ogni coppia chiave-valore. Un prefisso di chiave è la parte iniziale di una chiave. I prefissi possono essere usati per gestire i gruppi di valori chiave in un archivio di configurazione. Il prefisso verrà ignorato per i flag di funzionalità.	TestApp:

   Esempio: esportare tutti i valori chiave e i flag di funzionalità con etichetta "prod" in un file 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 riga di comando visualizza un elenco di valori chiave che vengono esportati nel file. Confermare l'esportazione selezionando y.

   

I flag di funzionalità varianti vengono esportati in un file usando lo schema di Gestione funzionalità Microsoft, mentre altri flag di funzionalità vengono esportati usando lo schema di Gestione funzionalità .NET per la compatibilità. Per esportare i flag di funzionalità esclusivamente usando lo schema di Gestione funzionalità Microsoft, impostare la variabile di ambiente AZURE_APPCONFIG_FM_COMPATIBLE su False.

Sono stati esportati i valori chiave e i flag di funzionalità con l'etichetta "prod" in un file di configurazione ed è stato tagliato il prefisso "TestApp". I valori sono separati da ";" nel file.

Per altri parametri ed esempi facoltativi, vedere az appconfig kv export.

Esportare i dati in un archivio di App Configuration

Seguire questa procedura per esportare i valori chiave e i flag di funzionalità in uno store di App Configuration di Azure.

È possibile esportare i valori da un archivio di Configurazione app a un altro archivio di Configurazione app oppure è possibile esportare i valori da un archivio di Configurazione app allo stesso archivio di Configurazione app per duplicare i valori e applicare parametri diversi, ad esempio una nuova etichetta o un tipo di contenuto.

Portal

Nel portale di Azure seguire questa procedura:

1. Passare all'archivio di Configurazione app che contiene i dati da esportare e selezionare Importa/esporta dal menu Operazioni .

   

2. Selezionare il pulsante di opzione Esporta e in Tipo di destinazione selezionare Configurazione app.

3. Compilare il modulo con i parametri seguenti:

   Parametro	Description	Example
   Modalità di selezione	Selezionare se esportare da valori chiave normali, ovvero l'opzione predefinita o da uno snapshot.	Predefinita
   Filtro chiavi	Usato per filtrare i valori chiave in base al nome della chiave per l'esportazione. Se non vengono specificate chiavi, tutte le chiavi sono idonee.	Inizia con TestApp:
   In un momento specifico	Optional. Compilare questo campo per esportare i valori chiave da un punto specifico nel tempo nell'archivio di configurazione selezionato. Per impostazione predefinita, quando lasciato vuoto questo campo viene impostato sul punto corrente nell'orario delle coppie chiave-valore.	28/07/2022 12:00:00
   Da etichetta	Selezionare una o più etichette per esportare i valori chiave associati a tali etichette. Se non è selezionata alcuna etichetta, tutte le etichette sono idonee.	prod
   Escludi flag di funzionalità	Se selezionato, i flag di funzionalità non verranno esportati.	Non selezionata

4. Selezionare l'archivio di destinazione, compilare il modulo con i parametri seguenti:

   Parametro	Description	Example
   Subscription	La sottoscrizione corrente è selezionata per impostazione predefinita.	my-subscription
   Gruppo di risorse	Selezionare un gruppo di risorse contenente l'archivio di Configurazione app in cui si vuole esportare la configurazione. Il gruppo di risorse corrente è selezionato per impostazione predefinita.	my-resource-group
   Risorsa	Selezionare l'archivio di Configurazione app in cui si vuole esportare la configurazione.	my-other-app-config-store

5. Compilare la parte successiva del modulo:

   Parametro	Description	Example
   Rimuovere il prefisso	Optional. Se specificato, il prefisso verrà rimosso dai nomi delle chiavi di tutti i valori chiave esportati che lo contengono.	TestApp:
   Esegui override delle etichette	Optional. Per impostazione predefinita, le etichette originali dei valori chiave di origine vengono mantenute. Per eseguirne l'override, selezionare la casella e immettere una nuova etichetta per i valori chiave esportati.	Nuovo
   Sovrascrivere i tipi di contenuto	Optional. Per impostazione predefinita, i tipi di contenuto originali dei valori chiave di origine vengono mantenuti. Per eseguirne l'override, selezionare la casella e immettere un nuovo tipo di contenuto per i valori chiave esportati. Si noti che non è possibile eseguire l'override del tipo di contenuto dei flag di funzionalità.	JSON (application/json)

6. Selezionare Applica per procedere con l'esportazione.

I valori chiave sono stati esportati da un archivio di Configurazione app a partire dal 28 luglio 2022, alle 12:00, con i nomi delle chiavi che iniziano con TestApp: e l'etichetta prod, in un altro archivio di Configurazione app. Tutti i valori chiave esportati sono stati tagliati del prefisso della chiave TestApp: e sono stati assegnati l'etichetta new e il tipo di contenuto application/json.

CLI di Azure

Dall'interfaccia della riga di comando di Azure seguire questa procedura. Se l'interfaccia della riga di comando di Azure non è installata in locale, è possibile usare facoltativamente Azure Cloud Shell.

1. Immettere il comando az appconfig kv export export e immettere i parametri seguenti:

   Parametro	Description	Example
   --name	Immettere il nome dell'archivio di Configurazione app che contiene i valori chiave da esportare.	my-app-config-store
   --destination	Immettere appconfig per indicare che si stanno esportando i dati in un store di configurazione dell'applicazione.	appconfig
   --dest-name	Immettere il nome dell'archivio di Configurazione app in cui si vogliono esportare i dati.	my-other-app-config-store
   --label	Immettere un'etichetta per esportare i valori chiave e i flag di funzionalità con questa etichetta. Se non si specifica un'etichetta, per impostazione predefinita, verranno esportati solo i valori chiave e i flag di funzionalità senza etichetta. È possibile immettere un'etichetta, immettere diverse etichette separandole con ,o usare * per prendere tutte le etichette nell'account.	prod

   Importante

   Se i valori chiave da esportare hanno etichette, è necessario usare il comando --label e immettere le etichette corrispondenti. Se non si seleziona un'etichetta, verranno esportati solo i valori chiave senza etichette. Usare un segno di virgola (,) per selezionare diverse etichette o usare * per includere tutte le etichette, inclusa l'etichetta Null (nessuna etichetta).

2. Facoltativamente, aggiungere anche il parametro seguente:

   Parametro	Description	Example
   --dest-label	Optional. Immettere un'etichetta di destinazione per assegnare questa etichetta ai valori chiave esportati.	new

   Esempio: esportare in un altro archivio di Configurazione app le coppie chiave-valore e i flag di funzionalità con l'etichetta "prod" e aggiungere l'etichetta di destinazione "nuova".

   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 riga di comando visualizza un elenco di valori chiave che vengono esportati nei file. Confermare l'esportazione selezionando y.

   

Sono state esportate le coppie chiave-valore e i flag di funzionalità con l'etichetta "prod" da un archivio di Configurazione app ed è stata assegnata l'etichetta "nuova".

Per altri parametri e esempi facoltativi, vedere az appconfig kv import.

Esportare i dati nel servizio app di Azure

Seguire questa procedura per esportare i valori chiave nel servizio app di Azure.

Annotazioni

L'esportazione di flag di funzionalità su App Service non è supportata.

Portal

Nel portale di Azure seguire questa procedura:

1. Passare all'archivio di Configurazione app e selezionare Importa/esporta dal menu Operazioni .

   

2. Selezionare il pulsante di opzione Esporta e in Tipo di destinazione selezionare Servizi app.

3. L'opzione Esporta come riferimento è selezionata per impostazione predefinita. Quando la casella è selezionata, le impostazioni dell'applicazione nel servizio app verranno aggiunte come riferimenti a Configurazione app per i valori chiave esportati. In questo modo è possibile gestire le impostazioni in Configurazione app, con App Service che recupera automaticamente i valori correnti da Configurazione app. Per maggiori informazioni, vedere Usare i riferimenti di Configurazione app per il Servizio app e Funzioni di Azure. Se la casella è deselezionata, la chiave e il valore verranno esportati direttamente nel servizio app. Ricordarsi di esportare nuovamente i dati ogni volta che si apportano modifiche in Configurazione app per assicurarsi che l'applicazione rilevi gli aggiornamenti.

4. Compilare il modulo con i parametri seguenti:

   Parametro	Description	Example
   Modalità di selezione	Selezionare se esportare da valori chiave normali, ovvero l'opzione predefinita o da uno snapshot.	Predefinita
   Filtro chiavi	Usato per filtrare i valori chiave in base al nome della chiave per l'esportazione. Se non vengono specificate chiavi, tutte le chiavi sono idonee.	Inizia con TestApp:
   In un momento specifico	Optional. Compilare questo campo per esportare i valori chiave da un punto specifico nel tempo nell'archivio di configurazione selezionato. Per impostazione predefinita, quando lasciato vuoto questo campo viene impostato sul punto corrente nell'orario delle coppie chiave-valore.	28/07/2022 12:00:00
   Da etichetta	Selezionare un'etichetta per esportare i valori chiave associati a questa etichetta.	prod

5. Selezionare un archivio di destinazione e compilare il modulo con i parametri seguenti:

   Parametro	Description	Example
   Subscription	La sottoscrizione corrente è selezionata per impostazione predefinita.	my-subscription
   Gruppo di risorse	Selezionare un gruppo di risorse contenente il servizio app in cui si vuole esportare la configurazione.	my-resource-group
   Risorsa	Selezionare il servizio app in cui si vuole esportare la configurazione.	my-app-service

6. Facoltativamente, compilare la parte successiva del modulo:

   Parametro	Description	Example
   Rimuovere il prefisso	Optional. Se specificato, il prefisso verrà rimosso dai nomi delle chiavi di tutti i valori chiave esportati che lo contengono.	TestApp:

7. Selezionare Applica per procedere con l'esportazione.

I valori chiave sono stati esportati da un archivio di Configurazione app a partire dal 28 luglio 2022, alle 12:00, con i nomi delle chiavi che iniziano con TestApp: e l'etichetta prod, alle impostazioni applicative della risorsa Servizio app. Il prefisso TestApp: è stato tagliato dai nomi di chiave esportati.

Se è stata selezionata la casella per esportare i valori chiave come riferimenti, i valori chiave esportati vengono indicati come riferimenti a Configurazione app nella colonna "Origine" delle impostazioni di configurazione delle risorse del servizio app.

CLI di Azure

Dall'interfaccia della riga di comando di Azure seguire questa procedura. Se l'interfaccia della riga di comando di Azure non è installata in locale, è possibile usare facoltativamente Azure Cloud Shell.

1. Immettere il comando az appconfig kv export export e immettere i parametri seguenti:

   Parametro	Description	Example
   --name	Immettere il nome dell'archivio di Configurazione app che contiene i valori chiave da esportare.	my-app-config-store
   --destination	Immettere appservice per indicare che si stanno esportando i dati nel servizio app.	appservice
   --appservice-account	Immettere l'ID ARM del servizio app o usare il nome del servizio app, se si trova nella stessa sottoscrizione e nello stesso gruppo di risorse di Configurazione app.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service o my-app-service
   --label	Optional. Immettere un'etichetta per esportare i valori chiave e i flag di funzionalità con questa etichetta. Se non si specifica un'etichetta, per impostazione predefinita, verranno esportati solo i valori chiave e i flag di funzionalità senza etichetta.	prod

   Per ottenere il valore per --appservice-account, usare il comando az webapp show --resource-group <resource-group> --name <resource-name>.

2. Facoltativamente, aggiungere anche un prefisso:

   Parametro	Description	Example
   --prefix	Optional. Prefisso da tagliare dalla proprietà "chiave" da una coppia chiave-valore esportata. Un prefisso di chiave è la parte iniziale di una chiave. I prefissi possono essere usati per gestire i gruppi di valori chiave in un archivio di configurazione.	TestApp:

   Esempio: esportare tutti i valori chiave con l'etichetta "prod" in un'applicazione del servizio app e tagliare il prefisso "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 riga di comando visualizza un elenco di valori chiave che vengono esportati in una risorsa del servizio app. Confermare l'esportazione selezionando y.

   

   Tutti i valori chiave sono stati esportati con l'etichetta "prod" in una risorsa del servizio app di Azure ed è stato tagliato il prefisso "TestApp:".

3. Facoltativamente, specificare un flag da esportare come riferimento alla configurazione dell'app.

   Parametro	Description
   --export-as-reference -r	Optional. Specificare se i valori chiave vengono esportati in Servizio app come riferimenti alla Configurazione dell'app. Ulteriori informazioni.

   Esempio: esportare tutti i valori chiave con l'etichetta "prod" come riferimenti di configurazione dell'applicazione a un'applicazione in 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 riga di comando visualizza un elenco di valori chiave che vengono esportati come riferimenti alla configurazione dell'app a una risorsa del servizio app. Confermare l'esportazione selezionando y.

   

   Tutti i valori chiave sono stati esportati con l'etichetta "prod" come riferimenti alla configurazione dell'app a una risorsa del servizio app di Azure. Nella risorsa dell'App Service, i valori chiave importati verranno indicati come riferimenti alla Configurazione delle app nella colonna "Origine".

   

Per altri parametri ed esempi facoltativi, vedere az appconfig kv export.

Messaggi di errore

Durante l'importazione o l'esportazione dei valori chiave di Configurazione app possono verificarsi i messaggi di errore seguenti:

• L'accesso pubblico è disabilitato per il negozio o si sta accedendo da un endpoint privato che non si trova nelle configurazioni degli endpoint privati del negozio. Se l'archivio di Configurazione app ha endpoint privati abilitati, è possibile accedervi solo dall'interno della rete virtuale configurata per impostazione predefinita. Assicurarsi che il computer che esegue il portale di Azure o l'interfaccia della riga di comando sia aggiunto alla stessa rete virtuale dell'endpoint privato. Se è stato appena abilitato l'accesso alla rete pubblica all'archivio di Configurazione app, attendere almeno 5 minuti prima di riprovare per consentire l'aggiornamento della cache.

Passaggi successivi

Integrare una pipeline CI/CD