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 e il progetto di codice Configurazione app. Ad esempio, è possibile configurare un archivio Configurazione app per il test e un altro per la produzione. È possibile copiare le impostazioni dell'applicazione tra di esse in modo che non sia necessario immettere due volte i dati.

Questo articolo fornisce una guida per l'importazione e l'esportazione dei dati con Configurazione app. Se si vuole configurare una sincronizzazione continua con il repository GitHub, esaminare le attività GitHub Actions e Azure Pipelines.

È possibile importare o esportare dati usando il portale di Azure o l'interfaccia della riga di comando di Azure.

Importa dati

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

Questa guida illustra come importare dati Configurazione app:

• da un file di configurazione in Json, Yaml o Proprietà
• da un archivio Configurazione app
• da Servizio app di Azure

Importare dati da un file di configurazione

Seguire la procedura seguente per importare i valori chiave da un file.

Nota

L'importazione di flag di funzionalità da un file non è supportata. Se un file di configurazione contiene flag di funzionalità, verranno importati automaticamente come valori chiave regolari.

Portale

Seguire questa procedura nel portale di Azure:

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

   

2. Nella scheda Importa selezionare File di configurazione in Servizio di origine.

3. Compilare il modulo con i parametri seguenti:

   Parametro	Descrizione	Esempio
   Per la lingua	Scegliere il linguaggio del file che si sta importando tra .NET, Java (Spring) e Altro.	.NET
   Tipo file	Selezionare il tipo di file che si sta importando tra Yaml, Proprietà e Json.	Json

4. Selezionare l'icona Cartella e passare al file da importare.

   Nota

   Viene visualizzato un messaggio sullo schermo, che indica che il file è stato recuperato correttamente.

5. Compilare la parte successiva del modulo:

   Parametro	Descrizione	Esempio
   Separatore	Il separatore è il carattere analizzato nel file di configurazione importato in modo da separare i valori chiave che verranno aggiunti all'archivio di configurazione. Selezionare una delle opzioni seguenti: ., ,, :, ;/- , , _, — .	;
   Prefisso	Facoltativa. 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. Il prefisso immesso verrà aggiunto alla parte anteriore della proprietà "key" di ogni valore chiave importato da questo file.	Testapp:
   Etichetta	Facoltativa. Selezionare un'etichetta esistente o immettere una nuova etichetta che verrà assegnata ai valori chiave importati.	Prod
   Tipo di contenuto	Facoltativa. Indica se si importa un file JSON o Key Vault riferimenti. Per altre informazioni sui riferimenti Key Vault, vedere Usare riferimenti Key Vault in un'app ASP.NET Core.	JSON (application/json)

6. Selezionare Applica per procedere con l'importazione.

Sono stati importati i valori chiave da un file JSON, hanno assegnato loro 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".

Interfaccia della riga di comando 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 di importazione e aggiungere i parametri seguenti:

   Parametro	Descrizione	Esempio
   --name	Immettere il nome dell'archivio Configurazione app a cui si desidera importare i dati.	my-app-config-store
   --source	Immettere file per indicare che si importano 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 importato.	json

2. Facoltativamente, aggiungere anche i parametri seguenti:

   Parametro	Descrizione	Esempio
   --separator	Facoltativa. Il separatore è il delimitatore per l'appiattimento dei valori chiave in Json/Yaml. È necessario per l'esportazione della struttura gerarchica e verrà ignorato per i file di proprietà e i flag di funzionalità. Selezionare una delle opzioni seguenti: ., ,-:—;/_.	;
   --prefix	Facoltativa. Un prefisso 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 importata.	TestApp:
   --label	Facoltativa. Immettere un'etichetta che verrà assegnata ai valori chiave importati.	prod
   --content-type	Facoltativa. Immettere appconfig/kvset o application/json per stato che il contenuto importato è costituito da un riferimento Key Vault o da un file JSON.	application/json

   Esempio: importare tutti i flag chiave-valori e 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. La riga di comando visualizza un elenco delle modifiche in arrivo. Confermare l'importazione selezionando y.

   

Sono stati importati i valori chiave da un file JSON, hanno assegnato loro 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, passare ad az appconfig kv import.

Importare dati da un archivio Configurazione app

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

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

Portale

Seguire questa procedura nel portale di Azure:

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

   

