Aggiungere una pipeline non di produzione configuring-non-production-pipelines
Dopo aver configurato un programma e creato almeno un ambiente nell’interfaccia utente di Cloud Manager, puoi aggiungere pipeline non di produzione. Queste pipeline consentono di verificare la 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.
Aggiungere una nuova pipeline non di produzione adding-non-production-pipeline
Dopo aver configurato un programma e creato almeno un ambiente nell’interfaccia utente di Cloud Manager, puoi aggiungere pipeline non di produzione. Utilizza queste pipeline per testare la qualità del codice prima di implementarle negli ambienti di produzione.
Per aggiungere una nuova pipeline non di produzione:
-
Accedi a Cloud Manager dall’indirizzo experience.adobe.com.
-
Nella sezione Accesso rapido, fai clic su Experience Manager.
-
Nel pannello laterale a sinistra, fai clic su Cloud Manager.
-
Selezionare un'organizzazione desiderata.
-
Nella console Programmi fare clic su un programma.
-
Nel pannello laterale sinistro, fai clic su Pipeline.
-
Nella pagina Pipeline, nell'angolo superiore destro, fare clic su Aggiungi pipeline > Aggiungi pipeline non di produzione.
-
Nella scheda Configurazione della finestra di dialogo Aggiungi pipeline non di produzione, seleziona una delle seguenti pipeline non di produzione da creare:
- Pipeline di qualità del codice: crea una pipeline che crea il codice su un ramo GIT, esegue unit test e valuta la qualità del codice senza distribuirlo in un ambiente.
- Pipeline di distribuzione: crea una pipeline che genera il codice, esegue unit test, valuta la qualità del codice e distribuisce in un ambiente non di produzione.
-
Nella sezione Configurazione pipeline, digita una descrizione per la pipeline non di produzione nel campo Nome pipeline non di produzione.
-
Nella sezione Opzioni di distribuzione selezionare uno dei trigger di distribuzione seguenti che si desidera utilizzare:
- Manuale: ti consente di avviare manualmente la pipeline.
- Cambiamenti su Git: avvia la pipeline ogni volta che vengono aggiunti dei commit al ramo Git configurato. Con questa opzione, puoi comunque avviare la pipeline manualmente in base alle esigenze.
-
Selezionare il comportamento relativo agli errori di metrica importanti che si desidera utilizzare.
- 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, emula un utente che rifiuta manualmente ogni errore.
- Continua immediatamente: se questa opzione è selezionata, la pipeline procede automaticamente ogni volta che si verifica un errore importante. In sostanza, emula un utente che approva manualmente ogni errore.
-
Fai clic su Continua.
-
I passaggi rimanenti utilizzati per completare la configurazione della pipeline non di produzione dipendono dal tipo di codice sorgente scelto.
Nella scheda Codice Source della finestra di dialogo Aggiungi pipeline non di produzione, seleziona il tipo di codice da elaborare con la pipeline non di produzione.Per ulteriori informazioni sui tipi di pipeline, consulta Pipeline CI/CD.
Utilizzo il 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 di AEM con la configurazione HTTPD/Dispatcher.
Per completare la configurazione della pipeline non di produzione del codice full stack, effettua le seguenti operazioni:
-
Nella sezione Codice Source, definisci le seguenti opzioni.
-
Ambienti di distribuzione idonei - Disponibile solo quando si modifica una pipeline non di produzione. Se la pipeline è di distribuzione, seleziona gli ambienti in cui eseguire la distribuzione.
-
Archivio: dall'elenco a discesa, scegliere l'archivio Git utilizzato dalla pipeline come origine. Cloud Manager crea il codice dall’archivio scelto qui.
note tip TIP Per scoprire come aggiungere e gestire archivi in Cloud Manager, consulta Aggiunta e gestione degli archivi. -
Ramo Git: dall'elenco a discesa, scegli il ramo nell'archivio selezionato da cui deve essere generata la pipeline. Il valore predefinito è
main. La pipeline utilizza il ramo scelto come origine per la generazione e la distribuzione. Se necessario, fare clic su Aggiorna per aggiornare l'elenco dei rami disponibili per l'archivio selezionato. Utilizza questa opzione se un ramo creato di recente non viene visualizzato nell’elenco. -
Strategia di compilazione
-
Build completa - Genera tutti i moduli nell'archivio ogni volta
-
BETA Smart Build - Genera solo moduli che sono stati modificati dopo l'ultimo commit.
Ulteriori informazioni sull'utilizzo di Smart Build in una pipeline non di produzione.note important IMPORTANT Smart Build è disponibile solo per le pipeline di qualità del codice e per le pipeline di distribuzione del codice full stack di sviluppo.
-
-
Casella di controllo Ignora configurazione a livello web: se selezionata, la pipeline non distribuisce la configurazione a livello web.
-
-
Nella sezione Pipeline, se la 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.
- Test funzionali del prodotto - Eseguire test funzionali del prodotto nell'ambiente di sviluppo.
- Test funzionali personalizzati - Eseguire test funzionali personalizzati nell'ambiente di sviluppo.
- Test dell'interfaccia utente personalizzati - Eseguire test dell'interfaccia utente personalizzati per le applicazioni personalizzate.
- Audit dell'esperienza - Esegui Audit dell'esperienza
-
Fai clic su Salva.
La pipeline è stata salvata ed è ora possibile [gestire le pipeline](managing-pipe
lines.md) nella scheda Pipeline della pagina Panoramica del programma.
Utilizzo un’implementazione 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:
-
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 una pipeline full stack è già implementata in un ambiente, puoi comunque creare una pipeline di configurazione a livello web per lo stesso ambiente. In questo caso, Cloud Manager ignora la configurazione a livello web nella pipeline full stack.
note note 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.
-
-
Nella sezione Codice Source, definisci le seguenti opzioni:
-
Archivio - Questa opzione definisce da quale archivio GIT la pipeline non di produzione 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.
-
-
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.
-
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.
Informazioni sull’utilizzo di Smart Build in una pipeline non di produzione about-smart-build
Smart Build in Cloud Manager è una strategia di compilazione ottimizzata per le pipeline non di produzione. Smart Build riduce i tempi di generazione memorizzando nella cache i moduli e ricostruendo solo quelli che sono stati modificati dopo l’ultima esecuzione riuscita. I moduli invariati vengono riutilizzati dalla cache, mentre vengono ricostruiti solo i moduli modificati e le relative dipendenze, migliorando l’efficienza dei flussi di lavoro di sviluppo iterativi.
Smart Build è attualmente disponibile solo per:
- pipeline di qualità del codice.
- Sviluppare pipeline di distribuzione full stack.
Si consiglia di utilizzare Smart Build nei seguenti casi:
- Stai sviluppando attivamente e apportando frequenti modifiche incrementali.
- Il progetto contiene più moduli Maven.
- Le build complete richiedono molto tempo.
Smart Build non è sempre ideale quando si dispone dei seguenti elementi:
- La build si basa principalmente su plug-in che eseguono operazioni al di fuori del grafico delle dipendenze di Maven.
- È necessaria la convalida completa della ricompilazione a ogni esecuzione.
Comprendere le prestazioni della build smart-build-performance
Il miglioramento delle prestazioni derivante dall’utilizzo di Smart Build dipende da diversi fattori, tra cui i seguenti:
- Il numero di moduli nel progetto.
- Frequenza e ambito delle modifiche al codice.
- La distribuzione delle dipendenze tra i moduli.
In generale, i progetti con molti moduli indipendenti possono vedere il miglioramento maggiore.
Rinuncia alla cache per modulo smart-build-cache-optout
Smart Build fornisce un controllo dettagliato che consente di disabilitare la memorizzazione nella cache per moduli specifici. Questa funzionalità è utile quando alcuni moduli:
- Utilizzare i plug-in, ad esempio
exec-maven-pluginomaven-antrun-plugin. - Eseguire operazioni sui file non tracciate dalle dipendenze Maven.
- Il contenuto nella cache produce risultati incoerenti.
Disattiva la memorizzazione in cache per un modulo smart-build-disable-caching
È possibile aggiungere la seguente proprietà al pom.xml del modulo interessato:
<properties>
<maven.build.cache.enabled>false</maven.build.cache.enabled>
</properties>
Questa sintassi forza la ricostruzione del modulo su ogni esecuzione della pipeline, mentre altri moduli continuano a beneficiare della memorizzazione in cache.
Limitazioni e considerazioni sull’utilizzo di Smart Build smart-build-limitations
Quando usi Smart Build, tieni presente quanto segue:
- Smart Build si basa sull’analisi delle dipendenze Maven.
- Le modifiche che non rientrano nel grafico delle dipendenze potrebbero non attivare le ricompilazioni.
- Alcuni plug-in potrebbero non essere completamente compatibili con il caching.
- Puoi tornare a Build completa in qualsiasi momento modificando la pipeline non di produzione.
Se si verifica un comportamento di compilazione imprevisto, è consigliabile disabilitare la memorizzazione nella cache per moduli specifici o cambiare temporaneamente la strategia di compilazione in Build completa.
Risoluzione dei problemi di Smart Build smart-build-troubleshoot
· Verificare il comportamento del plug-in, in particolare
exec/antrun.· Verificare se la maggior parte dei moduli cambia frequentemente.
· Utilizza Build completa per la verifica.
Consulta Aggiungere una pipeline non di produzione per abilitare Smart Build.
Escludi pacchetti Dispatcher exclude-dispatcher-packages
Se desideri che i pacchetti Dispatcher siano generati nella pipeline ma non caricati nell’archiviazione della build, disabilita la pubblicazione. In questo modo si può ridurre il tempo di esecuzione della pipeline.
Aggiungere la seguente configurazione al file del progetto pom.xml per disabilitare la pubblicazione dei pacchetti Dispatcher. Imposta una variabile di ambiente nel contenitore della build Cloud Manager per segnalare quando ignorare i pacchetti Dispatcher. La pipeline legge questo flag e li ignora di conseguenza.
<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>