Aggiungere una pipeline di produzione configuring-production-pipelines
Scopri come utilizzare Cloud Manager per creare e configurare pipeline di produzione per distribuire il codice. Per una panoramica delle nozioni di base sul funzionamento delle pipeline in Cloud Manager, vedi Pipeline CI/CD.
Panoramica overview
Utilizzando il riquadro Impostazioni della pipeline in Cloud Manager puoi 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 dall’archivio Git 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 di produzione. Per informazioni dettagliate su come configurare le pipeline non di produzione, consulta il documento Configurazione delle pipeline non di produzione.
Il ruolo di Responsabile della distribuzione è responsabile della configurazione della pipeline. La configurazione della pipeline è costituita da:
- Definizione dell’attivatore che avvia la pipeline.
- Definizione dei parametri che controllano la distribuzione di produzione.
- Configurazione dei parametri del test delle prestazioni.
Aggiungere una pipeline di produzione add-a-production-pipeline
Una volta utilizzata l’interfaccia utente di Cloud Manager per configurare il programma e disporre di almeno un ambiente, è possibile aggiungere una pipeline di produzione.
-
Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione e il programma appropriati.
-
Passa alla scheda Pipeline dalla pagina Panoramica del programma.
-
Fai clic su Aggiungi, quindi seleziona Aggiungi pipeline di produzione.
-
La finestra di dialogo Aggiungi pipeline di produzione si apre sulla scheda Configurazione in cui è necessario definire una serie di opzioni per la pipeline. Queste opzioni sono raggruppate in sezioni comprimibili e sono descritte nei passaggi seguenti.
-
Fornisci un nome descrittivo per la pipeline nel campo Nome pipeline.
-
Nella sezione Ambienti definisci cosa attiva una distribuzione e come deve essere implementata in base all’ambiente.
-
Nella sezione STAGING è possibile definire il modo in cui la pipeline viene eseguita nell’ambiente di staging.
-
Trigger di implementazione: per definire gli attivatori di distribuzione che avviano la pipeline, sono disponibili le seguenti opzioni.
- Manuale: per avviare la pipeline manualmente utilizzando l’interfaccia utente di Cloud Manager.
- Cambiamenti su Git: per avviare la pipeline CI/CD ogni volta che vengono aggiunti dei commit al ramo Git configurato. Con questa opzione, puoi comunque avviare la pipeline manualmente, in base alle esigenze.
-
Comportamento in caso di errori di metriche importanti: durante la configurazione o la modifica della pipeline, il Responsabile della distribuzione ha la possibilità di definire il comportamento della pipeline quando si verifica un errore importante in uno qualsiasi dei gate di qualità. Le opzioni disponibili sono:
- Chiedi ogni volta: impostazione predefinita che richiede l’intervento manuale per tutti gli errori importanti.
- Interrompi subito: la pipeline viene annullata ogni volta che si verifica un errore importante. Questa opzione simula il rifiuto manuale di ogni errore da parte dell’utente.
- Continua immediatamente: la pipeline procede automaticamente ogni volta che si verifica un errore importante. Quest’opzione simula l’approvazione manuale di ogni errore da parte dell’utente.
-
Opzioni di implementazione: è possibile accelerare alcune attività di distribuzione.
-
Approva implementazione post-staging: questa approvazione si verifica dopo la distribuzione nell’ambiente di staging prima di eseguire qualsiasi test. In caso contrario, l’approvazione si verifica prima dell’implementazione della produzione che viene eseguita al termine di tutti i test.
-
Salta modifiche a load balancer: non vengono apportate modifiche al load balancer.
-
-
Configurazione del Dispatcher: il ruolo di Responsabile della distribuzione può configurare un set di percorsi di contenuto che verranno invalidati o svuotati dalla cache del Dispatcher AEM quando viene eseguita una pipeline. Queste azioni della cache vengono eseguite come parte del passaggio della pipeline di distribuzione dopo la distribuzione di eventuali pacchetti di contenuto. Queste impostazioni utilizzano il comportamento standard del Dispatcher AEM. Per configurare, effettua le seguenti operazioni:
-
Nel PERCORSO fornisci un percorso di contenuto.
-
In TIPO, seleziona l’azione da intraprendere su quel percorso.
- Scaricamento: esegui un’eliminazione della cache.
- Invalida: esegui un’invalidazione della cache, simile a quando il contenuto viene attivato da un’istanza di authoring a un’istanza di pubblicazione.
-
Fai clic su Aggiungi percorso per aggiungere il percorso specificato. Puoi aggiungere fino a 100 percorsi per ambiente.
-
note tip TIP In generale, l’utilizzo dell’azione di invalidazione è preferibile, ma in alcuni casi può essere richiesta la cancellazione, soprattutto quando si utilizzano le librerie lato client HTML AEM. -
-
Nella sezione PRODUZIONE, puoi definire il modo in cui la pipeline viene eseguita nell’ambiente di produzione.
-
Opzioni di implementazione: puoi definire i parametri che controllano la distribuzione di produzione.
-
Utilizza l’approvazione Go Live: una distribuzione deve essere approvata manualmente da un utente con il ruolo Proprietario business, Project Manager o Responsabile della distribuzione tramite l’interfaccia utente di Cloud Manager.
-
Pianificata: opzione che interrompe la pipeline prima dell’implementazione della produzione per consentirne la pianificazione. Se questa opzione è selezionata, la pipeline si interrompe dopo la distribuzione nell’ambiente di staging e richiede all’utente di intraprendere un’azione.
Now: opzione che distribuisce immediatamente in produzione, completando in modo efficace la pipeline.- Data: opzione che consente all’utente di pianificare un periodo in cui la distribuzione deve essere completata.
- Interrompi esecuzione: opzione che interrompe la distribuzione in produzione.
note tip TIP Consulta la Distribuzione del codice per scoprire come impostare la pianificazione della distribuzione o eseguire immediatamente la pipeline. -
Utilizza CSE Oversight: se questa opzione è selezionata, viene attivato un CSE (Customer Success Engineer) per avviare la distribuzione effettiva. Se questa opzione è abilitata durante la creazione o la modifica di una pipeline, il ruolo Responsabile della distribuzione dispone delle seguenti opzioni.
- Qualsiasi CSE: questa opzione consente a qualsiasi CSE disponibile di avviare la distribuzione.
- Il mio CSE: questa opzione consente solo al CSE specifico assegnato al cliente di avviare la distribuzione. Questa opzione vale anche per il backup designato del CSE, se quello assegnato non è disponibile.
-
-
Configurazione Dispatcher: definisce la configurazione di Dispatcher per l’ambiente di produzione. Le opzioni sono le stesse dell’ambiente di staging.
-
-
-
-
Fai clic su Continua per passare alla scheda Codice Source in cui selezioni il tipo di codice da distribuire e configurare l’archivio di origine.
-
In Seleziona il codice da distribuire, scegli il tipo di distribuzione:
- Codice full stack - Codice per l’applicazione AEM completa.
- Configurazione a livello web - Proprietà di Dispatcher per archiviare, elaborare e distribuire pagine Web al client.
Per ulteriori informazioni su questi tipi di distribuzione, consulta Pipeline CI/CD. I passaggi rimanenti per completare la configurazione della pipeline dipendono dal tipo selezionato. Segui i collegamenti riportati qui sopra per passare alla sezione pertinente di questo documento.
-
-
Fai clic su Continua per passare alla scheda Test della fase, in cui puoi configurare il test di prestazione di AEM Sites e AEM Assets, a seconda dei prodotti per i quali disponi della licenza.
note tip TIP Consulta Test della qualità del codice per maggiori dettagli sulle opzioni disponibili nella scheda Test della fase. -
Nella sezione Consegna dei contenuti dei siti/Peso di carico distribuito puoi configurare il test delle prestazioni del sito in base alla ponderazione delle richieste di pagina tra tre set di pagine. Puoi abilitare o disabilitare i set di pagine in base alle esigenze.
- Pagine live popolari
- Altre pagine live
- Nuove pagine
-
Nella sezione Distribuzione dei test delle prestazioni delle risorse, puoi definire la distribuzione di test di immagini e PDF e le risorse di test.
-
Immagini: regola il cursore per adeguare la suddivisione del test tra immagini e PDF.
-
PDF: regola il cursore per adeguare la suddivisione del test tra immagini e PDF.
-
Definisci le risorse personalizzate caricandole.
- FORMATO - Scegli se la risorsa personalizzata è un PDF o un’immagine.
- NOME FILE: utilizza il pulsante di browser del file per selezionare un’immagine dal computer locale.
- Aggiungi file di test: fai clic per caricare la risorsa selezionata.
-
-
-
Fai clic su Salva per completare l’aggiunta della pipeline di produzione.
Codice full stack full-stack-code
Una pipeline del codice full stack distribuisce le build del codice back-end e front-end insieme alla configurazione HTTPD/Dispatcher.
Per configurare una pipeline di produzione del codice full stack:
-
Nella scheda Codice Source, definisci le opzioni seguenti.
- Archivio - Definisce da quale archivio Git la pipeline recupera il codice.
note tip TIP Consulta il documento Configurazione del programma per scoprire come aggiungere e gestire archivi in Cloud Manager. - Ramo Git: definisce da quale ramo la pipeline recupera il codice.
- Ignora configurazione a livello web: se questa opzione è selezionata, la pipeline non distribuisce la configurazione a livello web. Se per lo stesso ambiente esiste già una pipeline di configurazione a livello web, questa casella di controllo viene selezionata e disabilitata automaticamente perché tale pipeline gestisce la configurazione a livello web. Se non esiste alcuna pipeline di configurazione a livello web, puoi selezionare o deselezionare questa opzione per controllare se la pipeline full stack distribuisce la configurazione Dispatcher.
-
Fai clic su Continua per passare alla scheda Test dello staging. Per ulteriori dettagli, consulta Test dello staging.
Configurazione livello web web-tier-config
Una pipeline di configurazione a livello web distribuisce solo la configurazione HTTPD/Dispatcher. Per ulteriori dettagli su questo tipo di pipeline, consulta Pipeline CI/CD.
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 produzione di configurazione a livello web:
-
Nella scheda Codice Source, definisci le opzioni seguenti.
- Archivio - Dall’elenco a discesa, selezionare l’archivio Git contenente la configurazione a livello Web.
- Ramo Git - Selezionare il ramo nell’archivio scelto utilizzato da Cloud Manager per la distribuzione.
- Posizione codice - Immettere il percorso nell’archivio selezionato che contiene la configurazione a livello Web da distribuire. Il percorso predefinito è la directory principale dell’archivio (
/).
note NOTE Se Posizione codice non fa riferimento al percorso del codice del dispatcher, è possibile inserire codice aggiuntivo dell’applicazione nel pacchetto dell’artefatto e distribuirlo al dispatcher, causando un errore di Apache al riavvio e un errore della pipeline. Assicurati di impostare il percorso corretto per i file dispatcher nell’archivio.
-
Fai clic su Continua per passare alla scheda Test dello staging. Per ulteriori dettagli, consulta Test dello staging.
Utilizzare Smart Build in una pipeline di produzione about-smart-build
Smart Build in Cloud Manager è una strategia di compilazione ottimizzata per le pipeline 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 per:
- pipeline di qualità del codice.
- Pipeline di implementazione full stack per sviluppo, staging e produzione.
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.
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 non attivano le ricompilazioni.
- Alcuni plug-in non sono completamente compatibili con il caching.
- Puoi tornare a Build completa in qualsiasi momento modificando la pipeline 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.
Risolvere i 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.
Per abilitare Smart Build, vedere Aggiungere una pipeline di produzione.
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-one
Questo video fornisce una panoramica del processo di creazione della pipeline, descritto in questo documento.