[Beta]{class="badge positive"}
Utilizzare le distribuzioni canary per convalidare il codice canary-deployments
Per le implementazioni di AEM Cloud Service, le implementazioni canary in Cloud Manager consentono di convalidare il nuovo codice sul livello di pubblicazione dell’infrastruttura di produzione live prima di indirizzare ad esso il traffico utente reale. Distribuisci la nuova versione insieme alla versione stabile corrente e raggiungila tramite un’intestazione di richiesta dedicata. Dopo aver confermato che la nuova versione funziona correttamente, puoi promuoverla a tutto il traffico (questo avviene automaticamente dopo una finestra di 3 ore) o riportarla indietro.
Gli ambienti di sviluppo e staging rimangono i luoghi principali in cui testare le versioni del codice; le distribuzioni canary fungono da opportunità aggiuntiva per verificare che una versione funzioni come previsto. Ad esempio, è utile se la produzione di AEM si integra con l’endpoint di produzione di un servizio esterno, che non viene convalidato esplicitamente negli ambienti AEM inferiori.
Le distribuzioni Canary sono per la convalida interna, non per lo spostamento del traffico utente reale dalla vecchia versione a quella nuova; il traffico utente reale non viene mai indirizzato automaticamente alle istanze Canary.
Processo di distribuzione Canary how-canary-deployments-work
Quando esegui una pipeline full stack con distribuzioni canary abilitate, Cloud Manager avvia un set separato di istanze canary per la nuova build, mentre le istanze stabili continuano a servire gli utenti. Il processo segue questi passaggi:
- Puoi eseguire una pipeline di distribuzione full stack, stage o produzione, per la quale sono abilitate le distribuzioni canary.
Vedi Eseguire una pipeline e Abilitare le distribuzioni canary. - Durante il passaggio di distribuzione, Cloud Manager avvia le istanze canary che eseguono la nuova versione del codice.
- Le istanze stabili esistenti continuano a gestire il traffico in tempo reale.
- Puoi raggiungere la nuova versione in modo selettivo aggiungendo un’intestazione di richiesta canary. Vedere Accedere alla versione canary.
- Durante una finestra di convalida, promuovi la versione canary a tutto il traffico o annullane. Vedi Convalidare e promuovere o annullare.
Abilita distribuzioni canary enable-canary-deployments
Puoi abilitare le distribuzioni canary nella pipeline full stack. Le distribuzioni Canary sono supportate solo per gli ambienti stage e production. Una pipeline configurata per la distribuzione sia nell’ambiente di staging che in quello di produzione esegue la distribuzione canary solo nell’ambiente di produzione, come illustrato di seguito.
Comportamento distribuzione canary per tipo di pipeline
La posizione in cui viene eseguita la distribuzione canary dipende dal tipo di pipeline.
Per abilitare le distribuzioni canary:
-
In Cloud Manager, aggiungi una nuova pipeline o modifica una pipeline esistente che distribuisce il codice full stack in un ambiente di staging o produzione.
-
Nella finestra di dialogo Modifica pipeline di produzione, fai clic sulla scheda Codice Source.
-
Nella sezione Pipeline, sotto l’intestazione Opzioni di distribuzione di produzione, fare clic su Distribuzione canaria (beta).
-
Fai clic su Aggiorna per completare l’abilitazione della pipeline.
Durante la finestra di convalida, solo le richieste che includono l’intestazione Canary raggiungono la versione appena distribuita. Tutte le altre richieste continuano a raggiungere la versione stabile.
Accedere alla versione canary access-the-canary-release
Dopo che Cloud Manager ha avviato le istanze Canary, raggiungi la nuova versione aggiungendo un’intestazione HTTP alle richieste. La versione stabile continua a soddisfare le richieste senza l’intestazione.
Per inviare una richiesta alla versione canary, includi la seguente intestazione:
X-Aem-Canary: true
Convalida e promozione o annullamento validate-and-promote-or-cancel
Quando le istanze canary sono pronte, viene visualizzata una finestra di convalida che consente di testare la nuova versione. Cloud Manager mostra le opzioni Promuovi alla produzione e Annulla distribuzione nella sezione Distribuisci alla produzione.
Promuovi la versione Canary promote-the-canary-release
Per instradare tutto il traffico in tempo reale alla nuova versione, fai clic su Promuovi alla produzione. Quando promuovi la versione canary:
- La versione canary diventa la nuova versione stabile.
- Cloud Manager indirizza tutto il traffico live alla nuova versione.
- Rollback non più disponibile.
Annullare la distribuzione canary cancel-the-canary-deployment
Se si verificano problemi durante la finestra di convalida, fare clic su Annulla distribuzione. Quando si annulla la distribuzione canary:
- Cloud Manager interrompe la versione canary e rimuove le istanze canary.
- La versione stabile precedente continua a gestire il traffico.
- L’annullamento è disponibile solo durante la finestra di convalida.
Ambito di applicazione e limitazioni scope-and-limitations
Quando utilizzi le distribuzioni Canary, considera l’ambito e le limitazioni seguenti:
- Le distribuzioni Canary si applicano solo al livello di pubblicazione. Il livello di authoring rimane nella versione stabile durante la convalida canary.
- Le modifiche devono essere compatibili con le versioni precedenti in modo che le istanze di pubblicazione canarie possano gestire le strutture di contenuto esistenti.
- Le modifiche al contenuto variabile in una versione si applicano dopo la promozione della versione canary. Queste modifiche non sono disponibili nelle istanze canary durante la convalida.