Strategia di implementazione delle funzioni AEM Edge su AEM as a Cloud Service
In AEM as a Cloud Service, una funzione Edge di AEM si associa a un ambiente. Ogni ambiente in cui esegui il provisioning del programma, RDE, Dev, Stage e Prod, ottiene la propria istanza della funzione Edge di AEM. Pianifica la promozione, i segreti e i test in tale ambito prima di integrarlo nel processo di rilascio.
Definizione dell’ambito delle funzioni di AEM Edge
Ogni ambiente, RDE, Dev, Stage e Prod, esegue la propria istanza della funzione AEM Edge. Tutte le istanze vengono distribuite dallo stesso archivio del codice (con un file package.json), ma ogni istanza mantiene i propri dati di configurazione, segreti e KV.
Promuovi il codice attraverso gli ambienti
In AEM as a Cloud Service, la configurazione CDN (edgeFunctions.yaml e cdn.yaml) risiede nell’archivio del progetto del sito AEM per consolidare tutta la configurazione CDN in un’unica posizione. Tuttavia, il codice della funzione Edge di AEM si trova in un archivio separato AEM Edge Functions project.
Promuovere all’ambiente successivo significa unire in entrambi gli archivi, quindi distribuirli ciascuno. I passaggi di alto livello sono i seguenti:
-
Unisci le modifiche della configurazione (
edgeFunctions.yamlecdn.yaml) nel ramo Git del progetto del sito AEM. -
In Cloud Manager, verifica che la pipeline di configurazione utilizzi il ramo unito ed esegua il targeting dell’ambiente desiderato.
-
Eseguire la pipeline di configurazione di Cloud Manager per distribuire i file
edgeFunctions.yamlecdn.yamlnell’ambiente di destinazione. -
Unisci le modifiche al codice della funzione Edge di AEM nel ramo Git del progetto AEM Edge Functions.
-
Verificare che il contesto CLI (o il sistema CI/CD) utilizzi il ramo unito e utilizzi l’ambiente desiderato utilizzando il comando
aio aem edge-functions info. -
Eseguire
aio aem edge-functions deploy <name>(tramite il sistema CLI o CI/CD) per distribuire il codice della funzione nell’ambiente di destinazione.
Gestire i segreti per ambiente
I segreti sono impostati per ogni ambiente. In Cloud Manager, aggiungili nella scheda Configurazione dell’ambiente di destinazione.
Le configurazioni non segrete funzionano allo stesso modo indipendentemente dall’ambiente: vengono dichiarate direttamente in edgeFunctions.yaml e impegnate in Git. Per i passaggi esatti, vedere Utilizzare configurazioni e segreti.
Pianificare l’SDLC in base all’ambito dell’ambiente
- Verifica la logica della funzione su RDE prima che raggiunga altri ambienti.
- Mantieni i segreti specifici dell’ambiente e i dati KV isolati in modo che una promozione non porti mai a una configurazione non aggiornata.
- Tieni traccia della configurazione e della deriva segreta tra gli ambienti come parte dell’elenco di controllo per la versione, non come ulteriore considerazione.