Esportare le impostazioni da Configurazione app con Azure Pipelines

L'attività Export di Configurazione app di Azure esporta le coppie chiave-valore dal tuo archivio di Configurazione app di Azure e le imposta come variabili della pipeline Azure, che possono essere utilizzate dalle attività successive. Questa attività integra l'attività di importazione di Configurazione app di Azure, che importa le coppie chiave-valore da un file di configurazione nell'archivio di Configurazione app di Azure. Per altre informazioni, vedere Importare le impostazioni in Configurazione app con Azure Pipelines.

Prerequisiti

• Sottoscrizione di Azure: creare un account gratuito
• Archivio di configurazione delle app: creane uno gratuitamente
• Progetto Azure DevOps : crearne uno gratuitamente
• Versione 2.144.0 dell'agente di Azure Pipelines o successiva e Node versione 16 o successiva per eseguire l'attività su agenti self-hosted.

Creare una connessione al servizio

Una connessione al servizio consente di accedere alle risorse nella sottoscrizione di Azure dal progetto Azure DevOps.

1. In Azure DevOps passare al progetto che contiene la pipeline di destinazione. Nell'angolo in basso a sinistra selezionare Impostazioni progetto.

2. In Pipeline seleziona Connessioni al servizio. Nell'angolo superiore destro selezionare Nuova connessione al servizio.

3. In Nuova connessione al servizio selezionare Azure Resource Manager.

   

4. Nella finestra di dialogo Metodo di autenticazione selezionare Federazione dell'identità del carico di lavoro (automatica) per creare una nuova federazione dell'identità del carico di lavoro o selezionare Federazione dell'identità del carico di lavoro (manuale) per usare una federazione dell'identità del carico di lavoro esistente.

5. Immettere la sottoscrizione, il gruppo di risorse e un nome per la connessione al servizio.

Se hai creato un nuovo service principal, trova il nome del service principal assegnato alla connessione al servizio. Nel passaggio successivo verrà aggiunta una nuova assegnazione di ruolo a questa entità servizio.

1. Passare a Impostazioni progetto>Connessioni al servizio.

2. Selezionare la nuova connessione al servizio.

3. Selezionare Gestisci entità servizio.

4. Prendi nota del valore in Nome visualizzato.

   

Aggiungi assegnazione di ruolo

Assegnare alle credenziali usate dall'attività i ruoli appropriati di App Configuration, in modo che l'attività possa accedere all'archivio di App Configuration.

1. Andare all'archivio di configurazione dell'app di destinazione.

2. Nel menu a sinistra selezionare Controllo di accesso (IAM).

3. Nel riquadro destro selezionare Aggiungi assegnazioni di ruolo.

   

4. Per Ruolo, selezionare Lettore dati di configurazione dell'app. Questo ruolo consente all'attività di leggere dall'archivio di App Configuration.

5. Selezionare l'entità servizio associata alla connessione al servizio creata nella sezione precedente.

   

6. Seleziona Rivedi + assegna.

7. Se l'archivio contiene riferimenti di Key Vault, passare al Key Vault pertinente e assegnare il ruolo Key Vault Secret User al service principal creato nel passaggio precedente. Dal menu Key Vault selezionare Criteri di accesso e assicurarsi che il controllo degli accessi in base al ruolo di Azure sia selezionato come modello di autorizzazione.

Uso nelle compilazioni

Questa sezione illustra come usare l'attività di esportazione della configurazione app Azure in una pipeline di compilazione di Azure DevOps.

1. Passare alla pagina della pipeline di compilazione facendo clic su Pipeline>Pipeline. Per informazioni sulla pipeline di compilazione, vedi Crea la tua prima pipeline.
   • Se si crea una nuova pipeline di compilazione, nell'ultimo passaggio del processo, nella scheda Revisione selezionare Mostra assistente sul lato destro della pipeline.

   

   • Se si usa una pipeline di compilazione esistente, fare clic sul pulsante Modifica in alto a destra.

   

2. Cerca l'attività Esportazione di Configurazione app di Azure.

   

3. Per esportare i valori chiave dall'archivio Configurazione app, configurare i parametri necessari per l'attività. Le descrizioni dei parametri sono disponibili nella sezione Parametri e nelle descrizioni comando accanto a ogni parametro.
   • Impostare il parametro della sottoscrizione di Azure sul nome della connessione al servizio creata in un passaggio precedente.
   • Imposta l'endpoint di App Configuration sull'endpoint del tuo archivio App Configuration.
   • Lasciare i valori predefiniti per i parametri rimanenti.

     

4. Salvare e accodare una compilazione. Il log di compilazione visualizza eventuali errori che si sono verificati durante l'esecuzione dell'attività.

Utilizzo nelle versioni

Questa sezione illustra come usare l'attività di esportazione della configurazione app Azure in una pipeline di versione di Azure DevOps.

