Déployer et vérifier

Notre objectif est de créer un bloc Edge Delivery Services dynamique qui appelle une fonction AEM Edge pour récupérer des données dynamiques à partir d’une API tierce.

La quatrième et dernière étape consiste à déployer les deux projets sur votre site de développement et à confirmer que l’ensemble du flux fonctionne de bout en bout, pas seulement localement. Le bloc Edge Delivery Services et la fonction AEM Edge se trouvent dans deux référentiels distincts. Ils effectuent donc une promotion par le biais de deux relations publiques distinctes. Examinez d’abord la stratégie de déploiement de la fonction AEM Edge sur Edge Delivery Services. Il explique comment une fonction AEM Edge se lie à un site et à une branche, et comment les secrets sont délimités par site. Cette page est la séquence concrète des deux branches de ce tutoriel.

Augmenter et fusionner les deux RP

Les deux RP sont indépendants. L’ordre de fusion n’a pas d’importance pour la révision, mais la fonction AEM Edge doit être déployée avant que les appels du bloc Edge Delivery Services ne réussissent sur le site déployé, puisque le bloc appelle simplement un chemin d’accès et dépend de l’itinéraire du réseau CDN qui pointe déjà vers le code de travail.

Publier la page pour la publier

La publication en aperçu, de retour dans Code push et création du bloc, met le contenu créé à la disposition des aem up et de l’hôte de réseau CDN de prévisualisation. Le trafic en direct sur le domaine de votre site de développement nécessite que la même page soit publiée en direct. Dans AEM Sites, ouvrez la page et publiez en direct de la même manière que vous avez publié pour l’aperçu précédemment.

Ajouter des secrets au pipeline de configuration

Les appels en amont simulés lisent les CATALOG_API_TOKEN et les DELIVERY_API_TOKEN via SecretStoreManager.getSecret(), même si le tutoriel n’utilise pas encore les valeurs d’un appel réel. Déclarez les deux en tant que secrets dans config/edgeFunctions.yaml, en référençant les variables de pipeline Cloud Manager dotées d’un préfixe par site, comme suit ​ Utiliser des configurations et des secrets avec les fonctions Edge ​. Ajoutez les variables correspondantes dans Cloud Manager avant d’exécuter le pipeline à l’étape suivante.

Déployez la configuration du réseau CDN et la fonction AEM Edge

Une fois que la branche dev du projet Fonctions AEM Edge comporte les modifications fusionnées, déployez d’abord la configuration du réseau CDN, puis la fonction AEM Edge elle-même.

Exécuter le pipeline de configuration

Exécutez le pipeline de configuration d’Edge Delivery dans Cloud Manager, après la Vérification et déploiement de la configuration du réseau CDN (confirmez les étapes Code Source du pipeline au niveau de votre branche dev, et non main, afin d’extraire la configuration que vous venez de fusionner). Étant donné que cdn.yaml et edgeFunctions.yaml ont tous deux été modifiés, la nouvelle règle de sélecteur d’origine est poussée et les références secrètes que vous avez ajoutées à l’étape précédente sont résolues.

Créer et déployer la fonction AEM Edge

Une fois le pipeline réussi, créez et déployez la fonction elle-même, en suivant le projet Créer et déployer les fonctions AEM Edge :

$ cd myfrescopa-edge-functions
$ git checkout dev && git pull

# Confirm the CLI context targets the Dev site
$ aio aem edge-functions info

Vérifiez Site Domain correspond à votre site de développement, par exemple dev-myfrescopa.enablementadobe.com, avant de créer et de déployer.

$ aio aem edge-functions build
$ aio aem edge-functions deploy my-edge-function

Vérifier le point d’entrée

Confirmez que la fonction AEM Edge répond directement en premier :

$ curl "https://dev-myfrescopa.enablementadobe.com/api/frescopa/estimated-delivery?sku=house-blend-medium-roast&postcode=90210"

Ouvrez ensuite le site et exercez-vous sur le bloc Edge Delivery Services lui-même :

https://dev-myfrescopa.enablementadobe.com/dev/branches/estimated-delivery

Envoyez le formulaire et confirmez les rendus avec des données actives de la fonction AEM Edge déployée, et non la réponse locale affichée dans Connectez le bloc à la fonction AEM Edge.

Ouvrez l’onglet Réseau des outils de développement du navigateur et vérifiez que l’URL de la requête correspond au domaine de votre site et non au domaine de débogage brut de la fonction AEM Edge. Cela confirme que le sélecteur d’origine du réseau CDN achemine le chemin relatif même-origine, exactement comme ​ Sélectionnez l’URL appropriée pour l’environnement ​ décrit.

Si la requête échoue ici, mais qu’elle a fonctionné localement, vérifiez d’abord la règle du sélecteur d’origine du réseau CDN (chemin, originName et que le pipeline s’est réellement exécuté), puis la sortie de création et de déploiement de la fonction AEM Edge pour détecter les erreurs.

Promouvoir davantage

Pour déplacer cette fonctionnalité de dev vers stage et main, répétez la fusion, le déploiement et la vérification de la séquence pour chaque site, en suivant Promouvoir le code dans tous vos sites.

Résumé

Vous avez implémenté un gestionnaire de fonctions AEM Edge qui fusionne deux appels en amont, créé un bloc Edge Delivery Services qui l’appelle, connecté les deux avec la commutation d’URL basée sur l’environnement et CORS, et déployé les deux sur un site actif.

Ressources supplémentaires