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

  1. 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.

    Visualizzare/modificare le variabili della pipeline

  2. 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.

    Aggiungi variabile

  3. 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

  1. 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.

    Visualizzare/modificare le variabili della pipeline

  2. 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.

    Modifica della variabile

  3. 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.

    Modifica di una variabile

  4. 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>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab