Configuration de l’AEM d’exécution locale

Adobe Experience Manager (AEM) peut être exécuté localement à l’aide de l’AEM en tant que Jar de démarrage rapide du Cloud Service SDK. Cela permet aux développeurs de se déployer et de tester du code, des configurations et du contenu personnalisés avant de s'engager dans le contrôle de code source et de le déployer sur un AEM en tant qu'environnement Cloud Service.

Notez que ~ est utilisé comme abrégé pour le Répertoire d'utilisateur. Sous Windows, il s’agit de l’équivalent de %HOMEPATH%.

Installer Java

Le Experience Manager est une application Java et nécessite donc le SDK Java pour prendre en charge l’outil de développement.

  1. Téléchargement et installation de la dernière version du SDK Java 11
  2. Vérifiez que le SDK Java 11 est installé en exécutant la commande :
    • Windows : java -version
    • macOS / Linux : java --version

Java 

Téléchargement de l’AEM en tant que SDK Cloud Service

L’AEM en tant que Cloud Service SDK, ou AEM SDK, contient le Jar de démarrage rapide utilisé pour exécuter AEM Author et Publish localement pour le développement, ainsi que la version compatible des outils du répartiteur.

  1. Connectez-vous à https://experience.adobe.com/#/downloads avec votre Adobe ID.
    • Notez que votre organisation d’Adobe doit être configurée pour AEM en tant que Cloud Service pour télécharger l’AEM en tant que SDK Cloud Service.
  2. Accédez à l'AEM en tant que Cloud Service onglet
  3. Trier par Date de publication dans ordre Descendant
  4. Cliquez sur la dernière ligne de résultat AEM SDK
  5. Examinez et acceptez le CLUF et appuyez sur le bouton Télécharger.

Extrayez le fichier Jar de démarrage rapide du fichier compressé AEM SDK

  1. Décompresser le fichier aem-sdk-XXX.zip téléchargé

Configuration du service local AEM Author

Le service local d’auteur AEM offre aux développeurs une expérience locale que les spécialistes du marketing numérique et les auteurs de contenu partageront pour créer et gérer du contenu. Le service Auteur AEM est conçu à la fois comme un environnement de création et d’prévisualisation, ce qui permet d’effectuer la plupart des validations du développement de fonctionnalités par rapport à celui-ci, ce qui en fait un élément essentiel du processus de développement local.

  1. Créer le dossier ~/aem-sdk/author

  2. Copiez le fichier JAR de démarrage rapide dans ~/aem-sdk/author et renommez-le en aem-author-p4502.jar.

  3. Début du service d’auteur AEM local en exécutant les éléments suivants à partir de la ligne de commande :

    • java -jar aem-author-p4502.jar
      • Indiquez le mot de passe d’administrateur sous la forme admin. Tout mot de passe d’administrateur est acceptable, mais il est recommandé d’utiliser la valeur par défaut pour le développement local afin de réduire la nécessité de reconfigurer.

    Vous ne pouvez pas début l'AEM en tant que Jar de démarrage rapide Cloud Service en cliquant sur le doublon .

  4. Accédez au service d’auteur AEM local à l’adresse http://localhost:4502 dans un navigateur Web.

Windows :

$ mkdir -p c:\Users\<My User>\aem-sdk\author
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\author\aem-author-p4502.jar
$ cd c:\Users\<My User>\aem-sdk\author
$ java -jar aem-author-p4502.jar

macOS / Linux :

$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar

Configuration du service local de publication AEM

Le service de publication AEM local fournit aux développeurs l’expérience locale que les utilisateurs finaux de l’AEM auront, comme la navigation sur le site Web hébergé sur AEM. Un service de publication AEM local est important, car il s’intègre aux outils de répartiteur du SDK AEM et permet aux développeurs de tester la fumée et d’affiner l’expérience d’utilisateur final face à eux.

  1. Créer le dossier ~/aem-sdk/publish

  2. Copiez le fichier JAR de démarrage rapide dans ~/aem-sdk/publish et renommez-le en aem-publish-p4503.jar.

  3. Début du service de publication AEM local en exécutant les éléments suivants à partir de la ligne de commande :

    • java -jar aem-publish-p4503.jar
      • Indiquez le mot de passe d’administrateur sous la forme admin. Tout mot de passe d’administrateur est acceptable, mais il est recommandé d’utiliser la valeur par défaut pour le développement local afin de réduire la nécessité de reconfigurer.

    Vous ne pouvez pas début l'AEM en tant que Jar de démarrage rapide Cloud Service en cliquant sur le doublon .

  4. Accédez au service de publication AEM local à l’adresse http://localhost:4503 dans un navigateur Web.

