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.
Usa librerie variabili in Fabric per gestire le configurazioni attraverso le fasi della pipeline di rilascio 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 una libreria di variabili viene distribuita in uno stadio vuoto, il deployment crea uno spazio di lavoro dove il set di valori predefinito è attivo. Se l'ambiente di destinazione richiede un altro set di valori, apri la libreria variabile nello spazio di lavoro target, imposta il set di valori richiesto come attivo e salva la libreria di variabili prima di eseguire elementi dipendenti o azioni del piano di deployment.
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 seguenti operazioni alle variabili o ai set di valori in una fase di una pipeline di distribuzione fanno sì che la libreria di variabili risulti come Origine diversa del modulorispetto allo stesso elemento in un'altra fase:
- 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.
Usa i valori della libreria variabile in un piano di distribuzione
Un'azione di piano di distribuzione può utilizzare un riferimento a una libreria variabile invece di un valore letterale del parametro. Quando la distribuzione viene eseguita, Fabric risolve il riferimento utilizzando l'insieme di valori attivi della libreria variabile nello spazio di lavoro di destinazione. Questo permette alla stessa azione di utilizzare valori specifici per ogni fase di deployment.
Prima di distribuire, assicurati che lo spazio di lavoro di destinazione contenga la libreria e la variabile di riferimento Variable, e che il set di valori corretto sia attivo. La distribuzione non modifica l'insieme di valori attivo. Se il deployment crea lo spazio di lavoro di destinazione, Default è attivo finché non selezioni e salvi un altro set di valori.
Per un'azione di un piano di distribuzione, puoi usare un riferimento a una variabile come valore di un parametro. Per ulteriori informazioni, vedi Passa i parametri di un'azione.
Se Fabric non riesce a risolvere un riferimento, segnala quale parte del riferimento è fallita. Per la sequenza di risoluzione e le correzioni, vedi Fallimenti della risoluzione di riferimento variabile.
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.
I permessi degli elementi vengono controllati durante l'aggiornamento e il commit in Git.
La selezione attiva del set di valori è lo stato dello workspace e non viene memorizzata in Git. Quando la sincronizzazione iniziale importa una libreria di variabili in un nuovo workspace, Default è attivo. Se l'ambiente di destinazione richiede un altro set di valori, apri la libreria di variabili importata nel nuovo workspace, imposta il set di valori richiesto come attivo e salva la libreria di variabili prima di eseguire elementi dipendenti o azioni del piano di deployment.
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
Insiemi 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 ulteriori informazioni sul file set di valori, vedere set di valori e 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 variabili e 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 per le variabili
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.