Configurazione delle pipeline non di produzione

Scopri come configurare le pipeline non di produzione per eseguire test sulla qualità del codice prima di distribuirle negli ambienti di produzione.

Pipeline non di produzione

Oltre alle pipeline di produzione, che distribuiscono negli ambienti di staging e di produzione, per convalidare il codice è possibile configurare anche delle pipeline non di produzione.

Esistono due tipi di pipeline non di produzione:

  • Pipeline di qualità del codice: eseguono controlli di qualità del codice in un ramo Git ed eseguono i passaggi di generazione e qualità del codice.
  • Pipeline di distribuzione: oltre a eseguire i passaggi di generazione e qualità del codice analogamente alle pipeline di qualità del codice, queste pipeline distribuiscono il codice in un ambiente non di produzione.
NOTA

È possibile modificare le impostazioni della pipeline dopo la configurazione iniziale.

Aggiunta di una nuova pipeline non di produzione

Dopo aver configurato il programma e disporre di almeno un ambiente che utilizza l’interfaccia utente di Cloud Manager, puoi aggiungere una pipeline non di produzione seguendo la procedura riportata di seguito.

  1. Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione e il programma appropriati.

  2. Accedi alla scheda Pipeline dalla pagina Home di Cloud Manager. Fai clic su +Aggiungi e seleziona Aggiungi pipeline non di produzione.

    Aggiungi pipeline non di produzione

  3. Dalla scheda Configurazione della finestra di dialogo Aggiungi pipeline non di produzione, seleziona il tipo di pipeline non di produzione che desideri aggiungere tra Pipeline di qualità del codice o Pipeline di distribuzione.

    Finestra di dialogo Aggiungi pipeline non di produzione

  4. Per identificare la pipeline, fornisci un nome della pipeline non di produzione con le seguenti informazioni aggiuntive.

    • Trigger distribuzione: quando si definiscono i trigger della distribuzione per avviare la pipeline, le opzioni disponibili sono le seguenti.

      • Manuale: per avviare la pipeline manualmente.
      • Alla modifica Git: per avviare la pipeline CI/CD ogni volta che vengono aggiunti dei commit al ramo Git configurato. Con questa opzione è comunque possibile avviare la pipeline manualmente secondo necessità.
  5. Fai clic su Continua.

  6. Dalla scheda Codice sorgente della finestra di dialogo Aggiungi pipeline non di produzione, seleziona il tipo di codice da elaborare con la pipeline.

I passaggi per completare la creazione della pipeline non di produzione variano a seconda dell’opzione Codice sorgente selezionata. Accedi ai collegamenti riportati qui sopra per passare alla sezione successiva del documento e completare la configurazione della pipeline.

Codice front-end

Una pipeline del codice front-end distribuisce le build del codice front-end contenenti una o più applicazioni dell’interfaccia utente lato client. Per ulteriori informazioni su questo tipo di pipeline, consulta il documento Pipeline CI/CD.

Per completare la configurazione della pipeline non di produzione del codice front-end, segui la procedura riportata di seguito.

  1. Nella scheda Codice sorgente è necessario definire le seguenti opzioni.

    • Ambienti di distribuzione idonei: se la pipeline è di distribuzione, seleziona gli ambienti in cui eseguire la distribuzione.
    • Archivio: definisce l’archivio Git dal quale la pipeline deve recuperare il codice.
    SUGGERIMENTO

    Per scoprire come aggiungere e gestire archivi in Cloud Manager, consulta il documento Aggiunta e gestione degli archivi.

    • Ramo Git: definisce il ramo della pipeline selezionata dal quale recuperare il codice.
      • Digitando i primi caratteri del nome del ramo, la funzione di completamento automatico del campo troverà i rami corrispondenti per supportare nella selezione.
    • Posizione codice: definisce il percorso nel ramo dell’archivio selezionato dal quale la pipeline deve recuperare il codice.

    Pipeline front-end

  2. Fai clic su Salva.

Ora che hai salvato la pipeline, puoi gestire le pipeline dalla pagina Panoramica del programma nella scheda Pipeline.

Codice full stack

