Découvrez l’utilisation de l’environnement de développement rapide (RDE) dans AEM as a Cloud Service. Déployez du code et du contenu pour accélérer les cycles de développement de votre code quasi-final vers le RDE, à partir de votre environnement de développement intégré (IDE) préféré.
Utilisez le projet de sites WKND AEM pour apprendre à déployer divers artefacts AEM sur le RDE en exécutant la commande install
du RDE d’AEM à partir de votre IDE favori.
.content.xml
(boîte de dialogue XML)status, reset and delete
.Clonez le projet Sites WKND et ouvrez-le dans votre IDE favori pour déployer les artefacts AEM sur le RDE.
$ git clone git@github.com:adobe/aem-guides-wknd.git
Ensuite, créez-le et déployez-le sur le SDK AEM local en exécutant la commande Maven suivante :
$ cd aem-guides-wknd/
$ mvn clean package
À l’aide de la commande aem:rde:install
, nous allons déployer divers artefacts AEM.
all
et dispatcher
.Un point de départ courant consiste à déployer d’abord les packages all
et dispatcher
en exécutant les commandes suivantes :
# Install the 'all' package
$ aio aem:rde:install all/target/aem-guides-wknd.all-2.1.3-SNAPSHOT.zip
# Install the 'dispatcher' zip
$ aio aem:rde:install dispatcher/target/aem-guides-wknd.dispatcher.cloud-2.1.3-SNAPSHOT.zip
Une fois les déploiements réussis, vérifiez le site WKND sur les services de création et de publication. Vous devriez être en mesure d’ajouter et de modifier le contenu sur les pages du site WKND et de le publier.
Ajoutons le Hello World Component
et déployons-le sur le RDE.
Ouvrez le fichier de boîte de dialogue XML (.content.xml
) à partir du dossier ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld/_cq_dialog/
.
Ajoutez le champ de texte Description
après le champ de boîte de dialogue Text
existant.
...
<description
jcr:primaryType="nt:unstructured"
sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
fieldLabel="Description"
name="./description"/>
...
Ouvrez le fichier helloworld.html
à partir du dossier ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld
.
Effectuez le rendu de la propriété Description
d’après l’élément <div>
existant de la propriété Text
.
...
<div class="cmp-helloworld__item" data-sly-test="${properties.description}">
<p class="cmp-helloworld__item-label">Description property:</p>
<pre class="cmp-helloworld__item-output" data-cmp-hook-helloworld="property">${properties.description}</pre>
</div>
...
Vérifiez les modifications sur le SDK AEM local en exécutant la création Maven ou en synchronisant les différents fichiers.
Déployez les modifications apportées au RDE via le package ui.apps
ou en déployant les fichiers de boîte de dialogue et HTL.
# Using 'ui.apps' package
$ cd ui.apps
$ mvn clean package
$ aio aem:rde:install target/aem-guides-wknd.ui.apps-2.1.3-SNAPSHOT.zip
# Or by deploying the individual HTL and Dialog XML
# HTL file
$ aio aem:rde:install ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld/helloworld.html -t content-file -p /apps/wknd/components/helloworld/helloworld.html
# Dialog XML
$ aio aem:rde:install ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld/_cq_dialog/.content.xml -t content-xml -p /apps/wknd/components/helloworld/_cq_dialog/.content.xml
Vérifiez les modifications sur le RDE en ajoutant ou en modifiant le Hello World Component
sur une page du site WKND.
install
Dans l’exemple de commande de déploiement de fichiers ci-dessus, les indicateurs -t
et -p
servent à indiquer respectivement le type et la destination du chemin JCR. Examinons les options de commande install
en exécutant la commande suivante :
$ aio aem:rde:install --help
Les indicateurs sont explicites, l’indicateur -s
est utile pour cibler le déploiement uniquement sur les services de création ou de publication. Utilisez l’indicateur -t
lors du déploiement des fichiers content-file ou content-xml avec l’indicateur -p
pour spécifier le chemin d’accès JCR de destination dans l’environnement RDE AEM.
Pour savoir comment déployer le lot OSGi, améliorons la classe Java™ HelloWorldModel
et déployons-la sur le RDE.
Ouvrez le fichier HelloWorldModel.java
à partir du dossier core/src/main/java/com/adobe/aem/guides/wknd/core/models
.
Mettez à jour la méthode init()
comme ci-dessous :
...
message = "Hello World!\n"
+ "Resource type is: " + resourceType + "\n"
+ "Current page is: " + currentPagePath + "\n"
+ "Changes deployed via RDE, lets try faster dev cycles";
...
Vérifiez les modifications apportées au SDK AEM local en déployant le lot core
via la commande Maven.
Déployez les modifications apportées au RDE en exécutant la commande suivante :
$ cd core
$ mvn clean package
$ aio aem:rde:install target/aem-guides-wknd.core-2.1.3-SNAPSHOT.jar
Vérifiez les modifications sur le RDE en ajoutant ou en modifiant le Hello World Component
sur une page du site WKND.
Vous pouvez déployer les différents fichiers de configuration ou le package de configuration complet, par exemple :
# Deploy individual config file
$ aio aem:rde:install ui.config/src/main/content/jcr_root/apps/wknd/osgiconfig/config/org.apache.sling.commons.log.LogManager.factory.config~wknd.cfg.json
# Or deploy the complete config package
$ cd ui.config
$ mvn clean package
$ aio aem:rde:install target/aem-guides-wknd.ui.config-2.1.3-SNAPSHOT.zip
Pour installer une configuration OSGi uniquement sur une instance de création ou de publication, utilisez l’indicateur -s
.
Les fichiers de configuration Apache ou Dispatcher ne peuvent pas être déployés individuellement, mais toute la structure de dossiers de Dispatcher doit être déployée sous la forme d’un fichier ZIP.
Apportez la modification souhaitée dans le fichier de configuration du module dispatcher
. À des fins de démonstration, mettez à jour le dispatcher/src/conf.d/available_vhosts/wknd.vhost
pour mettre en cache les fichiers html
uniquement pendant 60 secondes.
...
<LocationMatch "^/content/.*\.html$">
Header unset Cache-Control
Header always set Cache-Control "max-age=60,stale-while-revalidate=60" "expr=%{REQUEST_STATUS} < 400"
Header always set Surrogate-Control "stale-while-revalidate=43200,stale-if-error=43200" "expr=%{REQUEST_STATUS} < 400"
Header set Age 0
</LocationMatch>
...
Vérifiez les modifications localement, et consultez Exécution locale de Dispatcher pour plus d’informations.
Déployez les modifications apportées au RDE en exécutant la commande suivante :
$ cd dispatcher
$ mvn clean install
$ aio aem:rde:install target/aem-guides-wknd.dispatcher.cloud-2.1.3-SNAPSHOT.zip
Vérifier les modifications apportées au RDE
Examinons les commandes supplémentaires du plug-in du RDE AEM pour gérer et interagir avec le RDE depuis votre ordinateur local.
$ aio aem:rde --help
Interact with RapidDev Environments.
USAGE
$ aio aem rde COMMAND
COMMANDS
aem rde delete Delete bundles and configs from the current rde.
aem rde history Get a list of the updates done to the current rde.
aem rde install Install/update bundles, configs, and content-packages.
aem rde reset Reset the RDE
aem rde restart Restart the author and publish of an RDE
aem rde status Get a list of the bundles and configs deployed to the current rde.
À l’aide des commandes ci-dessus, votre RDE peut être géré à partir de votre IDE favori pour accélérer le cycle de vie du développement/déploiement.
En savoir plus sur les cycle de vie de développement/déploiement à l’aide de RDE pour fournir des fonctionnalités rapidement.