Impostazioni push in Configurazione app con Azure Pipelines

L'attività push Configurazione app di Azure esegue il push dei valori chiave da un file di configurazione nell'archivio Configurazione app. Questa attività consente la funzionalità completa del cerchio all'interno della pipeline in quanto è ora possibile eseguire il pull delle impostazioni dall'archivio Configurazione app e le impostazioni push nell'archivio Configurazione app.

Prerequisiti

• Sottoscrizione di Azure: creare un account gratuito
• Configurazione app store - crearne uno gratuitamente
• Progetto Azure DevOps - crearne uno gratuitamente
• Configurazione app di Azure attività Push: scaricare gratuitamente da Visual Studio Marketplace.
• Agente di Azure Pipelines versione 2.206.1 o successiva e Node versione 16 o successiva per l'esecuzione dell'attività negli 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 contenente la pipeline di destinazione. Nell'angolo inferiore sinistro selezionare Impostazioni progetto.

2. In Pipeline selezionare Connessioni al servizio. Nell'angolo in alto a destra selezionare Nuova connessione al servizio.

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

   

4. Nella finestra di dialogo Metodo di autenticazione selezionare Entità servizio (automatica) per creare una nuova entità servizio o selezionare Entità servizio (manuale) per usare un'entità servizio esistente.

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

Se è stata creata una nuova entità servizio, trovare il nome dell'entità servizio assegnata alla connessione al servizio. Si aggiungerà una nuova assegnazione di ruolo a questa entità servizio nel passaggio successivo.

1. Passare aConnessioni del servizioImpostazioni> progetto.

2. Selezionare la nuova connessione al servizio.

3. Selezionare Gestisci entità servizio.

4. Si noti il valore in Nome visualizzato.

   

Aggiungi un'assegnazione di ruolo

Assegnare le assegnazioni di ruolo Configurazione app appropriate alle credenziali usate all'interno dell'attività in modo che l'attività possa accedere all'archivio Configurazione app.

1. Passare all'archivio di Configurazione 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 Configurazione app Proprietario dati. Questo ruolo consente all'attività di leggere e scrivere nell'archivio Configurazione app.

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

   

6. Selezionare Verifica e assegna.

Usare nelle compilazioni

Questa sezione illustra come usare l'attività push Configurazione app di Azure in una pipeline di compilazione di Azure DevOps.

1. Passare alla pagina della pipeline di compilazione facendo clic su Pipelines Pipelines>. La documentazione per le pipeline di compilazione è disponibile qui.
   • Se si sta creando una nuova pipeline di compilazione, nell'ultimo passaggio del processo 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. Cercare l'attività push Configurazione app di Azure.

   

3. Configurare i parametri necessari per l'attività per eseguire il push dei valori chiave dal file di configurazione all'archivio Configurazione app. Le spiegazioni dei parametri sono disponibili nella sezione Parametri di seguito e nelle descrizioni comandi accanto a ogni parametro.

   

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

Usare nelle versioni

Questa sezione illustra come usare l'attività push Configurazione app di Azure in una pipeline di versione di Azure DevOps.

1. Passare alla pagina della pipeline di rilascio selezionando Versioni pipeline>. La documentazione per le pipeline di rilascio è disponibile qui.
2. Scegliere una pipeline di versione esistente. Se non ne hai uno, seleziona + Nuovo per crearne uno nuovo.
3. Selezionare il pulsante Modifica nell'angolo in alto a destra per modificare la pipeline di rilascio.
4. Nell'elenco a discesa Attività scegliere la fase a cui si vuole aggiungere l'attività. Altre informazioni sulle fasi sono disponibili qui.

   

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

   

6. Nella finestra di dialogo Aggiungi attività digitare Configurazione app di Azure Push nella casella di ricerca e selezionarla.
7. Configurare i parametri necessari all'interno dell'attività per eseguire il push dei valori chiave dal file di configurazione all'archivio Configurazione app. Le spiegazioni dei parametri sono disponibili nella sezione Parametri di seguito e nelle descrizioni comandi accanto a ogni parametro.
8. Salvare e accodare una versione. Il log di rilascio visualizzerà eventuali errori riscontrati durante l'esecuzione dell'attività.

Parametri

I parametri seguenti vengono usati dall'attività push Configurazione app:

