DocumentazioneAEM as a Cloud ServiceGuida utente

Variabili delle pipeline in Cloud Manager

Last update: Mon Oct 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:
  • Cloud Manager
  • Sviluppo

Creato per:

  • Amministratore
  • Sviluppatore

Il processo di build può basarsi su variabili di configurazione specifiche che non devono essere memorizzate nell’archivio Git. In alternativa, potrebbe essere necessario regolarli tra un’esecuzione della pipeline e l’altra sullo stesso ramo. Cloud Manager consente di gestire queste impostazioni come variabili della pipeline.

Informazioni sulle variabili della pipeline

Utilizzando Cloud Manager puoi configurare le variabili della pipeline in diversi modi.

  • Utilizzo dell’interfaccia utente di Cloud Manager
  • Utilizzo di Cloud Manager CLI
  • Utilizzo dell'API Cloud Manager

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.

Aggiungere una variabile di pipeline tramite Cloud Manager

Le variabili di pipeline possono essere configurate e gestite tramite l’interfaccia utente di Cloud Manager. Contribuiscono a semplificare la gestione delle pipeline, soprattutto quando sono necessarie configurazioni diverse nei diversi passaggi.

Per aggiungere, modificare ed eliminare variabili di pipeline è necessario disporre delle autorizzazioni necessarie per modificare la pipeline.

Se una pipeline è in esecuzione, la gestione delle variabili viene bloccata.

Per aggiungere una variabile di pipeline tramite Cloud Manager:

  1. Quando gestisci le pipeline, fai clic su Puntini di sospensione - Icona Altro della pipeline per la quale desideri creare le variabili della pipeline.

  2. Scegliere Visualizza/Modifica variabili dal menu a discesa.

    Visualizza/Modifica variabili pipeline

  3. Nella finestra di dialogo Configurazione variabili, immettere i dettagli nella prima riga della tabella.

    Campo
    Descrizione
    Nome

    Nome univoco della variabile di configurazione. Identifica la variabile specifica utilizzata nella pipeline. Deve rispettare le seguenti convenzioni di denominazione:

    • 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 valore della variabile di tipo secretString deve contenere un massimo di 500 caratteri.
    Valore
    Valore contenuto nella variabile.
    Passaggio applicato

    Obbligatorio. Passaggio della pipeline a cui si applica la variabile:

    • Build - La variabile viene applicata durante il processo di compilazione.
    • Test funzionali - La variabile viene utilizzata durante il passaggio del test funzionale.
    • Test interfaccia utente - La variabile viene utilizzata durante la fase di test dell'interfaccia utente.
    Tipo
    Seleziona questa opzione se la variabile è in testo normale o crittografata come segreto.

    Aggiungi variabile

  4. Fare clic su Aggiungi.

    Aggiungi ulteriori variabili in base alle esigenze.

  5. Fai clic su Salva.

Modificare una variabile di pipeline

  1. Quando gestisci le pipeline, fai clic su Puntini di sospensione - Icona Altro della pipeline per la quale desideri modificare le variabili della pipeline.

  2. Scegliere Visualizza/Modifica variabili dal menu a discesa.

    Visualizza/Modifica variabili pipeline

  3. Nella finestra di dialogo Configurazione variabili, fai clic su Puntini di sospensione - Icona altro della variabile da modificare.

  4. Nel menu a discesa, fare clic su Modifica.

    Modifica della variabile

  5. Aggiorna il valore della variabile come richiesto.

    È possibile modificare solo il valore della variabile.

  6. Effettua una delle operazioni seguenti:

    • Fai clic su Applica - icona segno di spunta per applicare la modifica.
    • Fai clic sull'icona Annulla per annullare la modifica.

  7. Fai clic su Salva.

Eliminare una variabile di pipeline

  1. Quando gestisci le pipeline, fai clic su Puntini di sospensione - Icona Altro della pipeline per la quale desideri eliminare le variabili della pipeline.

  2. Scegliere Visualizza/Modifica variabili dal menu a discesa.

    Visualizza/Modifica variabili pipeline

  3. Nella finestra di dialogo Configurazione variabili, fai clic su Puntini di sospensione - Icona altro della variabile da rimuovere, quindi fai clic su Elimina.

Impostare le variabili della pipeline utilizzando Cloud Manager CLI

Questo comando in CLI (Command Line Interface) imposta una variabile.

$ aio cloudmanager:set-pipeline-variables PIPELINEID --variable MY_CUSTOM_VARIABLE test

Comando per elencare le variabili.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

Quando viene utilizzato in un file Maven pom.xml, spesso è utile collegare queste variabili alle proprietà Maven utilizzando una sintassi simile a quella del seguente esempio:

        <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