DocumentazioneAEMGuida utente

Variabili delle pipeline in Cloud Manager configuring-pipeline-variables

Ultimo aggiornamento: 6 novembre 2025
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Admin
  • Developer

Il processo di build utilizza variabili di configurazione specifiche che non sono memorizzate nell’archivio Git. In alternativa, è necessario modificarli tra due esecuzioni della pipeline sullo stesso ramo. Cloud Manager consente di gestire queste impostazioni come variabili della pipeline.

Informazioni sulle variabili della pipeline pipeline-variables

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

Le variabili vengono memorizzate come testo normale o crittografate quando inattive. Le variabili sono disponibili all’interno dell’ambiente di build come variabile di ambiente, a cui è possibile fare riferimento dal file pom.xml o da altri script di build.

Aggiungere una variabile di pipeline tramite Cloud Manager ui

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

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.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    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.
    • Distribuzione - La variabile viene utilizzata durante il passaggio di distribuzione. Ad esempio, utilizza questa variabile per le pipeline di Edge Delivery Services.
    Tipo Seleziona questa opzione se la variabile è in testo normale o crittografata come segreto.

    Aggiungi variabile

  4. Fai clic su Aggiungi.

    Aggiungi ulteriori variabili in base alle esigenze.

  5. Fai clic su Salva.

Modificare una variabile di pipeline edit-ui

  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 seguenti operazioni:

    • 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 delete-ui

  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 cli

Questo comando CLI (Command Line Interface) configura le variabili.

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

Questo comando elenca 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
experience-manager-cloud-service-help-main-toc