Windows :

$ mkdir -p c:\Users\<My User>\aem-sdk\publish
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\publish\aem-publish-p4503.jar
$ cd c:\Users\<My User>\aem-sdk\publish
$ java -jar aem-publish-p4503.jar

macOS / Linux :

$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar

Simuler la distribution de contenu

Dans un véritable environnement Cloud Service, le contenu est distribué du service d’auteur au service de publication à l’aide de Sling Content Distribution et du canal d’Adobe. Le pipeline d'Adobe est un microservice isolé disponible uniquement dans l'environnement de nuage.

Au cours du développement, il peut être souhaitable de simuler la distribution du contenu à l’aide du service local Auteur et Publication. Pour ce faire, vous pouvez activer les agents de réplication hérités.

REMARQUE

Les agents de réplication ne peuvent être utilisés que dans le fichier JAR de démarrage rapide local et ne fournissent qu’une simulation de diffusion du contenu.

  1. Connectez-vous au service Auteur et accédez à http://localhost:4502/etc/replication/agents.author.html.

  2. Cliquez sur Agent par défaut (publication) pour ouvrir l'agent de réplication par défaut.

  3. Cliquez sur Modifier pour ouvrir la configuration de l'agent.

  4. Sous l'onglet Paramètres, mettez à jour les champs suivants :

    • Activé - cochez la valeur true
    • ID utilisateur de l'agent - Laissez ce champ vide

    Configuration de l'agent de réplication - Paramètres

  5. Sous l'onglet Transport, mettez à jour les champs suivants :

    • URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
    • User - admin
    • Mot de passe - admin

    Configuration de l'agent de réplication - Transport

  6. Cliquez sur Ok pour enregistrer la configuration et activer l'agent de réplication Par défaut.

  7. Vous pouvez maintenant apporter des modifications au contenu du service Auteur et les publier dans le service Publier.

Publier la page

Modes de démarrage rapide des débuts JAR

Le nom du Jar de démarrage rapide aem-<tier>_<environment>-p<port number>.jar indique comment il va se début. Une fois AEM démarré dans un niveau, un auteur ou une publication spécifique, il ne peut plus être remplacé par un autre niveau. Pour ce faire, le dossier crx-Quickstart généré lors de la première exécution doit être supprimé et le fichier Jar de démarrage rapide doit être réexécuté. L'Environnement et les ports peuvent être modifiés, mais ils nécessitent un arrêt/début de l'instance d'AEM locale.

La modification des environnements dev, stage et prod peut s'avérer utile pour les développeurs afin de s'assurer que les configurations spécifiques à un environnement sont correctement définies et résolues par AEM. Il est recommandé que le développement local soit principalement effectué par rapport au mode d’exécution par environnement dev par défaut.

Les permutations disponibles sont les suivantes :

  • aem-author-p4502.jar
    • En tant qu’auteur en mode d’exécution Dev sur le port 4502
  • aem-author_dev-p4502.jar
    • Auteur en mode d’exécution Dev sur le port 4502 (identique à aem-author-p4502.jar)
  • aem-author_stage-p4502.jar
    • En tant qu’auteur en mode d’exécution intermédiaire sur le port 4502
  • aem-author_prod-p4502.jar
    • En tant qu’auteur en mode d’exécution Production sur le port 4502
  • aem-publish-p4503.jar
    • En tant qu’auteur en mode d’exécution Dev sur le port 4503
  • aem-publish_dev-p4503.jar
    • Auteur en mode d’exécution Dev sur le port 4503 (identique à aem-publish-p4503.jar)
  • aem-publish_stage-p4503.jar
    • En tant qu’auteur en mode d’exécution intermédiaire sur le port 4503
  • aem-publish_prod-p4503.jar
    • En tant qu’auteur en mode d’exécution Production sur le port 4503

Notez que le numéro de port peut être n’importe quel port disponible sur l’ordinateur de développement local, mais par convention :

  • Le port 4502 est utilisé pour le service local AEM Author
  • Le port 4503 est utilisé pour le service local de publication AEM

La modification de ces paramètres peut nécessiter des ajustements aux configurations AEM SDK

Arrêt d’un AEM d’exécution local

Pour arrêter un environnement d’exécution AEM local, soit AEM Author, soit le service de publication, ouvrez la fenêtre de ligne de commande qui a été utilisée pour début de l’environnement d’exécution AEM, puis appuyez sur Ctrl-C. Attendez que AEM se ferme. Une fois le processus d'arrêt terminé, l'invite de ligne de commande est disponible.