• Sottoscrizione di Azure: elenco a discesa contenente le connessioni al servizio di Azure disponibili. Per aggiornare e aggiornare l'elenco delle connessioni di servizio di Azure disponibili, premere il pulsante Aggiorna sottoscrizione di Azure a destra della casella di testo.
• Configurazione app Endpoint: elenco a discesa che carica l'endpoint di configurazione disponibile archivia l'endpoint nella sottoscrizione selezionata. Per aggiornare e aggiornare l'elenco degli archivi di configurazione disponibili, premere il pulsante Aggiorna Configurazione app Endpoint a destra della casella di testo.
• Percorso file di configurazione: percorso del file di configurazione. Il parametro Percorso file di configurazione inizia alla radice del repository file. È possibile esplorare l'artefatto di compilazione per selezionare un file di configurazione. (... pulsante a destra della casella di testo). I formati di file supportati dipendono dal profilo del contenuto del file. Per il profilo predefinito i formati di file supportati sono yaml, json e proprietà. Per il profilo KvSet il formato di file supportato è json.
• Profilo contenuto file: profilo di contenuto del file di configurazione. Il valore predefinito è Default.
  • Impostazione predefinita: fa riferimento ai formati di file di configurazione convenzionali che sono direttamente consumabili dalle applicazioni.
  • Kvset: fa riferimento a uno schema di file che contiene tutte le proprietà di un Configurazione app chiave-valore, tra cui chiave, valore, etichetta, tipo di contenuto e tag. I parametri dell'attività 'Separator', 'Label', 'Content type', 'Prefix', 'Tags' e 'Depth' non sono applicabili quando si usa il profilo Kvset.
• Modalità di importazione: il valore predefinito è All. Determina il comportamento durante l'importazione di valori chiave.
  • Tutto: importa tutti i valori chiave nel file di configurazione in Configurazione app.
  • Ignore-Match: importa solo le impostazioni che non hanno valore chiave corrispondente in Configurazione app. I valori chiave corrispondenti vengono considerati chiave-valori con la stessa chiave, etichetta, valore, tipo di contenuto e tag.
• Run dry: il valore predefinito è Deselezionato.
  • Selezionata: non verranno eseguiti aggiornamenti per Configurazione app. Invece tutti gli aggiornamenti che sarebbero stati eseguiti in un'esecuzione normale verranno stampati nella console per la revisione.
  • Deselezionato: esegue eventuali aggiornamenti per Configurazione app e non viene stampato nella console.
• Separatore: separatore usato per appiattire i file json e .yml.
• Profondità: la profondità a cui verranno appiattiti i file con estensione json e .yml.
• Prefisso: stringa aggiunta all'inizio di ogni chiave inserita nell'archivio Configurazione app.
• Etichetta: stringa aggiunta a ogni valore chiave come etichetta all'interno dell'archivio Configurazione app.
• Tipo di contenuto: stringa aggiunta a ogni chiave-valore come tipo di contenuto all'interno dell'archivio Configurazione app.
• Tag: un oggetto JSON nel formato {"tag1":"val1", "tag2":"val2"}, che definisce i tag aggiunti a ogni valore della chiave di cui viene eseguito il push nell'archivio Configurazione app.
• Elimina i valori chiave non inclusi nel file di configurazione: il valore predefinito è Deselezionato. Il comportamento di questa opzione dipende dal profilo di contenuto del file di configurazione.
  • Selezionata:
    • Profilo di contenuto predefinito: rimuove tutti i valori chiave nell'archivio Configurazione app che corrispondono al prefisso e all'etichetta specificati prima di eseguire il push di nuovi valori chiave dal file di configurazione.
    • Profilo di contenuto Kvset: rimuove tutti i valori chiave nell'archivio Configurazione app che non sono inclusi nel file di configurazione prima di eseguire il push di nuovi valori chiave dal file di configurazione.
  • Deselezionato: inserisce tutti i valori chiave dal file di configurazione nell'archivio Configurazione app e lascia intatti tutti gli altri elementi nell'archivio Configurazione app.

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 è possibile caricare più file di configurazione?

Creare più istanze dell'attività push Configurazione app di Azure all'interno della stessa pipeline per eseguire il push di più file di configurazione nell'archivio Configurazione app.

Come è possibile creare Key Vault riferimenti o flag di funzionalità usando questa attività?

A seconda del profilo di contenuto del file selezionato, fare riferimento ad esempi nel supporto Configurazione app di Azure per il file di configurazione.

Perché viene visualizzato un errore 409 quando si tenta di eseguire il push dei valori chiave nell'archivio di configurazione?

Se l'attività tenta di rimuovere o sovrascrivere un valore chiave bloccato nell'archivio Configurazione app, si verificherà un messaggio di errore 409 Conflitto.