DocumentationAEMTutoriels d’AEM as a Cloud Service

Stratégie de déploiement des fonctions AEM Edge sous Edge Delivery Services

Dernière mise à jour : 29 juillet 2026
  • S'applique à :
  • Experience Manager as a Cloud Service

Créé pour :

  • Intermediate
  • Developer
IMPORTANT
AEM Edge Functions est actuellement en version bêta. Les fonctionnalités et la documentation peuvent changer. Pour tout commentaire, contactez 🔗.

Sur Edge Delivery Services, une fonction AEM Edge se lie à un site et chaque site est mappé à une branche Git. Un programme obtient exactement 3 instances de fonction AEM Edge, un budget fixe, quel que soit le nombre de branches de votre référentiel. Planifiez votre stratégie d’embranchement autour de ce budget avant de l’intégrer dans votre processus de publication.

Définition de la portée des fonctions d’AEM Edge

Fonction AEM Edge liée à
Limite de déploiement
Programme Edge Delivery Services
3 par programme (branche principale, d’évaluation et de développement, mappée aux sites de production, d’évaluation et de développement)

Chaque site, de production, d’évaluation et de développement, est mappé à une branche fixe (main, stage et dev respectivement) et obtient sa propre instance de fonction AEM Edge.

Modèle de déploiement de fonction AEM Edge sous Edge Delivery Services

Promouvoir le code sur vos sites

Sur Edge Delivery Services, votre configuration de réseau CDN (edgeFunctions.yaml et cdn.yaml) et votre code de fonction AEM Edge résident dans le même référentiel de projet AEM Edge Functions. Les étapes générales de promotion du code sur le site suivant sont les suivantes :

  1. Fusionnez votre configuration et les modifications du code de fonction AEM Edge dans la branche mappée au site cible (par exemple, dev dans stage).

  2. Dans Cloud Manager, vérifiez que le pipeline de configuration Edge Delivery Services utilise la branche fusionnée.

  3. Exécutez le pipeline de configuration d’Edge Delivery pour déployer les fichiers edgeFunctions.yaml et cdn.yaml.

  4. 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 le site souhaité à l’aide de la commande aio aem edge-functions info.

  5. 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 le site cible.

Gestion des secrets des sites

Edge Delivery Services dispose d’un pipeline de configuration par programme, et non d’un par site. Les sites de développement, d’évaluation et de production le partagent tous. Vous ne pouvez donc pas ajouter le même nom de variable trois fois avec trois valeurs différentes.

Dans Cloud Manager, ouvrez le pipeline de configuration Edge Delivery du programme et sélectionnez Afficher/Modifier les variables. Ajoutez un secret par site, avec un préfixe afin que les trois sites ne soient jamais en conflit, par exemple DEV_TRIPS_API_TOKEN, STAGE_TRIPS_API_TOKEN et MAIN_TRIPS_API_TOKEN. Pour connaître les étapes exactes, voir Utiliser des configurations et des secrets.

Les configurations non secrètes fonctionnent de la même manière, quel que soit le site : 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 autour de la portée du site

  • Testez la logique de la fonction sur la branche dev avant de fusionner en stage ou main.
  • Ajoutez un préfixe à chaque nom de secret et de variable avec son site (DEV_, STAGE_, MAIN_), car un pipeline de configuration sert les trois sites.
  • Suivez la configuration et la dérive secrète entre les sites dans le cadre de votre liste de contrôle de version, et non comme une réflexion après coup.

Ressources supplémentaires

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