Configurazione delle pipeline non 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.

Un utente deve disporre di Responsabile dell’implementazione per configurare le pipeline non di produzione.

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.

Aggiunta di 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.

Consulta Pipeline CI/CD per ulteriori informazioni sui tipi di pipeline.

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: Includi uno dei seguenti tipi di codice:

  • Config : configura le impostazioni per le regole del filtro del traffico nell’ambiente AEM.

    • Consulta il documento Regole del filtro del traffico, incluse le regole WAF per scoprire come gestire le regole del filtro del traffico nell’archivio in modo che vengano distribuite correttamente.
    • Durante l’esecuzione di una pipeline di distribuzione di destinazione, le configurazioni ad esempio configurazioni WAF verranno implementati, purché vengano salvati 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.

    • Consulta il documento Pipeline CI/CD per ulteriori dettagli.
    • 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 archivi privati. Consulta il documento Aggiunta di archivi privati in Cloud Manager per maggiori dettagli e per l’elenco completo delle limitazioni.

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 implementazione mirate

  1. Definisci il Ambienti di implementazione idonei.

    • Se la pipeline è di distribuzione, seleziona gli ambienti in cui eseguire la distribuzione.
  2. Sotto Codice sorgente, definisci le seguenti opzioni:

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

    Config pipeline

  3. Se hai abilitato Audit dell’esperienza, tocca o fai clic su Continua per passare al Audit dell’esperienza in cui è possibile definire i percorsi da includere sempre 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. Per salvare la pipeline, tocca o fai clic su Salva.

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

Ignorare i 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