Documentazione AEM Documentazione di Cloud Manager per AEM 6.x

Distribuzione del codice

Ultimo aggiornamento: 11 settembre 2024

Argomenti:
Cloud Manager

Creato per:

Amministratore

Scopri come distribuire il codice e cosa accade in Cloud Manager quando lo fai.

Distribuire il codice con Cloud Manager

Una volta configurata la pipeline di produzione, inclusi l’archivio e gli ambienti necessari, puoi distribuire il codice.

Da Cloud Manager, fai clic su Distribuzione per avviare il processo di distribuzione.
Viene visualizzata la schermata Esecuzione della pipeline. Fai clic su Genera per avviare il processo.

Il processo di compilazione avvia il processo di distribuzione del codice, inclusi i seguenti passaggi:

Distribuzione dello staging
Test dello staging
Distribuzione in produzione

Puoi rivedere i passaggi da vari processi di distribuzione visualizzando i registri o rivedendo i risultati per i criteri di test.

Passaggi della distribuzione

In questa sezione sono descritte le diverse azioni che si verificano durante ogni passaggio della distribuzione. Consulta la sezione Dettagli del processo di distribuzione per informazioni tecniche su come il codice stesso viene distribuito dietro le quinte.

Passaggio della distribuzione dello staging

Il passaggio Distribuzione dello staging include le seguenti azioni:

Convalida: questo passaggio garantisce che la pipeline sia configurata per utilizzare le risorse disponibili al momento. Ad esempio, per verificare che il ramo configurato esista e che gli ambienti siano disponibili.
Test di compilazione e dell’unità: questo passaggio esegue un processo di compilazione containerizzato. Per dettagli, consulta Ambiente di creazione.
Scansione del codice: questo passaggio valuta la qualità del codice dell’applicazione. Per informazioni dettagliate sulla proceduta di test, consulta Informazioni sui risultati dei test.
Distribuzione allo staging

Distribuzione dello staging

Passaggio del test dello staging

Il passaggio del test dello staging include le azioni seguenti:

Test di sicurezza: questo passaggio valuta l’impatto sulla sicurezza del codice nell’ambiente AEM. Per informazioni dettagliate sulla procedura di test, consulta il documento Informazioni sui risultati dei test.
- Test delle prestazioni: questo passaggio valuta le prestazioni del codice. Per informazioni dettagliate sulla proceduta di test, consulta Informazioni sui risultati dei test.

Passaggio della distribuzione di produzione

Il passaggio della Distribuzione di produzione, include le azioni seguenti:

Domanda di approvazione
- Questa opzione è abilitata durante la configurazione della pipeline.
- Utilizzando questa opzione, puoi pianificare la distribuzione di produzione oppure fare clic su Ora per eseguirla immediatamente.
Pianificazione della distribuzione di produzione
- Questa opzione è abilitata durante la configurazione della pipeline.
- La data e l’ora pianificate vengono specificate in termini di fuso orario dell’utente.
Supporto CSE (se attivato)
Distribuzione alla produzione

Distribuzione di produzione

Una volta completata la distribuzione, il codice si trova nel relativo ambiente di destinazione e puoi visualizzare i registri.

Distribuzione completata

Interruzioni

I seguenti passaggi si interrompono se vengono lasciati in attesa del feedback degli utenti:

Passaggio

Timeout

Test di qualità del codice

7 giorni

Test di sicurezza

7 giorni

Test delle prestazioni

7 giorni

Domanda di approvazione (staging)

7 giorni

Domanda di approvazione (produzione)

14 giorni

Pianificazione della distribuzione nell’ambiente di produzione

14 giorni

Implementazione della produzione gestita

14 giorni

Dettagli del processo di distribuzione