1. Passare alla pagina della pipeline di rilascio selezionando Pipeline>Rilasci. Per la documentazione sulle pipeline di rilascio, consulta Pipeline di rilascio.
2. Scegli una pipeline di rilascio esistente. Se non è disponibile, fare clic su Nuova pipeline per crearne una nuova.
3. Selezionare il pulsante Modifica nell'angolo superiore destro per modificare la pipeline di versione.
4. Nel menu a discesa Attività, scegli la Fase a cui vuoi aggiungere l'attività. Altre informazioni sulle fasi sono disponibili in Aggiungere fasi, dipendenze e condizioni.

   

5. Fare clic su + accanto al processo a cui si desidera aggiungere una nuova attività.

   

6. Cerca l'attività Esportazione di Configurazione app di Azure.

   

7. Per esportare i valori chiave dall'archivio Configurazione app, configurare i parametri necessari all'interno dell'attività. Le descrizioni dei parametri sono disponibili nella sezione Parametri e nelle descrizioni comando accanto a ogni parametro.
   • Impostare il parametro della sottoscrizione di Azure sul nome della connessione al servizio creata in un passaggio precedente.
   • Imposta App Configuration Endpoint sull'endpoint del tuo archivio App Configuration.
   • Lasciare i valori predefiniti per i parametri rimanenti.
8. Salvare e accodare una versione. Il registro di rilascio visualizza eventuali errori riscontrati durante l'esecuzione dell'attività.

Parametri

I parametri seguenti vengono usati dall'attività di esportazione della configurazione app Azure:

• Sottoscrizione di Azure: elenco a discesa contenente le connessioni al servizio di Azure disponibili. Per aggiornare e aggiornare l'elenco delle connessioni al servizio di Azure disponibili, premere il pulsante Aggiorna sottoscrizione di Azure a destra della casella di testo.
• Endpoint di Configurazione app: un elenco a discesa che visualizza gli endpoint degli archivi di configurazione disponibili nella sottoscrizione selezionata. Per aggiornare e ricaricare l'elenco degli endpoint disponibili degli archivi di configurazione, fare clic sul pulsante Aggiorna endpoint di App Configuration a destra della casella di testo.
• Modalità di selezione: specifica la modalità di selezione dei valori chiave letti da un archivio di configurazione. La modalità di selezione "Default" consente di utilizzare filtri per chiave ed etichetta. La modalità di selezione 'Snapshot' consente di selezionare i valori chiave da uno snapshot. Il valore predefinito è Default.
• Filtro chiave: il filtro può essere usato per selezionare le coppie chiave-valore da richiedere ad Configurazione app di Azure. Il valore * seleziona tutti i valori chiave. Per altre informazioni, vedere Eseguire query su chiavi-valori.
• Etichetta: specifica l'etichetta da usare quando si selezionano i valori chiave dall'archivio Configurazione app. Se non viene specificata alcuna etichetta, vengono recuperati i valori chiave senza etichetta. I caratteri seguenti non sono consentiti: , *.
• Nome snapshot: specifica lo snapshot da cui recuperare le coppie chiave-valore in Configurazione app di Azure.
• Rimuovi prefisso della chiave: specifica uno o più prefissi da rimuovere dalle chiavi di App Configuration prima di impostarle come variabili. Un carattere di nuova riga può essere usato per separare più prefissi.
• Elimina avviso per le chiavi sottoposte a override: il valore predefinito è deselezionato. Specifica se visualizzare avvisi quando vengono sostituite le chiavi esistenti. Abilitare questa opzione quando si prevede che i valori chiave scaricati da Configurazione app abbiano chiavi sovrapposte con ciò che esiste nelle variabili della pipeline.

Usare i valori chiave nelle attività successive

I valori chiave recuperati da Configurazione app vengono impostati come variabili della pipeline, accessibili come variabili di ambiente. La chiave della variabile di ambiente è la chiave del valore chiave recuperato da Configurazione app dopo aver tagliato il prefisso, se specificato.

Ad esempio, se un'attività successiva esegue uno script di PowerShell, potrebbe usare un valore chiave con la chiave "myBuildSetting" come segue:

echo "$env:myBuildSetting"

E il valore viene stampato nella console.

Risoluzione dei problemi

Se si verifica un errore imprevisto, è possibile abilitare i log di debug impostando la variabile system.debug della pipeline su true.

Domande frequenti

Come posso comporre la mia configurazione da più chiavi ed etichette?

In alcuni casi potrebbe essere necessario comporre la configurazione da più etichette, ad esempio l'impostazione predefinita e lo sviluppo. È possibile usare più attività Configurazione app in una pipeline per implementare questo scenario. I valori chiave recuperati da un'attività in un passaggio successivo sostituisce tutti i valori dei passaggi precedenti. Nell'esempio precedente è possibile usare un'attività per selezionare i valori chiave con l'etichetta predefinita, mentre una seconda attività può selezionare key-values con l'etichetta di sviluppo. Le chiavi con l'etichetta di sviluppo eseguono l'override delle stesse chiavi con l'etichetta predefinita.

Passaggio successivo

Per una panoramica completa dei parametri o per utilizzare questa attività della pipeline nelle pipeline YAML, fare riferimento al documento seguente.

Per informazioni su come importare i valori chiave da un file di configurazione nell'archivio Configurazione app, continuare con il documento seguente.

Per informazioni su come creare uno snapshot in un archivio di App Configuration, consultare il documento seguente.