Il est possible d'exécuter localement Adobe Experience Manager (AEM) à l'aide du SDK d'AEM as a Cloud Service Quickstart Jar. Cela permet aux développeurs de déployer et de tester du code personnalisé, des configurations et du contenu avant de le soumettre à un contrôle de sources et de le déployer dans un environnement AEM as a Cloud Service.
Notez que ~
est utilisé comme abrégé pour le répertoire de l’utilisateur. Sous Windows, cela équivaut à %HOMEPATH%
.
Experience Manager est une application Java qui requiert donc le SDK Java d’Oracle pour prendre en charge l’outil de développement.
$ java --version
$ java -version
$ java --version
Le SDK as a Cloud Service AEM, ou SDK AEM, contient le fichier Quickstart Jar utilisé pour exécuter l’instance de création et de publication d’Adobe en local pour le développement, ainsi que la version compatible des outils de Dispatcher.
aem-sdk-XXX.zip
fichierLe service de création d’AEM local fournit aux développeurs une expérience locale que les spécialistes du marketing numérique/auteurs de contenu vont partager pour créer et gérer du contenu. Le service de création d’AEM est conçu comme un environnement de création et de prévisualisation. Il permet d’effectuer la plupart des validations du développement de fonctionnalités, ce qui en fait un élément essentiel du processus de développement local.
Création du dossier ~/aem-sdk/author
Copiez le Quickstart JAR vers ~/aem-sdk/author
et renommez-le en aem-author-p4502.jar
Démarrez le service d’auteur d’AEM local en exécutant ce qui suit à partir de la ligne de commande :
java -jar aem-author-p4502.jar
admin
. Tout mot de passe 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.You cannot Démarrez l’AEM en tant que fichier Jar de démarrage rapide Cloud Service en double-cliquant.
Accédez au service d’auteur d’AEM local à l’adresse http://localhost:4502 dans un navigateur Web
$ 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
$ 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
$ 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
Le service de publication d’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 l’. Un service de publication d’AEM local est important, car il s’intègre aux SDK d’AEM Outils de Dispatcher et permet aux développeurs de tester et d’affiner l’expérience de contact de l’utilisateur final.
Création du dossier ~/aem-sdk/publish
Copiez le Quickstart JAR vers ~/aem-sdk/publish
et renommez-le en aem-publish-p4503.jar
Démarrez le service de publication d’AEM local en exécutant ce qui suit à partir de la ligne de commande :
java -jar aem-publish-p4503.jar
admin
. Tout mot de passe 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.You cannot Démarrez l’AEM en tant que fichier Jar de démarrage rapide Cloud Service en double-cliquant.
Accédez au service de publication AEM local à l’adresse http://localhost:4503 dans un navigateur Web
$ 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
$ 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
$ 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
L’exécution AEM locale peut être démarrée dans mode bêta permettant à un développeur de se positionner par rapport aux fonctionnalités de la prochaine version d’AEM as a Cloud Service. La version préliminaire est activée en transmettant le -r prerelease
sur le premier démarrage de l’exécution AEM locale. Vous pouvez l’utiliser avec les services d’auteur AEM local et de publication AEM.
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease
# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease
# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease
# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease
Dans un environnement de Cloud Service réel, le contenu est distribué du service de création au service de publication à l’aide de Distribution de contenu Sling et le pipeline d’Adobe. La variable Adobe de pipeline est un microservice isolé disponible uniquement dans l’environnement cloud.
Pendant le développement, il peut être souhaitable de simuler la distribution du contenu à l’aide du service local Auteur et Publication. Pour ce faire, activez les agents de réplication hérités.
Les agents de réplication ne peuvent être utilisés que dans le fichier JAR Quickstart local et ne fournissent qu’une simulation de la distribution de contenu.
Connectez-vous au Auteur et accédez à http://localhost:4502/etc/replication/agents.author.html.
Cliquez sur Agent par défaut (publication) pour ouvrir l’agent de réplication par défaut.
Cliquez sur Modifier pour ouvrir la configuration de l’agent.
Sous , Paramètres , mettez à jour les champs suivants :
Sous , Transport , mettez à jour les champs suivants :
http://localhost:4503/bin/receive?sling:authRequestLogin=1
admin
admin
Cliquez sur Ok pour enregistrer la configuration et activer la fonction Par défaut Agent de réplication.
Vous pouvez maintenant apporter des modifications au contenu sur le service Auteur et les publier sur le service Publication.
Le nom du fichier Quickstart Jar, aem-<tier>_<environment>-p<port number>.jar
indique comment il va démarrer. Une fois qu’AEM a commencé dans un niveau, un auteur ou une publication spécifique, il ne peut pas être modifié dans un autre niveau. Pour ce faire, la variable crx-Quickstart
Le dossier généré lors de la première exécution doit être supprimé et Quickstart Jar doit être exécuté à nouveau. L’environnement et les ports peuvent être modifiés, mais ils nécessitent l’arrêt/le démarrage de l’instance d’AEM locale.
Changement d'environnement, 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é d’effectuer principalement le développement local par rapport à la valeur par défaut. dev
le mode d’exécution d’environnement.
Les permutations disponibles sont les suivantes :
Nom de fichier Jar de démarrage rapide | Description du mode |
---|---|
aem-author-p4502.jar |
En tant qu’auteur en mode Exécution de développement sur le port 4502 |
aem-author_dev-p4502.jar |
Comme auteur en mode d’exécution de développement 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 |
Comme auteur en mode d’exécution Production sur le port 4502 |
aem-publish-p4503.jar |
Comme publication en mode d’exécution de développement sur le port 4503 |
aem-publish_dev-p4503.jar |
En tant que publication en mode d’exécution de développement sur le port 4503 (identique à aem-publish-p4503.jar ) |
aem-publish_stage-p4503.jar |
Comme publication en mode d’exécution intermédiaire sur le port 4503 |
aem-publish_prod-p4503.jar |
Comme publication 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 la machine de développement locale, par convention :
Pour les modifier, il peut être nécessaire d’apporter des modifications aux configurations AEM SDK.
Pour arrêter une exécution d’AEM locale, qu’il s’agisse d’AEM Author ou de service Publish, ouvrez la fenêtre de ligne de commande qui a été utilisée pour démarrer l’exécution d’AEM, puis appuyez sur Ctrl-C
. Attendez la fermeture de AEM. Une fois le processus d’arrêt terminé, l’invite de ligne de commande est disponible.
Mettez à jour le SDK AEM au moins une fois par mois ou peu après le dernier jeudi de chaque mois, qui correspond à la date de publication des "versions de fonctionnalités" as a Cloud Service AEM.
La mise à jour du fichier Quickstart Jar vers une nouvelle version nécessite de remplacer 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 validé en toute sécurité dans Git ou exporté depuis l’instance d’AEM locale en tant que modules 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 toutes les modifications apportées au référentiel d’un SDK d’AEM précédent sont perdues. Vous trouverez ci-dessous des stratégies viables pour faciliter la conservation du contenu entre les mises à niveau AEM SDK et peuvent être utilisées séparément ou de concert :
includepaths
pour copier le contenu du référentiel SDK AEM précédent vers le nouveau référentiel SDK AEM.N’oubliez pas que l’utilisation des approches ci-dessus pour conserver le code entre les mises à niveau AEM SDK indique un anti-modèle de développement. Le code non disponible doit provenir de votre IDE de développement et être transmis dans AEM SDK via des déploiements.
Lorsque vous double-cliquez sur le fichier Quickstart Jar pour démarrer, un modal d’erreur s’affiche pour empêcher AEM de démarrer localement.
Cela est dû au fait qu’AEM fichier Jar de démarrage rapide as a Cloud Service ne prend pas en charge le double-clic sur le fichier Jar de démarrage rapide pour commencer AEM localement. Vous devez plutôt exécuter le fichier Jar à partir de cette ligne de commande.
Pour démarrer AEM service Auteur, cd
dans le répertoire contenant le fichier Quickstart Jar et exécutez la commande :
$ java -jar aem-author-p4502.jar
$ java -jar aem-author-p4502.jar
$ java -jar aem-author-p4502.jar
ou pour lancer AEM service de publication, cd
dans le répertoire contenant le fichier Quickstart Jar et exécutez la commande :
$ java -jar aem-author-p4503.jar
$ java -jar aem-author-p4503.jar
$ java -jar aem-author-p4503.jar
Lors du démarrage du fichier Quickstart Jar à partir de la ligne de commande, le processus s’arrête immédiatement et le service AEM ne démarre 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
En effet, AEM as a Cloud Service nécessite Java SDK 11 et vous exécutez une version différente, probablement Java 8. Pour résoudre ce problème, téléchargez et installez Oracle Java SDK 11.
Une fois le SDK Java 11 Oracle installé, vérifiez qu’il s’agit de la version active en exécutant la commande à partir de la ligne de commande :
$ java --version
$ java -version
$ java --version