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 i dati tra l'archivio di Configurazione app e il progetto del 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 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 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 oppure usando Attività push di Azure Pipeline.

Importare 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 un Archivio di configurazione app
• da Servizio app di Azure

Importare i dati da un file di configurazione

Seguire questa procedura per importare le coppie chiave-valore da un file.

Portale

Seguire questa procedura nel portale di Azure:

1. Andare all'archivio di Configurazione app e selezionare Importa/Esporta nel 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	Descrizione	Esempio
   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	Descrizione	Esempio
   Profilo contenuto file	Selezionare un profilo di contenuto: Predefinito o KVSet. Il profilo di 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 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 selezionata, i flag di funzionalità non verranno importati.	Non selezionato
   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 selezionato
   Separatore	Il separatore è il delimitatore usato per rendere flat i file JSON o YAML in 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 (:).	:
   Livello di annidamento	Facoltativo. 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à.
   Aggiungi prefisso	Facoltativo. Se specificato, verrà aggiunto un prefisso ai nomi di chiave di tutti i valori chiave importati.	TestApp:
   Aggiungi etichetta	Facoltativo. Se specificato, l'etichetta specificata verrà assegnata a tutti i valori chiave importati.	prod
   Aggiungi tipo di contenuto	Facoltativo. Se specificato, il tipo di contenuto specificato verrà aggiunto a tutti i valori chiave importati.	JSON (applicazione/JSON)
   Aggiungere i tag	Facoltativo. 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 appiattiti usando il separatore : e preceduti da TestApp:. Tutti i valori chiave importati vengono etichettati come prod, con un tipo di contenuto di application/json e contrassegnati con tag: tag1.

Interfaccia della riga di comando di Azure

Dall'interfaccia della riga di comando di Azure seguire la procedura di seguito. Se l'interfaccia della riga di comando di Azure non è installata in locale, in via opzionale è possibile usare Azure Cloud Shell.

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

   Parametro	Descrizione	Esempio
   --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 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	Descrizione	Esempio
   --separator	Facoltativo. Il separatore è il delimitatore per rendere flat le coppie chiave-valore in JSON/YAML. È necessario per esportare la struttura gerarchica e sarà ignorato per i file di proprietà e i flag di funzionalità. Selezionare una delle opzioni seguenti: ., ,, :, ;, /, -, _, —.	;
   --prefix	Facoltativo. Un prefisso di chiave è la parte iniziale di una chiave. I prefissi possono essere usati per gestire i gruppi di coppie chiave-valore in un archivio di configurazione. Questo prefisso verrà aggiunto alla parte anteriore della proprietà "chiave" di ogni coppia chiave-valore importata.	TestApp:
   --label	Facoltativo. Immettere un'etichetta che verrà assegnata alle coppie chiave-valore importate.	prod
   --content-type	Facoltativo. 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 tutte le coppie chiave-valore e i flag di funzionalità da un file JSON, applicare l'etichetta "prod" e aggiungere il prefisso "TestApp". Aggiungere il tipo di contenuto "applicazione/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 riga di comando visualizza un elenco delle modifiche in arrivo. Confermare l'importazione selezionando y.

   

Sono state importate le coppie chiave-valore da un file JSON e vi sono stati assegnati l'etichetta "prod" e il prefisso "TestApp". Viene usato il separatore ";" e in tutte le coppie chiave-valore importate è impostato il tipo di contenuto "JSON".

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

Importare i dati da un archivio di Configurazione app

È possibile importare valori tra archivi di Configurazione app, oppure importarli da un archivio di Configurazione app allo stesso archivio di Configurazione app per duplicarli e applicare parametri diversi, ad esempio una nuova etichetta o un tipo di contenuto.

Seguire questa procedura per importare le coppie chiave-valore e i flag di funzionalità da un archivio di Configurazione app di Azure.

Portale

Seguire questa procedura nel portale di Azure:

1. Andare all'archivio di Configurazione app e selezionare Importa/Esporta nel menu Operazioni.

   

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

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

   Parametro	Descrizione	Esempio
   Abbonamento	La sottoscrizione corrente è selezionata per impostazione predefinita.	my-subscription
   Gruppo di risorse	Selezionare un gruppo di risorse contenente l'archivio di Configurazione app con la configurazione da importare. Il gruppo di risorse corrente è selezionato per impostazione predefinita.	my-resource-group
   Conto risorse	Selezionare l'archivio di Configurazione app contenente la configurazione da importare.	my-other-app-config-store

