Aggiungere una pipeline non di produzione configuring-non-production-pipelines
Scopri come utilizzare Cloud Manager per creare e configurare pipeline non di produzione per distribuire il codice. Per una panoramica delle nozioni di base sul funzionamento delle pipeline in Cloud Manager, consulta Pipeline CI/CD.
Panoramica overview
Utilizzando il riquadro Pipeline in Cloud Manager, il Responsabile della distribuzione può creare due diversi tipi di pipeline.
- Pipeline di produzione: una pipeline di produzione è una pipeline appositamente creata composta da una serie di passaggi orchestrati per portare il codice sorgente fino alla produzione.
- Pipeline non di produzione: una pipeline non di produzione serve principalmente per eseguire scansioni di qualità del codice o per distribuire il codice sorgente in un ambiente di sviluppo.
Questo documento si concentra sulle pipeline non di produzione. Per informazioni dettagliate su come configurare le pipeline di produzione, consulta il documento Configurazione delle pipeline 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 e i passaggi di generazione e qualità del codice.
- Pipeline di implementazione: oltre a eseguire i passaggi di generazione e qualità del codice come le pipeline di qualità del codice, queste pipeline implementano il codice in un ambiente non di produzione.
Aggiungere una nuova pipeline non di produzione add-non-production-pipeline
Dopo aver configurato un programma e 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.
-
Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione e il programma appropriati.
-
Dalla schermata iniziale di Cloud Manager, apri la scheda Pipeline e fai clic su Aggiungi, quindi seleziona Aggiungi pipeline non di produzione.
-
Nella scheda Configurazione della finestra di dialogo Aggiungi pipeline non di produzione, seleziona il tipo di pipeline da creare in uno dei seguenti modi:
- Pipeline di qualità del codice: crea una pipeline che genera il codice, esegue unit test e valuta la qualità del codice senza distribuirla 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.
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| Sezione | Opzione | Descrizione |
| Configurazione pipeline | Nome pipeline non di produzione | Immetti una descrizione per la pipeline nel campo Nome pipeline non di produzione. |
| Test |
Visibile solo quando si modifica una pipeline non di produzione.
|
|
| Opzioni di distribuzione | Trigger distribuzione |
|
| Comportamento in caso di errori di metriche importanti |
|
|
| Approva dopo la distribuzione nell’ambiente di staging, casella di controllo | Visibile solo quando si modifica una pipeline non di produzione. Selezionare questa opzione per richiedere l’approvazione dopo la distribuzione nell’ambiente di staging prima che la pipeline possa continuare. Se questa opzione non è selezionata, la pipeline continua in base al comportamento configurato. |
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 | ||
|---|---|---|
| Sezione | Opzione | Descrizione |
| Configurazione pipeline | Nome pipeline non di produzione | Immetti una descrizione per la pipeline nel campo Nome pipeline non di produzione. |
| Ambiente di distribuzione idoneo | Se la pipeline è di distribuzione, seleziona gli ambienti in cui Cloud Manager distribuisce il codice. | |
| Test |
Visibile solo quando si modifica una pipeline non di produzione.
|
|
| Opzioni di distribuzione | Trigger distribuzione |
|
| Comportamento in caso di errori di metriche importanti |
|
|
| Approva dopo la distribuzione nell’ambiente di staging, casella di controllo | Visibile solo quando si modifica una pipeline non di produzione. Selezionare questa opzione per richiedere l’approvazione dopo la distribuzione nell’ambiente di staging prima che la pipeline possa continuare. Se questa opzione non è selezionata, la pipeline continua in base al comportamento configurato. |
|
| Ignora modifiche del load balancer, casella di controllo | Seleziona questa opzione per impedire che la pipeline apporti modifiche al load balancer durante la distribuzione. | |
| Configurazione Dispatcher |
Il ruolo Responsabile della distribuzione può configurare un set di percorsi di contenuto invalidati o svuotati dalla cache di AEM Dispatcher quando viene eseguita una pipeline. Cloud Manager esegue queste azioni cache come parte del passaggio della pipeline di distribuzione, subito dopo la distribuzione di eventuali pacchetti di contenuto. Queste impostazioni utilizzano il comportamento standard del Dispatcher AEM. Per configurare
|
|
| Pipeline | Casella di controllo Audit dell’esperienza | Seleziona questa opzione per includere un passaggio di audit dell’esperienza nella pipeline. Quando è abilitata, la pipeline include il passaggio Audit dell’esperienza dopo la scheda Codice Source. |
- Nell’angolo inferiore destro della finestra di dialogo Aggiungi pipeline non di produzione fare clic su Continua.
- Seleziona il tipo di codice che la pipeline è configurata per generare e distribuire.
Distribuisce l’applicazione AEM completa, compreso il codice dell’applicazione e, per impostazione predefinita, la configurazione a livello web.
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| Sezione | Opzione | Descrizione |
| Codice Source | Archivio | Dall’elenco a discesa, scegli l’archivio Git utilizzato dalla pipeline come origine. Cloud Manager crea il codice dall’archivio scelto qui. |
| Ramo Git | Dall’elenco a discesa, scegli il ramo nell’archivio selezionato da cui generare 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 |
|
|
| Casella di controllo Ignora configurazione livello Web | Seleziona questa opzione per saltare la distribuzione della configurazione a livello web in una pipeline di codice full stack. Lascia deselezionata l’opzione per distribuire la configurazione a livello web insieme al codice della pipeline. | |
| Pipeline | Casella di controllo Audit dell’esperienza | Seleziona questa opzione per includere un passaggio di audit dell’esperienza nella pipeline. Quando è abilitata, la pipeline include il passaggio Audit dell’esperienza dopo la scheda Codice Source. |
Distribuisce solo la configurazione a livello web, ad esempio le proprietà di Dispatcher utilizzate per archiviare, elaborare e distribuire pagine web al client. Quando si seleziona Configurazione livello Web, Cloud Manager crea una pipeline dedicata alla distribuzione della configurazione a livello Web.
Se esiste già una pipeline full stack, Cloud Manager visualizza un avviso che la creazione di una pipeline di configurazione a livello web fa sì che la pipeline full stack esistente ignori la configurazione a livello web. Dopo aver creato la pipeline di configurazione a livello web, Cloud Manager gestisce le distribuzioni di configurazione a livello web tramite tale pipeline anziché tramite la pipeline full stack.
| table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
|---|---|---|
| Sezione | Opzione | Descrizione |
| Codice Source | Archivio | Dall’elenco a discesa, seleziona l’archivio Git contenente la configurazione a livello web. |
| Ramo Git | Seleziona il ramo nell’archivio scelto utilizzato da Cloud Manager per 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. | |
| Posizione codice | Immetti il percorso nell’archivio selezionato contenente la configurazione a livello web da distribuire. Il percorso predefinito è la directory principale dell’archivio (/). |
- Fai clic su Salva.
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.
- Produrre risultati incoerenti quando memorizzato nella cache.
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 plug-in).· Verificare se la maggior parte dei moduli cambia frequentemente.
· Utilizzare Build completa per la verifica.
Consulta Aggiungere una pipeline non di produzione per abilitare Smart Build.
Passaggi successivi the-next-steps
Dopo aver configurato la pipeline, puoi distribuire il codice. Per ulteriori dettagli, consulta la sezione Distribuzione del codice.
Tutorial video video-tutorial
Questo video fornisce una panoramica del processo di creazione della pipeline, descritto in questo documento.