2. Nella scheda Importa selezionare Configurazione app in Servizio di origine.

3. Selezionare Seleziona risorsa, compilare il modulo con i parametri seguenti e selezionare Applica:

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

   Nota

   Il messaggio "Chiavi di accesso recuperate correttamente" indica che la connessione con l'archivio Configurazione app è stata completata.

4. Compilare la parte successiva del modulo:

   Parametro	Descrizione	Esempio
   Dall'etichetta	Selezionare almeno un'etichetta per importare valori con le etichette corrispondenti. Selezionare tutti importare i valori chiave con qualsiasi etichetta e (Nessuna etichetta) limita l'importazione ai valori chiave senza etichetta.	Prod
   In un momento specifico	Facoltativa. Compilare per importare i valori chiave da un momento specifico. Si tratta del momento dei valori chiave nell'archivio di configurazione selezionato. Formato: "AAAAA-MM-DDThh:mm:ssZ". Questo campo viene impostato per impostazione predefinita sul punto corrente nel momento in cui i valori chiave vengono lasciati vuoti.	07/28/2022 12:00:00 AM
   Eseguire l'override delle etichette chiave-valore predefinite	Facoltativa. Per impostazione predefinita, gli elementi importati usano l'etichetta corrente. Selezionare la casella e immettere un'etichetta per eseguire l'override di queste impostazioni predefinite con un'etichetta personalizzata.	Nuovo
   Eseguire l'override del tipo di contenuto chiave-valore predefinito	Facoltativa. Per impostazione predefinita, gli elementi importati usano il tipo di contenuto corrente. Selezionare la casella e selezionare Key Vault Riferimento o JSON (application/json) in Tipo di contenuto per stato che il contenuto importato è costituito da un riferimento 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" e non viene aggiornato da questo parametro.	JSON (application/json)

5. Selezionare Applica per procedere con l'importazione.

Sono stati importati valori chiave e flag di funzionalità con l'etichetta "prod" da un archivio Configurazione app il 28 gennaio 2021 alle 12. Tutti i valori chiave importati hanno il tipo di contenuto impostato come "JSON".

Interfaccia della riga di comando 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 di importazione e immettere i parametri seguenti:

   Parametro	Descrizione	Esempio
   --name	Immettere il nome dell'archivio Configurazione app in cui si desidera importare i dati	my-app-config-store
   --source	Immettere appconfig per indicare che si importano dati da un archivio Configurazione app.	appconfig
   --src-name	Immettere il nome dell'archivio 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 star firma 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	Facoltativa. Immettere un'etichetta che verrà assegnata ai valori chiave importati.	new
   --content-type	Facoltativa. Immettere appconfig/kvset o application/json per stato che il contenuto importato è costituito da un riferimento 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. La riga di comando visualizza un elenco delle modifiche in arrivo. Confermare l'importazione selezionando y.

   

I valori chiave sono stati importati con l'etichetta "prod" da un archivio Configurazione app e li hanno assegnati all'etichetta "new". Tutti i valori chiave importati hanno il tipo di contenuto impostato come "JSON".

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

Importare dati da Servizio app di Azure

Seguire la procedura seguente per importare i valori chiave da Servizio app di Azure.

Nota

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

Portale

Nel portale di Azure:

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

   

2. Nella scheda Importa selezionare Servizi app in Servizio di origine.

3. Selezionare Seleziona risorsa, compilare il modulo con i parametri seguenti e selezionare Applica:

   Parametro	Descrizione	Esempio
   Subscription	La sottoscrizione corrente è selezionata per impostazione predefinita.	my-subscription
   Resource group	Selezionare un gruppo di risorse contenente 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

   Nota

   Viene visualizzato un messaggio che indica il numero di valori chiave recuperati correttamente dalla risorsa di origine servizio app.

4. Compilare la parte successiva del modulo:

   Parametro	Descrizione	Esempio
   Prefisso	Facoltativa. 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:
   Etichetta	Facoltativa. Selezionare un'etichetta esistente o immettere una nuova etichetta che verrà assegnata ai valori chiave importati.	Prod
   Tipo di contenuto	Facoltativa. Indicare se il file che si sta importando è un riferimento Key Vault o un file JSON. Per altre informazioni sui riferimenti Key Vault, vedere Usare riferimenti Key Vault in un'app ASP.NET Core.	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 il tipo di contenuto impostato come "JSON".