4. Compilare la parte successiva del modulo:

   Parametro	Descrizione	Esempio
   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 test
   A un'ora specifica	Facoltativo. 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 selezionata, i flag di funzionalità non verranno importati.	Non selezionato
   Aggiungi prefisso	Facoltativo. Se specificato, verrà aggiunto un prefisso ai nomi di chiave di tutti i valori chiave importati.	TestApp:
   Esegui override delle etichette	Facoltativo. 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
   Esegui override dei tipi di contenuto	Facoltativo. 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 (applicazione/JSON)

5. Selezionare Applica per procedere con l'importazione.

I valori chiave sono stati importati da un archivio di Configurazione app a partire dal 28 gennaio 2021, alle 12: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 contenuto application/json.

Interfaccia della riga di comando di Azure

Dall'interfaccia della riga di comando di Azure seguire la procedura di seguito. Se l'interfaccia della riga di comando di Azure non è installata in locale, in via opzionale è possibile usare Azure Cloud Shell.

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

   Parametro	Descrizione	Esempio
   --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 alle coppie chiave-valore con un'etichetta specifica. Se non si usa questo parametro, saranno importate solo le coppie chiave-valore con 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	Descrizione	Esempio
   --label	Facoltativo. Immettere un'etichetta che verrà assegnata alle coppie chiave-valore importate.	new
   --content-type	Facoltativo. 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 le coppie chiave-valore importate. Per modalità predefinita, il tipo di contenuto predefinito per i flag di funzionalità è "application/vnd.microsoft.appconfig.ff+json;charset=utf-8' e non viene aggiornato da questo parametro.	application/json

   Esempio: importare le coppie chiave-valore e i flag di funzionalità con l'etichetta "prod" da un'altra Configurazione app e assegnare l'etichetta "Nuova". Aggiungere il tipo di contenuto "applicazione/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 riga di comando visualizza un elenco delle modifiche in arrivo. Confermare l'importazione selezionando y.

   

Le coppie chiave-valore sono state importate con l'etichetta "prod" da un archivio di Configurazione app ed è stata assegnata l'etichetta "nuova". In tutte le coppie chiave-valore importate è impostato il tipo di contenuto "JSON".

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

Importare i dati dal Servizio app di Azure

Seguire questa procedura per importare le coppie chiave-valore dal Servizio app di Azure.

Nota

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

Portale

Dal portale di Azure:

1. Andare all'archivio di Configurazione app e selezionare Importa/Esporta nel menu Operazioni.

   

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

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

   Parametro	Descrizione	Esempio
   Abbonamento	La sottoscrizione corrente è selezionata per impostazione predefinita.	my-subscription
   Gruppo di risorse	Selezionare un gruppo di risorse contenente il servizio app con la configurazione da importare.	my-resource-group
   Conto risorse	Selezionare il servizio app contenente la configurazione da importare.	my-app-service

4. Compilare la parte successiva del modulo:

   Parametro	Descrizione	Esempio
   Aggiorna impostazioni di 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 eseguirà automaticamente il pull del valore corrente da Configurazione app. Per maggiori informazioni, vedere Usare i riferimenti di Configurazione app per il Servizio app e Funzioni di Azure.	Selezionato
   Aggiungi prefisso	Facoltativo. Se specificato, verrà aggiunto un prefisso ai nomi di chiave di tutti i valori chiave importati.	TestApp:
   Aggiungi etichetta	Facoltativo. Se specificato, l'etichetta specificata verrà assegnata a tutti i valori chiave importati.	prod
   Aggiungi tipo di contenuto	Facoltativo. Se specificato, il tipo di contenuto specificato verrà aggiunto a tutti i valori chiave importati.	JSON (applicazione/JSON)

5. Selezionare Applica per procedere con l'importazione.

Tutte le impostazioni dell'applicazione sono state importate da un Servizio app come coppie chiave-valore e sono stati assegnati l'etichetta prod e il prefisso TestApp:. In tutte le coppie chiave-valore importate è impostato il tipo di contenuto application/json.

Interfaccia della riga di comando di Azure

Dall'interfaccia della riga di comando di Azure seguire la procedura di seguito. Se l'interfaccia della riga di comando di Azure non è installata in locale, in via opzionale è possibile usare Azure Cloud Shell.

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

   Parametro	Descrizione	Esempio
   --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 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 oppure my-app-service

2. Facoltativamente, aggiungere anche i parametri seguenti:

   Parametro	Descrizione	Esempio
   --prefix	Facoltativo. Un prefisso di chiave è la parte iniziale della proprietà "chiave" di una coppia chiave-valore. I prefissi possono essere usati per gestire i gruppi di coppie chiave-valore in un archivio di configurazione. Questo prefisso verrà aggiunto alla parte anteriore della proprietà "chiave" di ogni coppia chiave-valore importata.	TestApp:
   --label	Facoltativo. Immettere un'etichetta che verrà assegnata alle coppie chiave-valore importate. Se non si specifica un'etichetta, alle coppie chiave-valore sarà assegnata l’etichetta null.	prod
   --content-type	Facoltativo. Immettere appconfig/kvset o applicazione/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 nell'archivio di Configurazione app tutte le impostazioni dell'applicazione dal servizio app come coppie chiave-valore con l'etichetta "prod", quindi 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. La riga di comando visualizza un elenco delle modifiche in arrivo. Confermare l'importazione selezionando y.

   

