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.

  1. 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/.

  2. Ajoutez le champ de texte Description après le champ de boîte de dialogue Text existant.

    code language-xml
    ...
    <description
        jcr:primaryType="nt:unstructured"
        sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
        fieldLabel="Description"
        name="./description"/>
    ...
    
  3. Ouvrez le fichier helloworld.html à partir du dossier ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld.

  4. 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>
    ...
    
  5. Vérifiez les modifications sur le SDK d’AEM local en exécutant la création Maven ou en synchronisant des fichiers individuels.

  6. 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
    
  7. 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.

  1. Ouvrez le fichier HelloWorldModel.java à partir du dossier core/src/main/java/com/adobe/aem/guides/wknd/core/models.

  2. 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";
    ...
    
  3. Vérifiez les modifications apportées au SDK AEM local en déployant le lot core via la commande Maven.

  4. 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
    
  5. 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
TIP
Pour installer une configuration OSGi uniquement sur une instance de création ou de publication, utilisez l’indicateur -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.

  1. 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.

    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>
    ...
    
  2. Vérifiez les modifications localement, et consultez Exécution locale de Dispatcher pour plus d’informations.

  3. 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
    
  4. 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

Plug-in d’interface de ligne de commande Adobe I/O Runtime pour les interactions avec les environnements de développement rapide AEM

Configuration du projet AEM

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69