Strategia di implementazione delle funzioni AEM Edge su Edge Delivery Services

IMPORTANT
AEM Edge Functions è attualmente in versione beta. Le funzioni e la documentazione potrebbero cambiare. Per ricevere commenti, contattare aemcs-edgecompute-feedback@adobe.com.

In Edge Delivery Services, una funzione Edge di AEM si associa a un sito e ogni sito viene mappato a un ramo Git. Un programma ottiene esattamente 3 istanze della funzione Edge di AEM, un budget fisso indipendentemente dal numero di rami dell’archivio. Pianifica la tua strategia di ramificazione in base a tale budget prima di incorporarla nel processo di rilascio.

Definizione dell’ambito delle funzioni di AEM Edge

Funzione AEM Edge associata a
Limite di distribuzione
programma Edge Delivery Services
3 per programma (ramo principale, staging e sviluppo, mappati ai siti di produzione, staging e sviluppo)

Ogni sito, produzione, gestione temporanea e sviluppo viene mappato su un ramo fisso (main, stage e dev rispettivamente) e ottiene la propria istanza della funzione AEM Edge.

Modello di distribuzione della funzione AEM Edge in Edge Delivery Services

Promuovi il codice tramite i siti

In Edge Delivery Services, la configurazione CDN (edgeFunctions.yaml e cdn.yaml) e il codice della funzione AEM Edge risiedono nello stesso archivio del progetto AEM Edge Functions. I passaggi di alto livello per la promozione del codice al sito successivo sono:

  1. Unisci la configurazione e il codice della funzione Edge di AEM viene modificato nel ramo mappato al sito di destinazione (ad esempio, dev in stage).

  2. In Cloud Manager, verifica che la pipeline di configurazione di Edge Delivery Services utilizzi il ramo unito.

  3. Eseguire la pipeline di configurazione di Edge Delivery per distribuire i file edgeFunctions.yaml e cdn.yaml.

  4. Verificare che il contesto CLI (o il sistema CI/CD) utilizzi il ramo unito e esegua il targeting del sito desiderato utilizzando il comando aio aem edge-functions info.

  5. Eseguire aio aem edge-functions deploy <name> (tramite il sistema CLI o CI/CD) per distribuire il codice funzione nel sito di destinazione.

Gestire i segreti tra siti diversi

Edge Delivery Services dispone di una pipeline di configurazione per programma, non una per sito. I siti Dev, Stage e Prod condividono tutti, pertanto non puoi aggiungere lo stesso nome variabile tre volte con tre valori diversi.

In Cloud Manager, apri la pipeline di configurazione Edge Delivery del programma e seleziona Visualizza/Modifica variabili. Aggiungi un segreto per sito, con prefisso in modo che i tre siti non si scontrino mai, ad esempio DEV_TRIPS_API_TOKEN, STAGE_TRIPS_API_TOKEN e MAIN_TRIPS_API_TOKEN. Per i passaggi esatti, vedere Utilizzare configurazioni e segreti.

Le configurazioni non segrete funzionano allo stesso modo indipendentemente dal sito: le dichiari direttamente in edgeFunctions.yaml, vincolate a Git. Per i passaggi esatti, vedere Utilizzare configurazioni e segreti.

Pianificare l’SDLC in base all’ambito del sito

  • Verifica la logica della funzione nel ramo dev prima dell’unione a stage o main.
  • Aggiungi il prefisso a ogni nome di segreto e variabile con il relativo sito (DEV_, STAGE_, MAIN_), poiché una pipeline di configurazione serve tutti e tre i siti.
  • Tieni traccia della configurazione e della deriva segreta tra i siti come parte dell’elenco di controllo per la versione, non come ulteriore considerazione.

Risorse aggiuntive

recommendation-more-help
experience-manager-learn-help-cloud-service