Tutte le impostazioni dell'applicazione sono state importate dal servizio app come coppie chiave-valore, sono stati assegnati l'etichetta "prod" ed è stato aggiunto un prefisso "TestApp:". In tutte le coppie chiave-valore che sono state importate è impostato il tipo di contenuto "JSON".

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

Esportare dati

L'esportazione scrive in un’altra destinazione i dati archiviati in Configurazione app. 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
• in 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à.

Portale

Seguire questa procedura nel portale di Azure:

1. Andare all'archivio di Configurazione app e selezionare 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	Descrizione	Esempio
   Tipo di file	Selezionare il tipo di file per l'esportazione: YAML, Proprietà o JSON.	JSON
   Profilo contenuto file	Selezionare un profilo di contenuto: Predefinito o KVSet. Il profilo di 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 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:
   A un'ora specifica	Facoltativo. 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 file Default. Per esportare i valori chiave con più di un'etichetta, usare il profilo di contenuto del file KVSet.	prod
   Rimuovere il prefisso	Facoltativo. 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.

I valori delle chiavi sono stati esportati da un archivio di Configurazione app a partire dal 28 luglio 2021 alle 12:00, con i nomi delle 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.

Interfaccia della riga di comando di Azure

Dall'interfaccia della riga di comando di Azure seguire la procedura di seguito. Se l'interfaccia della riga di comando di Azure non è installata in locale, in via opzionale è possibile usare Azure Cloud Shell.

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

   Parametro	Descrizione	Esempio
   --name	Immettere il nome dell'archivio di Configurazione app contenente le coppie chiave-valore 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 yaml, properties o json per indicare il formato del file da esportare.	json
   --label	Immettere un'etichetta per esportare le coppie chiave-valore e i flag di funzionalità con questa etichetta. Se non si specifica un'etichetta, per impostazione predefinita verranno esportate solo le coppie chiave-valore 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 esportate solo le coppie chiave-valore senza etichette. Per esportare una coppia chiave-valore con un'etichetta, è necessario selezionarne l'etichetta.

2. Facoltativamente, aggiungere anche i parametri seguenti:

   Parametro	Descrizione	Esempio
   --separator	Facoltativo. Il separatore è il delimitatore per rendere flat le coppie chiave-valore in JSON/YAML. È necessario per esportare la struttura gerarchica e sarà ignorato per i file di proprietà e i flag di funzionalità. Selezionare una delle opzioni seguenti: ., ,, :, ;, /, -, _, —.	;
   --prefix	Facoltativo. 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 coppie chiave-valore in un archivio di configurazione. Il prefisso verrà ignorato per i flag di funzionalità.	TestApp:

   Esempio: esportare tutte le coppie chiave-valore 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 coppie chiave-valore che vengono esportate nel file. Confermare l'esportazione selezionando y.

   

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

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

Esportare i dati in un archivio di Configurazione app

Seguire questa procedura per esportare le coppie chiave-valore e i flag di funzionalità in un archivio di Configurazione app di Azure.

È possibile esportare valori tra archivi di Configurazione app, oppure esportarli da un archivio di Configurazione app allo stesso archivio di Configurazione app per duplicarli e applicare parametri diversi, ad esempio una nuova etichetta o un tipo di contenuto.

Portale

Seguire questa procedura nel portale di Azure:

1. Andare all'archivio di Configurazione app contenente i dati da esportare e selezionare Importa/Esporta nel 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	Descrizione	Esempio
   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:
   A un'ora specifica	Facoltativo. 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 selezionata, i flag di funzionalità non verranno esportati.	Non selezionato

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

   Parametro	Descrizione	Esempio
   Abbonamento	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
   Conto risorse	Selezionare l'archivio di Configurazione app in cui si desidera esportare la configurazione.	my-other-app-config-store