Interfaccia della riga di comando 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	Descrizione	Esempio
   --name	Immettere il nome dell'archivio Configurazione app in cui si desidera importare i dati.	my-app-config-store
   --source	Immettere appservice per indicare che si importano i dati di configurazione dell'app da 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 del 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	Descrizione	Esempio
   --prefix	Facoltativa. 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	Facoltativa. Immettere un'etichetta che verrà assegnata ai valori chiave importati. Se non si specifica un'etichetta, l'etichetta Null verrà assegnata ai valori chiave.If you don't specify a label, the null label will be assigned to your key-values.	prod
   --content-type	Facoltativa. Immettere appconfig/kvset o application/json per indicare che il contenuto importato è costituito da un riferimento 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 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. 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 valori chiave, sono state assegnate all'etichetta "prod" e sono stati aggiunti un 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.

Esportare i dati

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

Questa guida illustra come esportare Configurazione app dati:

• in un file di configurazione in Json, Yaml o Proprietà
• a un archivio Configurazione app
• a una risorsa 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 dell'app in un file Json, Yaml o Properties.

Nota

L'esportazione di flag di funzionalità da un archivio Configurazione app in un file di configurazione è attualmente supportata solo nell'interfaccia della riga di comando.

Portale

Dalla portale di Azure seguire questa procedura:

1. Passare all'archivio Configurazione app e selezionare Importa/esporta.

   

2. Nella scheda Esporta selezionare File di configurazione in Servizio di destinazione.

3. Compilare il modulo con i parametri seguenti:

   Parametro	Descrizione	Esempio
   Prefisso	Facoltativa. Questo prefisso verrà tagliato dalla proprietà "key" di ogni 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.	Testapp:
   Da etichetta	Selezionare un'etichetta esistente per limitare l'esportazione ai valori chiave con un'etichetta specifica. Se non si seleziona un'etichetta, per impostazione predefinita verranno esportati solo i valori chiave con l'etichetta "Nessuna etichetta". Vedere la nota che segue.	Prod
   In un momento specifico	Facoltativa. Compilare per importare i valori chiave da un momento specifico. Si tratta del momento dei valori chiave nell'archivio di configurazione selezionato. Formato: "AAAAA-MM-DDThh:mm:ssZ". Questo campo viene impostato per impostazione predefinita sul punto corrente nel momento in cui i valori chiave vengono lasciati vuoti.	07/28/2022 12:00:00 AM
   Tipo file	Selezionare il tipo di file esportato tra Yaml, Proprietà o Json.	JSON
   Separatore	Il separatore è il delimitatore per l'appiattimento dei valori chiave in Json/Yaml. Supporta la struttura gerarchica della configurazione e non si applica ai file di proprietà e ai flag di funzionalità. Selezionare una delle opzioni seguenti: ., ,,/- ,, _, o(Nessun separatore).	;

   Importante

   Se non si seleziona un'etichetta Da, verranno esportati solo i valori chiave senza etichette. Per esportare un valore chiave con un'etichetta, è necessario selezionarne l'etichetta. Si noti che è possibile selezionare solo un'etichetta per ogni esportazione nel portale, nel caso in cui si desidera esportare i valori chiave con tutte le etichette specificate, usare l'interfaccia della riga di comando.

4. Selezionare Esporta per completare l'esportazione.

I valori chiave sono stati esportati con l'etichetta "prod" da un file di configurazione, allo stato 07/28/2021 12:00:00:00 e hanno tagliato il prefisso "TestApp". I valori sono separati da ";" nel file.

Interfaccia della riga di comando 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 di esportazione e aggiungere i parametri seguenti:

   Parametro	Descrizione	Esempio
   --name	Immettere il nome dell'archivio Configurazione app contenente i valori chiave da esportare.	my-app-config-store
   --destination	Immettere file per indicare che si esportano dati in un file.	file
   --path	Immettere il percorso in cui si vuole 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 usando * per prendere tutte le etichette nell'account.	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	Descrizione	Esempio
   --separator	Facoltativa. Il separatore è il delimitatore per l'appiattimento dei valori chiave in Json/Yaml. È necessario per l'esportazione della struttura gerarchica e verrà ignorato per i file di proprietà e i flag di funzionalità. Selezionare una delle opzioni seguenti: ., ,-:—;/_.	;
   --prefix	Facoltativa. Prefisso da tagliare dalla proprietà "key-value" di ogni chiave. Un prefisso 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 flag chiave-valori e 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.

   

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

