Comment utiliser l’environnement de développement rapide
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.
- Déploiement du code AEM et du package de contenu (tous, ui.apps)
- Déploiement du lot OSGi et du fichier de configuration
- Apache et Dispatcher configurent le déploiement en tant que fichier zip.
- Déploiement de fichiers individuels tels que HTL,
.content.xml
(boîte de dialogue XML) - Examinez d’autres commandes du RDE, comme
status, reset and delete
.
Prérequis
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
Déploiement d’artefacts AEM à l’aide du plug-in AEM-RDE
Tout d'abord, assurez-vous que le module dernier aio
CLI est installé.
Ensuite, utilisez la commande aio aem:rde:install
pour déployer divers artefacts AEM. Maintenant que vous devez
Déployer les packages 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' content package (zip file)
$ aio aem:rde:install all/target/aem-guides-wknd.all-2.1.3-SNAPSHOT.zip
# Install the 'dispatcher' deployment artifact (zip file)
$ 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.
Améliorer et déployer un composant
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 dossierui.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 dialogueText
existant.code language-xml ... <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 dossierui.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
.code language-html ... <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 d’AEM local en exécutant la création Maven ou en synchronisant des fichiers individuels.
-
Déployez les modifications apportées au RDE via le package
ui.apps
ou en déployant les fichiers Dialog et HTL individuels :code language-shell # 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.
Examiner les options de commande 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.
Déployer le lot OSGi
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 dossiercore/src/main/java/com/adobe/aem/guides/wknd/core/models
. -
Mettez à jour la méthode
init()
comme ci-dessous :code language-java ... 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 :
code language-shell $ 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.
Déployer la configuration OSGi
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
-s
.Déployer la configuration Apache ou Dispatcher
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 ledispatcher/src/conf.d/available_vhosts/wknd.vhost
pour mettre en cache les fichiershtml
uniquement pendant 60 secondes.code language-none ... <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 :
code language-shell $ 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
Commandes supplémentaires du plug-in du RDE AEM
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.
Étape suivante
En savoir plus sur les cycle de vie de développement/déploiement à l’aide de RDE pour fournir des fonctionnalités rapidement.
Ressources supplémentaires
Documentation relatives aux commandes du RDE