Una pipeline del codice full stack distribuisce simultaneamente le build del codice back-end e front-end contenenti una o più applicazioni server di AEM con la configurazione HTTPD/Dispatcher. Per ulteriori informazioni su questo tipo di pipeline, consulta il documento Pipeline CI/CD.

NOTA

Se per l’ambiente selezionato esiste già una pipeline del codice full stack, la selezione viene disabilitata.

Per completare la configurazione della pipeline non di produzione del codice full stack, segui la procedura riportata di seguito.

  1. Nella scheda Codice sorgente è necessario definire le seguenti opzioni.

    • Ambienti di distribuzione idonei: se la pipeline è di distribuzione, seleziona gli ambienti in cui eseguire la distribuzione.
    • Archivio: definisce l’archivio Git dal quale la pipeline deve recuperare il codice.
    SUGGERIMENTO

    Per scoprire come aggiungere e gestire archivi in Cloud Manager, consulta il documento Aggiunta e gestione degli archivi.

    • Ramo Git: definisce il ramo della pipeline selezionata dal quale recuperare il codice.
      • Digitando i primi caratteri del nome del ramo, la funzione di completamento automatico del campo troverà i rami corrispondenti per supportare nella selezione.
    • Ignora configurazione a livello web: se l’opzione è selezionata, la pipeline non distribuisce la configurazione a livello web.

    Pipeline full stack

  2. Fai clic su Salva.

Ora che hai salvato la pipeline, puoi gestire le pipeline dalla pagina Panoramica del programma nella scheda Pipeline.

Configurazione a livello web

Una pipeline di configurazione a livello web distribuisce configurazioni HTTPD/Dispatcher. Per ulteriori informazioni su questo tipo di pipeline, consulta il documento Pipeline CI/CD.

NOTA

Se per l’ambiente selezionato esiste già una pipeline del codice a livello web, la selezione viene disabilitata.

Per completare la configurazione della pipeline non di produzione del codice a livello web, segui la procedura riportata di seguito.

  1. Nella scheda Codice sorgente è necessario definire le seguenti opzioni.

    • Ambienti di distribuzione idonei: se la pipeline è di distribuzione, seleziona gli ambienti in cui eseguire la distribuzione.
    • Archivio: definisce l’archivio Git dal quale la pipeline deve recuperare il codice.
    SUGGERIMENTO

    Per scoprire come aggiungere e gestire archivi in Cloud Manager, consulta il documento Aggiunta e gestione degli archivi.

    • Ramo Git: definisce il ramo della pipeline selezionata dal quale recuperare il codice.
    • Posizione codice: definisce il percorso nel ramo dell’archivio selezionato dal quale la pipeline deve recuperare il codice.
      • Per le pipeline di configurazione a livello web, in genere si tratta del percorso contenente le directory conf.d, conf.dispatcher.d e opt-in.
      • Ad esempio, se la struttura del progetto è stata generata dall’archetipo del progetto AEM, il percorso è /dispatcher/src.

    Pipeline a livello web

  2. Fai clic su Salva.

NOTA

Se già disponi di una pipeline full stack distribuita in un ambiente, creando una pipeline di configurazione a livello web per lo stesso ambiente la configurazione del livello web esistente nella pipeline full stack verrà ignorata.

Ora che hai salvato la pipeline, puoi gestire le pipeline dalla pagina Panoramica del programma nella scheda Pipeline.

Ignorare i pacchetti Dispatcher

Se desideri che i pacchetti dispatcher vengano generati come parte della pipeline, ma non che vengano pubblicati nell’archivio della build, puoi disabilitare la pubblicazione riducendo in tal modo la durata dell’esecuzione della pipeline.

Per disabilitare la pubblicazione dei pacchetti dispatcher, aggiungi la seguente configurazione tramite il file di progetto pom.xml. Si basa su una variabile di ambiente che funge da flag impostabile nel contenitore della build di Cloud Manager per definire quando ignorare i pacchetti dispatcher.

<profile>
  <id>only-include-dispatcher-when-it-isnt-ignored</id>
  <activation>
    <property>
      <name>env.IGNORE_DISPATCHER_PACKAGES</name>
      <value>!true</value>
    </property>
  </activation>
  <modules>
    <module>dispatcher</module>
  </modules>
</profile>

In questa pagina