Per altri parametri e esempi facoltativi, passare ad az appconfig kv export.

Esportare i dati in un archivio Configurazione app

Seguire la procedura seguente per esportare i valori chiave e i flag di funzionalità in un archivio Configurazione app di Azure.

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

Portale

Seguire questa procedura nel portale di Azure:

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

   

2. Nella scheda Esporta selezionare Configurazione app in Servizio di destinazione.

3. Selezionare Seleziona risorsa, compilare il modulo con i parametri seguenti e selezionare Applica:

   Parametro	Descrizione	Esempio
   Subscription	La sottoscrizione corrente è selezionata per impostazione predefinita.	my-subscription
   Resource group	Selezionare un gruppo di risorse contenente l'archivio Configurazione app con la configurazione da importare.	my-resource-group
   Risorsa	Selezionare l'archivio Configurazione app contenente la configurazione da importare.	my-app-config-store

4. La pagina visualizza ora il servizio di destinazione selezionato e l'ID risorsa. L'azione Seleziona risorsa consente di passare a un altro archivio di Configurazione app di origine.

   Nota

   Viene visualizzato un messaggio sullo schermo, che indica che i valori chiave sono stati recuperati correttamente.

5. Compilare la parte successiva del modulo:

   Parametro	Descrizione	Esempio
   Dall'etichetta	Selezionare almeno un'etichetta per esportare i valori con le etichette corrispondenti. Selezionare tutti esportare i valori chiave con qualsiasi etichetta e (Nessuna etichetta) limita l'esportazione ai valori chiave senza etichetta.	Prod
   In un momento specifico	Facoltativa. Compilare per importare i valori chiave da un momento specifico. Si tratta del momento dei valori chiave nell'archivio di configurazione selezionato. Formato: "AAAAA-MM-DDThh:mm:ssZ". Questo campo viene impostato per impostazione predefinita sul punto corrente nel momento in cui i valori chiave vengono lasciati vuoti.	07/28/2022 12:00:00 AM
   Eseguire l'override delle etichette chiave-valore predefinite	Facoltativa. Per impostazione predefinita, gli elementi importati usano l'etichetta corrente. Selezionare la casella e immettere un'etichetta per eseguire l'override di queste impostazioni predefinite con un'etichetta personalizzata.	Nuovo

6. Selezionare Applica per procedere con l'esportazione.

Sono stati esportati i valori chiave e i flag di funzionalità con l'etichetta "prod" da un archivio Configurazione app, con lo stato 28/07/2022 12:00:00 AM e sono stati assegnati l'etichetta "new".

Interfaccia della riga di comando 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 di esportazione e immettere i parametri seguenti:

   Parametro	Descrizione	Esempio
   --name	Immettere il nome dell'archivio Configurazione app contenente i valori chiave da esportare.	my-app-config-store
   --destination	Immettere appconfig per indicare che si esportano dati in un archivio Configurazione app.	appconfig
   --dest-name	Immettere il nome dell'archivio Configurazione app in cui si desidera 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 ,oppure usando * per tenere conto di tutte le etichette.	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 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	Facoltativa. Immettere un'etichetta di destinazione per assegnare questa etichetta ai valori chiave esportati.	new

   Esempio: esportare i valori chiave e i flag di funzionalità con l'etichetta "prod" in un altro archivio Configurazione app e aggiungere l'etichetta di destinazione "new".

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

3. La riga di comando visualizza un elenco di valori chiave che vengono esportati nei file. Confermare l'esportazione selezionando y.

   

Sono stati esportati i valori chiave e i flag di funzionalità con l'etichetta "prod" da un archivio Configurazione app e sono stati assegnati l'etichetta "new".

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

Esportare i dati in Servizio app di Azure

Seguire questa procedura per esportare i valori chiave in Servizio app di Azure.

Nota

L'esportazione di flag di funzionalità in servizio app non è attualmente supportata.

Portale

Seguire questa procedura nel portale di Azure:

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

   

2. Nella scheda Esporta selezionare Servizi app in Servizio di destinazione.

