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, consulta 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 fino alla fase di 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:

  1. Definizione dell’attivatore che avvia la pipeline.
  2. Definizione dei parametri che controllano la distribuzione di produzione.
  3. Configurazione dei parametri del test delle prestazioni.
NOTE
Non è possibile configurare una pipeline finché il relativo archivio Git associato non dispone di almeno un ramo e la Configurazione del programma non è stata completata.

Aggiungere una nuova pipeline di produzione adding-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.

  1. Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione e il programma appropriati.

  2. Passa alla scheda Pipeline dalla pagina Panoramica del programma.

  3. Fai clic su Aggiungi, quindi seleziona Aggiungi pipeline di produzione.

    Aggiungi una pipeline di produzione

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

    1. Fornisci un nome descrittivo per la pipeline nel campo Nome pipeline.

    2. Nella sezione Codice sorgente, definisci dove la pipeline recupera il codice che elabora.

      • Archivio: definisce l’archivio Git dal quale la pipeline deve recuperare 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 della pipeline selezionata deve essere recuperato il codice.
      • Posizione codice: definisce il percorso nel ramo dell’archivio selezionato da cui la pipeline deve recuperare il codice.

      Definire larchivio per la pipeline

    3. Nella sezione Ambienti definisci cosa attiva una distribuzione e come deve essere implementata in base all’ambiente.

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

        Trigger di implementazione

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

        Opzioni di implementazione per staging

        • 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 di implementazione della pipeline, subito dopo la distribuzione di eventuali pacchetti di contenuto. Queste impostazioni utilizzano il comportamento standard del Dispatcher AEM. Per configurare, effettua le seguenti operazioni:

          1. Nel PERCORSO fornisci un percorso di contenuto.

          2. 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.
          3. Fai clic su Aggiungi percorso per aggiungere il percorso specificato. Puoi aggiungere fino a 100 percorsi per ambiente.

        Configurazione del Dispatcher

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

          Opzioni di implementazione di produzione

        • Configurazione Dispatcher: definisce la configurazione di Dispatcher per l’ambiente di produzione. Le opzioni sono le stesse dell’ambiente di staging.

  5. 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.
    1. 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

      Peso di caricamento dei siti

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

        1. FORMATO: scegli se la risorsa personalizzata è un PDF di un’immagine.
        2. NOME FILE: utilizza il pulsante di browser del file per selezionare un’immagine dal computer locale.
        3. Aggiungi file di test: fai clic per caricare la risorsa selezionata.

      Distribuzione dei test delle risorse

  6. Fai clic su Salva per completare l’aggiunta della 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.

recommendation-more-help
c6cdc82b-cee9-48e0-a6ee-48149d5e72c3