Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
È possibile usare le librerie di variabili di Microsoft Fabric per gestire le configurazioni nelle varie fasi della pipeline di versione e per salvare i valori in Git. Questo articolo illustra come usare librerie di variabili nel contesto della gestione del ciclo di vita e dell'integrazione continua e del recapito continuo (CI/CD).
Librerie di variabili e pipeline di distribuzione
È possibile distribuire librerie di variabili e i relativi valori nelle pipeline di distribuzione per gestire i valori delle variabili in più fasi.
Tenere presente queste informazioni importanti:
Tutti i set di valori nella libreria di variabili sono disponibili per tutte le fasi della pipeline di distribuzione, ma solo un set è attivo in una fase.
Il valore attivo impostato per ogni fase viene selezionato in modo indipendente. È possibile modificarlo in qualsiasi momento.
Quando si distribuisce o si esegue il commit di una libreria di variabili, il set attivo della libreria ha il valore predefinito. È possibile modificare questo valore accedendo alla libreria di variabili appena creata nella fase di destinazione o nel repository e modificando il set attivo.
Anche se le distribuzioni non influiscono sul valore attivo selezionato impostato in ogni fase, è possibile aggiornare i valori stessi nella libreria di variabili. L'elemento consumatore nell'area di lavoro, ad esempio una pipeline, riceve automaticamente il valore corretto dall'insieme di valori attivi.
Le operazioni seguenti per variabili o set di valori in una fase di una pipeline di distribuzione fanno sì che la libreria di variabili venga riflessa come origine del modulo diversarispetto allo stesso elemento in una fase diversa:
- Aggiunta, eliminazione o modifica di variabili
- Aggiunta o eliminazione di set di valori
- Nomi delle variabili
- Ordine delle variabili
Una semplice modifica al set di valori attivi non viene registrata come origine del modulo diversa quando si confronta. Il set di valori attivi fa parte della configurazione dell'elemento, ma non è incluso nella definizione. Ecco perché non viene visualizzato nel confronto tra le pipeline di distribuzione e non viene sovrascritto in ogni distribuzione.
Librerie di variabili e integrazione di Git
Analogamente ad altri elementi di Fabric, le librerie di variabili possono essere integrate con Git per il controllo del codice sorgente. Gli elementi della libreria di variabili vengono archiviati come cartelle che è possibile gestire e sincronizzare tra Fabric e il provider Git.
Le autorizzazioni degli elementi vengono controllate durante l'aggiornamento e il commit git.
Lo schema per l'elemento della libreria di variabili è un oggetto JSON che contiene quattro parti:
- Cartella per i set di valori
- Impostazioni
- Platform.json, un file generato automaticamente
- Variabili
Set di valori
La cartella della libreria di variabili contiene una sottocartella denominata valueSets. Questa cartella contiene un file JSON per ogni set di valori. Questo file JSON contiene solo i valori delle variabili per i valori non predefiniti nel set di valori.
Per altre informazioni sul file del set di valori, vedere l'esempio di set di valori.
I valori per le variabili non presenti in questo file vengono ricavati dal set di valori predefinito.
Impostazioni
Il settings.json file contiene le impostazioni per la libreria di variabili.
Per altre informazioni, vedere l'esempio disettings.json.
Variabili
Il variables.json file contiene i nomi delle variabili e i relativi valori predefiniti.
Per altre informazioni, vedere l'esempio divariables.json.
Considerazioni e limitazioni
Limitazioni delle dimensioni
Possono essere presenti fino a 1.000 variabili e fino a 1.000 set di valori, purché siano soddisfatti entrambi i requisiti seguenti:
- Il numero totale di celle nei set di valori alternativi è minore di 10.000.
- Le dimensioni dell'elemento non superano 1 MB.
Questi requisiti vengono convalidati quando si salvano le modifiche.
Il campo della nota può contenere fino a 2.048 caratteri.
Il campo della descrizione del set di valori può contenere fino a 2.048 caratteri.
Limitazioni per i set di valori alternativi
- I set di valori alternativi in una libreria di variabili vengono visualizzati nell'ordine in cui sono stati aggiunti. Attualmente, non è possibile riordinarli nell'interfaccia utente. Per modificare l'ordine, modificare direttamente il file JSON.
- Il nome di ogni set di valori deve essere univoco all'interno di una libreria di variabili.
- I nomi delle variabili devono essere univoci all'interno di una libreria di variabili. Se si trovano in elementi diversi, è possibile avere due variabili con lo stesso nome in un'area di lavoro.
- Esiste sempre un valore attivo (e solo uno) impostato in una libreria di variabili alla volta. Non è possibile eliminare un valore impostato mentre è attivo. Per eliminarlo, configurare prima di tutto un altro valore impostato come attivo. È possibile impostare un valore attivo diverso per ogni fase di una pipeline di distribuzione.