3. Selezionare Seleziona risorsa, compilare il modulo con i parametri seguenti e selezionare Applica:

   Parametro	Descrizione	Esempio
   Subscription	La sottoscrizione corrente è selezionata per impostazione predefinita.	my-subscription
   Resource group	Selezionare un gruppo di risorse contenente il servizio app con la configurazione da esportare.	my-resource-group
   Risorsa	Selezionare il servizio app che contiene la configurazione da esportare.	my-app-service

4. La pagina visualizza ora il servizio di destinazione e l'ID risorsa selezionati. L'azione Seleziona risorsa consente di passare a un'altra risorsa servizio app di destinazione.

5. Facoltativamente, compilare la parte successiva del modulo:

   Parametro	Descrizione	Esempio
   Prefisso	Facoltativa. Questo prefisso verrà tagliato dalla proprietà "key" di ogni chiave 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. Il prefisso verrà ignorato per i flag di funzionalità.	Testapp:
   Esporta come riferimento	Facoltativa. Controllare di esportare i valori chiave in servizio app come riferimenti Configurazione app. Scopri di più
   In un momento specifico	Facoltativa. Compilare per esportare i valori chiave da un punto specifico nel tempo. Questo è il punto nel tempo dei valori chiave nell'archivio di configurazione selezionato. Formato: "AAAA-MM-GGThh:mm:ssZ". Questo campo viene impostato per impostazione predefinita sul punto corrente nel tempo dei valori chiave quando viene lasciato vuoto.	28/07/2022 12:00:00
   Da etichetta	Facoltativa. Selezionare un'etichetta esistente per limitare l'esportazione ai valori chiave con un'etichetta specifica. Se non si seleziona un'etichetta, verranno esportati solo i valori chiave con l'etichetta "Nessuna etichetta".	Prod

6. Selezionare Applica per procedere con l'esportazione.

Sono stati esportati i valori chiave con l'etichetta "prod" da una risorsa servizio app, con il relativo stato dal 28/07/2021 12:00:00 AM e il prefisso "TestApp". I valori chiave sono stati esportati con un tipo di contenuto in formato JSON.

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

Interfaccia della riga di comando 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 di esportazione e immettere i parametri seguenti:

   Parametro	Descrizione	Esempio
   --name	Immettere il nome dell'archivio Configurazione app contenente i valori chiave da esportare.	my-app-config-store
   --destination	Immettere appservice per indicare che si esportano dati in 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 del Configurazione app.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service o my-app-service
   --label	Facoltativa. 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	Descrizione	Esempio
   --prefix	Facoltativa. Prefisso da tagliare dalla proprietà "key" di un valore chiave esportato. 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 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 servizio app. Confermare l'esportazione selezionando y.

   

   Tutti i valori chiave sono stati esportati con l'etichetta "prod" in una risorsa Servizio app di Azure e il prefisso "TestApp:".

3. Facoltativamente, specificare un flag da esportare come riferimento Configurazione app.

   Parametro	Descrizione
   --export-as-reference -r	Facoltativa. Specificare se i valori chiave vengono esportati in servizio app come riferimenti Configurazione app. Altre informazioni

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

   

   Tutti i valori chiave sono stati esportati con l'etichetta "prod" come riferimenti alla configurazione dell'app in una risorsa Servizio app di Azure. Nella risorsa servizio app i valori chiave importati verranno indicati come riferimenti Configurazione app nella colonna "Source".

   

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

messaggi di errore

Durante l'importazione o l'esportazione di Configurazione app key-values è possibile che vengano visualizzati i messaggi di errore seguenti:

• Il file selezionato deve essere compreso tra 1 e 2097152 byte. Il file è troppo grande. Selezionare un file più piccolo.
• L'accesso pubblico è disabilitato per l'archivio o si accede da un endpoint privato che non si trova nelle configurazioni dell'endpoint privato dell'archivio. Per importare i valori chiave da un archivio Configurazione app, è necessario avere accesso a tale archivio. Se necessario, abilitare l'accesso pubblico per l'archivio di origine o accedervi da un endpoint privato approvato. Se è stato appena abilitato l'accesso pubblico, attendere fino a 5 minuti per l'aggiornamento della cache.

Passaggi successivi

Integrazione con una pipeline CI/CD