Cloud Manager carica tutti i file target/*.zip prodotti dal processo di compilazione in un percorso di archiviazione. Questi artefatti vengono recuperati da questo percorso durante le fasi di distribuzione della pipeline.

Quando Cloud Manager viene implementato in topologie non di produzione, l’obiettivo è quello di completare la distribuzione il più rapidamente possibile e, pertanto, gli artefatti vengono distribuiti simultaneamente su tutti i nodi nel modo seguente:

Cloud Manager determina se ogni artefatto è un pacchetto AEM o dispatcher.
Cloud Manager rimuove tutti i dispatcher dal load balancer per isolare l’ambiente durante la distribuzione.
- Se non diversamente configurato, puoi ignorare le modifiche del load balancer nelle distribuzioni di sviluppo e staging. In altre parole, per l’ambiente di sviluppo, scollegare e allegare i passaggi in entrambe le pipeline non di produzione, mentre per l’ambiente di staging nella pipeline di produzione.
NOTE
È previsto che i clienti 1-1-1 utilizzeranno questa funzione.
Ciascun artefatto AEM viene distribuito in ogni istanza di AEM tramite le API della Gestione pacchetti, con le dipendenze dei pacchetti che determinano l’ordine di distribuzione.
- Per ulteriori informazioni su come utilizzare i pacchetti per installare nuove funzionalità, trasferire contenuti tra le istanze ed eseguire il backup del contenuto dell’archivio. Consulta Gestione pacchetti.
NOTE
Tutti gli artefatti AEM vengono distribuiti sia all’autore che agli editori. Le modalità di esecuzione devono essere utilizzate quando sono necessarie configurazioni specifiche per il nodo. Per ulteriori informazioni su come le modalità di esecuzione consentono di regolare l’istanza di AEM per uno scopo specifico, consulta la sezione Modalità di esecuzione del documento Distribuzione su AEM as a Cloud Service.
L’artefatto del dispatcher viene distribuito a ciascun dispatcher nel modo seguente:
1. Le configurazioni correnti vengono sottoposte a backup e copiate in un percorso temporaneo.
2. Tutte le configurazioni vengono eliminate tranne i file immutabili. Per ulteriori dettagli, consulta le Configurazioni del dispatcher. Questo approccio cancella le directory per garantire che non vengano lasciati indietro i file orfani.
3. L’artefatto viene estratto nella directory httpd. I file immutabili non vengono sovrascritti. Eventuali modifiche apportate ai file immutabili nell’archivio Git verranno ignorate al momento della distribuzione. Questi file sono fondamentali per il framework del dispatcher di AMS e non possono essere modificati.
4. Apache esegue un test di configurazione. Se non viene rilevato alcun errore, il servizio viene ricaricato. Se si verifica un errore, le configurazioni vengono ripristinate dal backup, il servizio viene ricaricato e l’errore viene segnalato a Cloud Manager.
5. Ogni percorso specificato nella configurazione della pipeline viene invalidato o svuotato dalla cache del dispatcher.
NOTE
Cloud Manager prevede che l’artefatto del dispatcher contenga l’intero set di file. Tutti i file di configurazione del Dispatcher devono essere presenti nell’archivio Git. I file o le cartelle mancanti causeranno un errore di distribuzione.
In seguito alla corretta distribuzione di tutti i pacchetti AEM e dispatcher a tutti i nodi, i dispatcher vengono aggiunti nuovamente al load balancer e la distribuzione è completa.

NOTE
È possibile ignorare le modifiche del load balancer nelle distribuzioni di sviluppo e staging. In altre parole, per l’ambiente di sviluppo, scollega e allega i passaggi sia nelle pipeline non di produzione che nell’ambiente di staging nella pipeline di produzione.

Fase dalla distribuzione alla produzione

Il processo di distribuzione nelle topologie di produzione è leggermente diverso per ridurre al minimo l’impatto sui visitatori del sito AEM.

Le distribuzioni di produzione seguono generalmente gli stessi passaggi indicati in precedenza, ma in modo continuativo:

Distribuisci pacchetti AEM per l’authoring.
Scollegare dispatcher1 dal load balancer.
Distribuisci pacchetti AEM a publish1 e il pacchetto dispatcher a dispatcher1 in parallelo, svuota la cache del dispatcher.
Ripristinare dispatcher1 nel load balancer.
Dopo aver ripristinato il servizio di dispatcher1, scollegare dispatcher2 dal load balancer.
Distribuisci pacchetti AEM a publish2 e il pacchetto dispatcher a dispatcher2 in parallelo, svuota la cache del dispatcher.
Ripristinare dispatcher2 nel load balancer.

Questo processo continua fino al completamento della distribuzione in tutti gli elementi Publish e Dispatcher nella topologia.

Esecuzione di una pipeline in modalità emergenza

In situazioni critiche, i clienti di Adobe Managed Services potrebbero dover implementare immediatamente modifiche al codice nei propri ambienti di staging e produzione. Questa funzionalità consente di ignorare l’intero ciclo di test di Cloud Manager.

Per risolvere queste situazioni, la pipeline di produzione di Cloud Manager può essere eseguita in modalità emergenza. Quando si utilizza questa modalità, i passaggi del test di sicurezza e prestazioni non vengono eseguiti. Tutti gli altri passaggi, compresi eventuali passaggi di approvazione configurati, vengono eseguiti come nella normale modalità di esecuzione della pipeline.

NOTE

La funzione di esecuzione di una pipeline in modalità emergenza viene attivata a livello di programma. L’attivazione viene eseguita dai Customer Success Engineer.

Utilizzo dell’esecuzione di una pipeline in modalità emergenza

Quando avvii un’esecuzione della pipeline di produzione, una finestra di dialogo ti consente di scegliere tra modalità normale o di emergenza. Questa opzione è disponibile se per il programma è attivata la funzione modalità di esecuzione di emergenza della pipeline. Questa opzione è disponibile dopo l’abilitazione della funzione.

Eseguire le opzioni della pipeline

Quando si visualizza la pagina dei dettagli di esecuzione della pipeline per un’esecuzione in modalità emergenza, le breadcrumb nella parte superiore dello schermo mostrano un indicatore dell’esecuzione della pipeline in modalità emergenza.

L’esecuzione di una pipeline in modalità emergenza può essere eseguita anche tramite l’API di Cloud Manager o CLI. Per avviare un'esecuzione in modalità emergenza, invia una richiesta PUT all’endpoint di esecuzione della pipeline con il parametro query ?pipelineExecutionMode=EMERGENCY oppure, se utilizzi CLI:

$ aio cloudmanager:pipeline:create-execution PIPELINE_ID --emergency

Eseguire nuovamente una distribuzione di produzione

In rari casi, i passaggi di distribuzione nell’ambiente di produzione possono non riuscire per motivi transitori. In questi casi, puoi rieseguire il passaggio di distribuzione di produzione fino a quando è stato completato, indipendentemente dal fatto che sia riuscito, annullato o non riuscito. La riesecuzione è supportata utilizzando la stessa pipeline costituita dai tre passaggi seguenti:

Passaggio di convalida: si tratta essenzialmente della stessa convalida che si verifica durante una normale esecuzione della pipeline.
Passaggio di compilazione: nel contesto di una riesecuzione, il passaggio di compilazione copia gli artefatti e non esegue effettivamente un nuovo processo di compilazione.
Passaggio di distribuzione della produzione: questo passaggio utilizza la stessa configurazione e le stesse opzioni della distribuzione di produzione in una normale esecuzione della pipeline.

In tali circostanze, in cui è possibile eseguire una riesecuzione, la pagina di stato della pipeline di produzione fornisce l’opzione Riesegui accanto a quella consueta di Scarica registro build.

Opzione Riesegui nella finestra di panoramica sulla pipeline

NOTE

In una riesecuzione, il passaggio di compilazione viene etichettato nell’interfaccia utente, per rispecchiare la copia degli artefatti non la ricompilazione.

Limitazioni

La riesecuzione del passaggio di distribuzione di produzione è disponibile solo per l’ultima esecuzione.
La riesecuzione non è disponibile per le esecuzioni di ripristino o le esecuzioni di “aggiornamenti push”.
Se l’ultima esecuzione non è riuscita in un qualsiasi punto precedente al passaggio di distribuzione nell’ambiente di produzione, non è possibile eseguirla nuovamente.

Riesecuzione dell’API

Oltre a essere disponibile nell’interfaccia utente, è possibile utilizzare l’API di Cloud Manager per attivare le riesecuzioni e identificare le esecuzioni attivate come riesecuzioni.

Attivare una riesecuzione

Per attivare una riesecuzione, è necessario effettuare una richiesta PUT al collegamento HAL http://ns.adobe.com/adobecloud/rel/pipeline/reExecute sullo stato del passaggio di distribuzione di produzione.

Se tale collegamento è presente, l’esecuzione può essere riavviata da quel passaggio.
Se è assente, l’esecuzione non può essere riavviata da quel passaggio.

Questo collegamento è sempre disponibile solo per il passaggio di distribuzione della produzione.

 {
  "_links": {
    "http://ns.adobe.com/adobecloud/rel/pipeline/logs": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/logs",
      "templated": false
    },
    "http://ns.adobe.com/adobecloud/rel/pipeline/reExecute": {
      "href": "/api/program/4/pipeline/1/execution?stepId=2983530",
      "templated": false
    },
    "http://ns.adobe.com/adobecloud/rel/pipeline/metrics": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/metrics",
      "templated": false
    },
    "self": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530",
      "templated": false
    }
  },
  "id": "6187842",
  "stepId": "2983530",
  "phaseId": "1575676",
  "action": "deploy",
  "environment": "weretail-global-b75-prod",
  "environmentType": "prod",
  "environmentId": "59254",
  "startedAt": "2022-01-20T14:47:41.247+0000",
  "finishedAt": "2022-01-20T15:06:19.885+0000",
  "updatedAt": "2022-01-20T15:06:20.803+0000",
  "details": {
  },
  "status": "FINISHED"

Il valore di sintassi del collegamento HAL href è solo un esempio, mentre il valore effettivo deve essere sempre letto dal collegamento HAL e non generato.

L’invio di una richiesta PUT a questo endpoint determina una risposta 201 in caso di esito positivo. Il corpo della risposta è la rappresentazione della nuova esecuzione. Questa funzionalità è simile all’avvio di un’esecuzione normale tramite l’API.

Identificare un’esecuzione rieseguita

Il sistema identifica le esecuzioni rieseguite in base al valore RE_EXECUTE nel campo trigger.

recommendation-more-help