Tâches d’exécution locale d’AEM en option configurées

  • Les variables d’environnement de configuration OSGi et les variables secrètes sont spécialement définies pour l’exécution locale AEM, plutôt que de les gérer à l’aide de l’interface de ligne de commande aio.

Quand mettre à jour le fichier JAR de démarrage rapide

Mettez à jour le SDK AEM au moins une fois par mois, ou peu après, le dernier jeudi de chaque mois, qui est la cadence de publication pour AEM en tant que "versions de fonctionnalités" Cloud Service.

AVERTISSEMENT

La mise à jour du fichier Jar de démarrage rapide vers une nouvelle version nécessite le remplacement de l’ensemble de l’environnement de développement local, ce qui entraîne la perte de tout le code, la configuration et le contenu dans les référentiels d’AEM locaux. Assurez-vous que tout code, configuration ou contenu qui ne doit pas être détruit est valorisé en toute sécurité dans Git ou exporté depuis l’instance AEM locale en tant que paquets AEM.

Comment éviter la perte de contenu lors de la mise à niveau du SDK AEM

La mise à niveau du SDK AEM crée effectivement un nouveau runtime AEM, y compris un nouveau référentiel, ce qui signifie que toute modification apportée à un référentiel de SDK précédent est perdue. Les stratégies suivantes sont viables pour aider à conserver le contenu entre les mises à niveau AEM SDK et peuvent être utilisées séparément ou de concert :

  1. Créez un package de contenu dédié à contenir un "exemple" de contenu pour faciliter le développement, et conservez-le dans Git. Tout contenu qui doit être conservé par le biais des mises à niveau AEM SDK sera conservé dans ce pack et redéployé après la mise à niveau du SDK AEM.
  2. Utilisez oak-upgrade avec la directive includepaths pour copier le contenu du référentiel SDK AEM précédent vers le nouveau référentiel SDK AEM.
  3. Sauvegardez tout contenu à l’aide AEM Package Manager et des packages de contenu sur le SDK AEM précédent, puis réinstallez-les sur le nouveau SDK AEM.

N’oubliez pas que l’utilisation des approches ci-dessus pour gérer le code entre les mises à niveau AEM SDK indique un modèle de développement anti-schéma. Le code non jetable doit provenir de votre IDE de développement et être acheminé vers AEM SDK via des déploiements.

Résolution des incidents

Un doublon-clic sur le fichier JAR de démarrage rapide génère une erreur

Lorsque vous cliquez sur le doublon Quickstart Jar to début, une erreur modale s’affiche pour empêcher AEM de démarrer localement.

Dépannage - Doublon-clic sur le fichier JAR de démarrage rapide

Cela est dû au fait que AEM en tant que Jar de démarrage rapide Cloud Service ne prend pas en charge les clics doublons du Jar de démarrage rapide pour début AEM localement. Au lieu de cela, vous devez exécuter le fichier JAR à partir de cette ligne de commande.

Pour début du service Auteur AEM, cd dans le répertoire contenant le fichier Jar de démarrage rapide et exécutez la commande :

$ java -jar aem-author-p4502.jar

ou, pour début au service AEM Publish, cd dans le répertoire contenant le fichier Jar de démarrage rapide et exécutez la commande :

$ java -jar aem-author-p4503.jar

Le démarrage du fichier JAR de démarrage rapide à partir de la ligne de commande annule immédiatement

Lors du démarrage du fichier Jar de démarrage rapide à partir de la ligne de commande, le processus s’interrompt immédiatement et le service AEM ne s’début pas, avec l’erreur suivante :

➜  ~/aem-sdk/author: java -jar aem-author-p4502.jar
Loading quickstart properties: default
Loading quickstart properties: instance
java.lang.Exception: Quickstart requires a Java Specification 11 VM, but your VM (Java HotSpot(TM) 64-Bit Server VM / Oracle Corporation) reports java.specification.version=1.8
  at com.adobe.granite.quickstart.base.impl.Main.checkEnvironment(Main.java:1046)
  at com.adobe.granite.quickstart.base.impl.Main.<init>(Main.java:646)
  at com.adobe.granite.quickstart.base.impl.Main.main(Main.java:981)
Quickstart: aborting

La raison en est que AEM en tant que Cloud Service requiert Java SDK 11 et que vous exécutez une autre version, probablement Java 8. Pour résoudre ce problème, téléchargez et installez Oracle Java SDK 11.
Une fois Java SDK 11 installé, vérifiez qu’il s’agit de la version principale en exécutant les éléments suivants à partir de la ligne de commande.

Une fois le SDK Java 11 installé, vérifiez qu’il s’agit de la version principale en exécutant la commande à partir de la ligne de commande :

  • Windows : java -version
  • macOS / Linux : java --version

Ressources supplémentaires

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free