Stratégie de déploiement des fonctions AEM Edge sur AEM as a Cloud Service
Sur AEM as a Cloud Service, une fonction AEM Edge se lie à un environnement. Chaque environnement configuré par votre programme, RDE, Dev, Stage et Prod, obtient sa propre instance de fonction AEM Edge. Planifiez votre promotion, vos secrets et vos tests autour de cette portée avant de les intégrer à votre processus de publication.
Définition de la portée des fonctions d’AEM Edge
Chaque environnement, RDE, développement, évaluation et production exécute sa propre instance de fonction AEM Edge. Toutes les instances sont déployées à partir du même référentiel de code (avec un fichier package.json), mais chaque instance conserve sa propre configuration, ses secrets et ses propres données KV.
Promouvoir le code dans vos environnements
Sur AEM as a Cloud Service, votre configuration de réseau CDN (edgeFunctions.yaml et cdn.yaml) réside dans le référentiel Projet de site AEM afin de regrouper toutes vos configurations CDN en un seul endroit. Cependant, votre code de fonction AEM Edge réside dans un référentiel de projet AEM Edge Functions distinct.
Effectuer une promotion vers l’environnement suivant implique de fusionner dans les deux référentiels, puis de déployer chacun d’eux. Les étapes détaillées sont les suivantes :
-
Fusionnez vos modifications de configuration (
edgeFunctions.yamletcdn.yaml) dans la branche Git projet du site AEM. -
Dans Cloud Manager, vérifiez que le pipeline de configuration utilise la branche fusionnée et cible l’environnement souhaité.
-
Exécutez le pipeline de configuration Cloud Manager pour déployer les fichiers
edgeFunctions.yamletcdn.yamldans l’environnement cible. -
Fusionnez vos modifications de code de fonction AEM Edge dans la branche Git projet Fonctions AEM Edge.
-
Vérifiez que le contexte de l’interface de ligne de commande (ou le système CI/CD) utilise la branche fusionnée et cible l’environnement souhaité à l’aide de la commande
aio aem edge-functions info. -
Exécutez
aio aem edge-functions deploy <name>(via l’interface de ligne de commande ou le système CI/CD) pour déployer le code de fonction sur l’environnement cible.
Gestion des secrets par environnement
Les secrets sont définis par environnement. Dans Cloud Manager, ajoutez-les dans l’onglet Configuration de l’environnement cible.
Les configurations non secrètes fonctionnent de la même manière, quel que soit l’environnement : vous les déclarez directement dans edgeFunctions.yaml, validé dans Git. Pour connaître les étapes exactes, voir Utiliser des configurations et des secrets.
Planification de votre SDLC en fonction de la portée de l’environnement
- Testez la logique de la fonction sur le RDE avant qu’il n’atteigne d’autres environnements.
- Conservez les secrets et les données KV spécifiques à un environnement pour qu’une promotion ne transfère jamais une configuration obsolète.
- Effectuez le suivi de la configuration et de la dérive secrète entre les environnements dans le cadre de votre liste de contrôle de version, et non comme une réflexion après coup.