5. Compilare la parte successiva del modulo:

   Parametro	Descrizione	Esempio
   Rimuovere il prefisso	Facoltativo. Se specificato, il prefisso verrà rimosso dai nomi delle chiavi di tutti i valori chiave esportati che lo contengono.	TestApp:
   Esegui override delle etichette	Facoltativo. 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
   Esegui override dei tipi di contenuto	Facoltativo. 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 (applicazione/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 il prefisso TestApp:della chiave e sono stati assegnati l'etichetta new e il tipo di application/jsoncontenuto.

Interfaccia della riga di comando di Azure

Dall'interfaccia della riga di comando di Azure seguire la procedura di seguito. Se l'interfaccia della riga di comando di Azure non è installata in locale, in via opzionale è possibile usare Azure Cloud Shell.

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

   Parametro	Descrizione	Esempio
   --name	Immettere il nome dell'archivio di Configurazione app contenente le coppie chiave-valore da esportare.	my-app-config-store
   --destination	Immettere appconfig per indicare che si stanno esportando i dati in un archivio di Configurazione app.	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 le coppie chiave-valore e i flag di funzionalità con questa etichetta. Se non si specifica un'etichetta, per impostazione predefinita, verranno esportate solo le coppie chiave-valore 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 le coppie chiave-valore da esportare hanno le etichette, è necessario usare il comando --label e immettere le etichette corrispondenti. Se non si seleziona un'etichetta, verranno esportate solo le coppie chiave-valore 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	Descrizione	Esempio
   --dest-label	Facoltativo. Immettere un'etichetta di destinazione per assegnarla alle coppie chiave-valore esportate.	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 coppie chiave-valore che vengono esportate 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 i passi di seguito per esportare le coppie chiave-valore nel servizio app di Azure.

Nota

L'esportazione di flag di funzionalità nel Servizio app non è supportata.

Portale

Seguire questa procedura nel portale di Azure:

1. Andare all'archivio di Configurazione app e selezionare Importa/Esporta nel 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 il Servizio app che esegue automaticamente il pull dei 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	Descrizione	Esempio
   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:
   A un'ora specifica	Facoltativo. 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	Descrizione	Esempio
   Abbonamento	La sottoscrizione corrente è selezionata per impostazione predefinita.	my-subscription
   Gruppo di risorse	Selezionare un gruppo di risorse contenente il Servizio app in cui si desidera esportare la configurazione.	my-resource-group
   Conto risorse	Selezionare il Servizio app in cui si desidera esportare la configurazione.	my-app-service

6. Facoltativamente, compilare la parte successiva del modulo:

   Parametro	Descrizione	Esempio
   Rimuovere il prefisso	Facoltativo. 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 eliminato dai nomi di chiave esportati.

Se è stata selezionata la casella per esportare le coppie chiave-valore come riferimenti, le coppie chiave-valore esportate vengono indicate come riferimenti a Configurazione app nella colonna "Origine" delle impostazioni di configurazione per le risorse del servizio app.

Interfaccia della riga di comando di Azure

Dall'interfaccia della riga di comando di Azure seguire la procedura di seguito. Se l'interfaccia della riga di comando di Azure non è installata in locale, in via opzionale è possibile usare Azure Cloud Shell.

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

   Parametro	Descrizione	Esempio
   --name	Immettere il nome dell'archivio di Configurazione app contenente le coppie chiave-valore 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 oppure my-app-service
   --label	Facoltativo. Immettere un'etichetta per esportare le coppie chiave-valore e i flag di funzionalità con questa etichetta. Se non si specifica un'etichetta, per impostazione predefinita verranno esportati solo le coppie chiave-valore 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	Descrizione	Esempio
   --prefix	Facoltativo. 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 coppie chiave-valore in un archivio di configurazione.	TestApp:

   Esempio: esportare in un'applicazione del servizio app tutte le coppie chiave-valore con etichetta "prod" 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 coppie chiave-valore che vengono esportate nella risorsa del servizio app. Confermare l'esportazione selezionando y.

   

   Tutte le coppie chiave-valore sono state esportate 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 a Configurazione app.

   Parametro	Descrizione
   --export-as-reference -r	Facoltativo. Specificare se le coppie chiave-valore vengono esportate nel servizio app come riferimenti a Configurazione app. Altre informazioni.

   Esempio: esportare in un'applicazione del servizio app tutte le coppie chiave-valore con etichetta "prod" come riferimenti alla configurazione dell'app.

   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 coppie chiave-valore che vengono esportate in una risorsa del servizio app come riferimenti alla configurazione app. Confermare l'esportazione selezionando y.

   

   Tutte le coppie chiave-valore con etichetta "prod" sono state esportate a una risorsa del servizio app di Azure come riferimenti alla configurazione dell'app. Nella risorsa del servizio app le coppie chiave-valore importate verranno indicate come riferimenti a Configurazione app nella colonna "Origine".

   

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

Messaggi di errore

Durante l'importazione o l'esportazione delle coppie chiave-valore di Configurazione app possono verificarsi i messaggi di errore seguenti:

• L'accesso pubblico è disabilitato per l'archivio o per l’accesso da un endpoint privato che non si trova nelle configurazioni dell'endpoint privato dell'archivio. 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 in cui è in esecuzione 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