Configurazione delle variabili di pipeline configuring-pipeline-variables
Il processo di build può dipendere da specifiche variabili di configurazione che sarebbe inappropriato inserire nell’archivio Git o che potrebbero dover essere modificate tra le esecuzioni della pipeline che utilizzano lo stesso ramo. Cloud Manager consente di gestire questi dati come variabili della pipeline.
Variabili delle pipeline pipeline-variables
Cloud Manager consente di configurare le variabili della pipeline in diversi modi.
Le variabili possono essere archiviate come testo normale o crittografate quando inattive. In entrambi i casi, le variabili sono rese disponibili all’interno dell’ambiente di build come una variabile di ambiente a cui è possibile fare riferimento dal file pom.xml
o da altri script della build.
Convenzioni di denominazione delle variabili della pipeline naming-conventions
I nomi delle variabili devono rispettare le seguenti convenzioni.
- Le variabili possono contenere solo caratteri alfanumerici e il carattere di sottolineatura (
_
). - I nomi devono essere scritti in lettere maiuscole.
- È previsto un limite di 200 variabili per pipeline.
- Ogni nome non può contenere più di 100 caratteri.
- Ogni valore della variabile
string
deve avere una lunghezza inferiore a 2048 caratteri. - Ogni
secretString
il valore della variabile di tipo non può superare i 500 caratteri.
Tramite l’interfaccia utente di Cloud Manager ui
Le variabili di pipeline possono essere configurate e gestite tramite l’interfaccia utente di Cloud Manager. Per poter aggiungere, modificare ed eliminare le variabili della pipeline, è necessario disporre delle autorizzazioni necessarie per modificare la pipeline.
Se una pipeline è in esecuzione, la gestione delle variabili viene bloccata.
Aggiunta di variabili di pipeline add-ui
-
Quando gestione delle pipeline, tocca o fai clic sul pulsante con i puntini di sospensione della pipeline per la quale desideri creare le variabili della pipeline e seleziona Visualizza/modifica variabili dal menu di scelta rapida.
-
Il Configurazione variabili viene visualizzata la finestra. Inserisci i dettagli della variabile nella prima riga della tabella e tocca o fai clic su Aggiungi.
-
Nome configurazione è un identificatore univoco della variabile, che deve essere head convenzioni di denominazione delle variabili della pipeline.
-
Valore è il valore che la variabile contiene.
-
Passaggio applicato è il passaggio della pipeline a cui si applica la variabile. È obbligatorio.
- Genera
- Test funzionali
- Test interfaccia utente
-
Tipo definisce se la variabile è di testo normale o crittografata come segreto.
-
-
Il viene aggiunto alla tabella. Aggiungi altre variabili secondo necessità, quindi tocca o fai clic su Salva per salvare le variabili aggiunte alla pipeline.
Modifica delle variabili di pipeline edit-ui
-
Quando gestione delle pipeline, tocca o fai clic sul pulsante con i puntini di sospensione della pipeline per la quale desideri creare le variabili della pipeline e seleziona Visualizza/modifica variabili dal menu di scelta rapida.
-
Il Configurazione variabili viene visualizzata la finestra. Tocca o fai clic sul pulsante con i puntini di sospensione della variabile da modificare e seleziona Modifica.
-
Aggiorna il valore della variabile come richiesto e tocca o fai clic su Applica (il segno di spunta alla fine della riga) per applicare la modifica o Elimina (la freccia indietro) per annullare la modifica.
- È possibile modificare solo il valore della variabile.
-
Tocca o fai clic su Salva per salvare le modifiche apportate alle variabili nella pipeline.
Se desideri eliminare una variabile, seleziona Elimina invece di Modifica dal menu con i puntini di sospensione della variabile pipeline nel Configurazione variabili finestra.
Utilizzo di Cloud Manager CLI cli
Comando CLI per impostare una variabile.
$ aio cloudmanager:set-pipeline-variables PIPELINEID --variable MY_CUSTOM_VARIABLE test
Comando per elencare le variabili.
$ aio cloudmanager:list-pipeline-variables PIPELINEID
Per l’utilizzo in un file pom.xml
Maven, in genere è utile associare queste variabili alle proprietà Maven scrivendo una sintassi simile a quella proposta di seguito.
<profile>
<id>cmBuild</id>
<activation>
<property>
<name>env.CM_BUILD</name>
</property>
</activation>
<properties>
<my.custom.property>${env.MY_CUSTOM_VARIABLE}</my.custom.property>
</properties>
</profile>