Aggiungere una pipeline di produzione configure-production-pipeline
Scopri come configurare le pipeline di produzione per generare e distribuire il codice negli ambienti di produzione. Una pipeline di produzione distribuisce prima il codice nell’ambiente di staging. Dopo l’approvazione, distribuisce lo stesso codice nell’ambiente di produzione.
Per configurare le pipeline di produzione, l’utente deve avere il ruolo Responsabile dell’implementazione.
- Il programma viene creato.
- L’archivio Git dispone di almeno un ramo.
- Vengono creati gli ambienti di produzione e di staging.
Prima di iniziare la distribuzione del codice, configura le impostazioni della pipeline da Cloud Manager.
Aggiungere una nuova pipeline di produzione adding-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 di produzione seguendo la procedura riportata di seguito.
-
Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione appropriata.
-
Nella console I miei programmi, seleziona il programma.
-
Passa alla scheda Pipeline dalla pagina Panoramica del programma e fai clic su Aggiungi per selezionare Aggiungi pipeline di produzione.
-
Viene visualizzata la finestra di dialogo Aggiungi pipeline di produzione. Per identificare la pipeline, fornisci un nome della pipeline con le seguenti opzioni. Fai clic su Continua.
Trigger distribuzione: quando si definiscono i trigger della distribuzione per avviare la pipeline, le opzioni disponibili sono le seguenti.
- Manuale - Avvia la pipeline manualmente.
- Su modifiche Git - 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à.
Comportamento in caso di errori relativi a metriche importanti: durante la configurazione o la modifica della pipeline, l’utente con il ruolo Responsabile dell’implementazione può definire il comportamento della pipeline in caso di errore importante rilevato da un gate di qualità. Opzioni disponibili:
- Chiedi ogni volta - Impostazione predefinita. Richiede l'intervento manuale in caso di errori importanti.
- Interrompi subito: selezionando questa opzione, la pipeline viene annullata ogni volta che si verifica un errore importante. In sostanza, questo processo simula un utente che rifiuta manualmente ogni errore.
- Continua immediatamente - Se selezionata, la pipeline procede automaticamente ogni volta che si verifica un errore importante. In sostanza, questo processo simula un utente che approva manualmente ogni errore.
-
Nella scheda Codice Source, 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 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.
Configurare una pipeline del 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.
Per configurare una pipeline del codice full stack:
-
Nella scheda Codice Source, definisci le opzioni seguenti.
- Archivio: definisce l'archivio Git dal quale la pipeline deve recuperare il codice.
note tip TIP Consulta Aggiungere e gestire archivi per scoprire come aggiungere e gestire archivi in Cloud Manager. - Ramo Git - Definisce da quale ramo la pipeline selezionata deve recuperare il codice.
Inserisci i primi caratteri del nome del ramo e la funzione di completamento automatico di questo campo trova i rami corrispondenti per aiutarti a selezionare. - Ignora configurazione a livello web: se questa opzione è selezionata, la pipeline non distribuisce la configurazione a livello web.
- Sospendi prima della distribuzione nell'ambiente di produzione - Sospende la pipeline prima della distribuzione nell'ambiente di produzione.
- Pianificato - Consente all'utente di abilitare la distribuzione di produzione pianificata.
-
Per passare alla scheda Audit dell’esperienza e definire i percorsi da includere sempre nell’audit dell’esperienza, fai clic su Continua.
-
Fornisci percorsi da includere nell’audit dell’esperienza.
- Per ulteriori informazioni, vedere Test di verifica dell'esperienza.
-
Per salvare la pipeline, fai clic su Salva.
Durante l’esecuzione della pipeline, i percorsi configurati per l’audit dell’esperienza vengono inviati e valutati in base a prestazioni, accessibilità, SEO, best practice e test PWA. Per ulteriori dettagli, vedere Informazioni sui risultati dell'audit dell'esperienza.
Ora che hai salvato la pipeline, puoi gestire le pipeline dalla pagina Panoramica del programma nella scheda Pipeline.
Configurare una pipeline di distribuzione di destinazione targeted-deployment
Una distribuzione mirata distribuisce il codice solo per parti selezionate dell’applicazione AEM. In tale distribuzione, puoi 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, vengono distribuite le configurazioni, purché siano state 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à di Dispatcher per archiviare, elaborare e inviare 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 crei una pipeline di configurazione a livello web per un ambiente con una pipeline full stack esistente, la configurazione a livello web nella pipeline full stack viene ignorata. Questa modifica influisce solo sulla configurazione a livello web in tale ambiente.
Per configurare una pipeline di distribuzione di destinazione:
- Scegliere il tipo di distribuzione desiderato.
-
Definisci gli ambienti di distribuzione idonei.
- Se la pipeline è di distribuzione, seleziona gli ambienti in cui eseguire la distribuzione.
-
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.
- Sospendi prima della distribuzione in produzione: sospende la pipeline prima della distribuzione nell’ambiente di produzione.
- Pianificato - Consente all'utente di abilitare la distribuzione di produzione pianificata. Disponibile solo per le distribuzioni mirate a livello web.
-
Fai clic su Salva.
Ora che hai salvato la pipeline, puoi gestire le pipeline dalla pagina Panoramica del programma nella scheda Pipeline.
Ignora pacchetti Dispatcher skip-dispatcher-packages
Per creare pacchetti Dispatcher nella pipeline senza pubblicarli nell’archiviazione della build, puoi disabilitare l’opzione di pubblicazione. Questa operazione può contribuire a ridurre il tempo di esecuzione della pipeline.
Per disabilitare la pubblicazione dei pacchetti dispatcher, aggiungi la seguente configurazione tramite il file di progetto pom.xml. Una variabile di ambiente funge da flag impostato nel contenitore della build di Cloud Manager per determinare 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>