Aggiungere una pipeline di produzione configuring-non-production-pipelines

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

Per configurare le pipeline non di produzione, l'utente deve avere il ruolo Responsabile dell'implementazione.

Pipeline non di produzione non-production-pipelines

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.
NOTE
È possibile modificare le impostazioni della pipeline dopo la configurazione iniziale.

Aggiungi una nuova pipeline non di produzione adding-non-production-pipeline

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

  2. Nella console I miei programmi, seleziona il programma.

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

  4. Dalla scheda Configurazione della finestra di dialogo Aggiungi pipeline non di produzione, seleziona il tipo di pipeline non di produzione che desideri aggiungere.

    • Pipeline di qualità del codice: crea una pipeline che genera il codice, esegue test di unità e valuta la qualità del codice, ma NON la distribuisce.
    • Pipeline di distribuzione: crea una pipeline che genera il codice, esegue test di unità, valuta la qualità del codice e distribuisce in un ambiente.

    Finestra di dialogo Aggiungi pipeline non di produzione

  5. 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.
      • Cambiamenti su Git: questa opzione avvia 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à.
  6. Se scegli di creare una pipeline di distribuzione, dovrai inoltre definire il Comportamento in caso di errori di metriche importanti.

    • Chiedi ogni volta: questo comportamento è l’impostazione predefinita che richiede l’intervento manuale per tutti gli errori importanti.
    • Interrompi subito: selezionando questa opzione, la pipeline viene annullata ogni volta che si verifica un errore importante. In sostanza, questa opzione simula il rifiuto manuale di ogni errore da parte dell’utente.
    • Continua immediatamente: se questa opzione è selezionata, la pipeline procede automaticamente ogni volta che si verifica un errore importante. In sostanza, quest’opzione simula l’approvazione manuale di ogni errore da parte dell’utente.
  7. Fai clic su Continua.

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

Per ulteriori informazioni sui tipi di pipeline, consulta Pipeline CI/CD.

I passaggi per completare la creazione della pipeline non di produzione variano a seconda del tipo di codice sorgente selezionato. Accedi ai collegamenti riportati qui sopra per passare alla sezione successiva del documento e completare la configurazione della pipeline.

Codice full stack full-stack-code

Una pipeline del codice full stack distribuisce simultaneamente le build del codice back-end e front-end contenenti una o più applicazioni server AEM con la configurazione HTTPD/Dispatcher.

NOTE
Se per l’ambiente selezionato esiste una pipeline del codice full stack, la selezione verrà 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: questa opzione definisce da quale archivio Git la pipeline deve recuperare il codice.
    note tip
    TIP
    Per scoprire come aggiungere e gestire archivi in Cloud Manager, consulta Aggiunta e gestione degli archivi.
    • Ramo Git: questa opzione definisce da quale ramo della pipeline selezionata deve essere recuperato il codice.

      • Immetti i primi caratteri del nome del ramo: la funzione di completamento automatico di questo campo. ti aiuta a trovare i rami corrispondenti che puoi selezionare.
    • Ignora configurazione a livello web: se questa opzione è selezionata, la pipeline non distribuisce la configurazione a livello web.

    • Pipeline: se si tratta di una pipeline è di distribuzione, puoi scegliere di eseguire una fase di test. Seleziona le opzioni che desideri abilitare in questa fase. Se non è selezionata alcuna opzione, la fase di test non viene visualizzata durante l’esecuzione della pipeline.

    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.

Distribuzione mirata targeted-deployment

Una distribuzione mirata distribuisce il codice solo per parti selezionate dell’applicazione AEM. In tale distribuzione è possibile scegliere di Includere uno dei seguenti tipi di codice:

  • Configurazione - Configura le impostazioni per varie funzionalità nell'ambiente AEM.

    • Consulta Utilizzo delle pipeline di configurazione per un elenco delle configurazioni supportate, che include l'inoltro del registro, le attività di manutenzione correlate all'eliminazione e varie configurazioni CDN, e per gestirle nel tuo archivio in modo che vengano distribuite correttamente.
    • Quando si esegue una pipeline di distribuzione di destinazione, le configurazioni vengono distribuite, purché vengano salvate nell’ambiente, nell’archivio e nel ramo definiti nella pipeline.
    • In qualsiasi momento può essere presente una sola pipeline di configurazione per ogni ambiente.
  • Codice front-end: configura JavaScript e CSS per il front-end dell'applicazione AEM.

    • Con le pipeline front-end, i team di sviluppo front-end acquisiscono maggiore indipendenza e il processo di sviluppo può essere accelerato.
    • Per informazioni sul funzionamento di questo processo e alcune considerazioni per sfruttare al massimo il suo potenziale, consulta il documento Sviluppo di Sites con la pipeline front-end.
  • Configurazione a livello web: configura le proprietà del dispatcher per archiviare, elaborare e consegnare le pagine web al client.

    • Per ulteriori dettagli, consulta il documento Pipeline CI/CD.
    • Se esiste una pipeline del codice a livello web per l’ambiente selezionato, questa selezione è disabilitata.
    • 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.
NOTE
Le pipeline a livello web e di configurazione non sono supportate con gli archivi privati. Per informazioni dettagliate e l'elenco completo delle limitazioni, vedere Aggiunta di archivi privati in Cloud Manager.

I passaggi per completare la creazione della pipeline di distribuzione non di produzione con targeting sono gli stessi quando scegli un tipo di distribuzione.

  1. Scegliere il tipo di distribuzione desiderato.

Opzioni di distribuzione di destinazione

  1. Definisci gli ambienti di distribuzione idonei.

    • Se la pipeline è di distribuzione, seleziona gli ambienti in cui eseguire la distribuzione.
  2. In Codice Source, definire le opzioni seguenti:

    • Archivio: questa opzione definisce da quale archivio Git la pipeline deve recuperare il codice.
    note tip
    TIP
    Per scoprire come aggiungere e gestire archivi in Cloud Manager, consulta Aggiunta e gestione degli archivi.
    • Ramo Git: questa opzione definisce da quale ramo della pipeline selezionata deve essere recuperato il codice.
      • Immetti i primi caratteri del nome del ramo: la funzione di completamento automatico di questo campo. trova i rami corrispondenti che puoi selezionare.
    • Posizione codice: definisce il percorso nel ramo dell’archivio selezionato dal quale la pipeline deve recuperare il codice.
    • Pipeline - Per le pipeline front-end non di produzione, è possibile abilitare Audit dell'esperienza.

    Pipeline di configurazione

  3. Se hai abilitato l'audit dell'esperienza, fai clic su Continua per passare alla scheda Audit dell'esperienza in cui puoi definire i percorsi che devono sempre essere inclusi nell'audit dell'esperienza.

    • Se hai abilitato Audit dell'esperienza, consulta il documento Audit dell'esperienza per informazioni dettagliate su come configurare.
    • In caso contrario, salta questo passaggio.
  4. Fai clic su Salva per salvare la pipeline.

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

Ignora pacchetti Dispatcher skip-dispatcher-packages

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