Cómo utilizar el entorno de desarrollo rápido

Aprenda a utilizar el entorno de desarrollo rápido (RDE) en AEM as a Cloud Service. Implemente código y contenido para ciclos de desarrollo más rápidos de su código casi final en RDE, desde su entorno de desarrollo integrado (IDE) favorito.

AEM AEM AEM Al usar proyecto WKND Sites, aprenderá a implementar varios artefactos de en el RDE ejecutando el comando install de-RDE desde su IDE favorito.

  • AEM implementación del paquete de contenido y código de (todo, ui.apps)
  • Implementación del paquete OSGi y el archivo de configuración
  • Apache y Dispatcher configuran la implementación como archivo zip
  • Archivos individuales como la implementación de HTL, .content.xml (XML de diálogo)
  • Revisar otros comandos de RDE como status, reset and delete

Requisitos previos

AEM Clone el proyecto WKND Sites y ábralo en su IDE favorito para implementar los artefactos de la en RDE.

$ git clone git@github.com:adobe/aem-guides-wknd.git

AEM A continuación, créelo e impleméntelo en el SDK de la aplicación local de la aplicación de la plataforma de desarrollo de software (SDK) ejecutando el siguiente comando de Maven.

$ cd aem-guides-wknd/
$ mvn clean package

AEM AEM Implementar artefactos de mediante el complemento de RDE de

Primero, asegúrese de que tiene instalado el último módulo CLI de aio.

AEM A continuación, utilice el comando aio aem:rde:install para implementar varios artefactos de la. Ahora que debe

Implementar all y dispatcher paquetes

Un punto de partida común es implementar primero los paquetes all y dispatcher ejecutando los siguientes comandos.

# 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

Una vez implementadas correctamente, compruebe el sitio WKND en los servicios de creación y publicación. Debería poder agregar y editar el contenido en las páginas del sitio WKND y publicarlo.

Mejora e implementación de un componente

Vamos a mejorar Hello World Component e implementarlo en RDE.

  1. Abrir el archivo XML de diálogo (.content.xml) desde la carpeta ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld/_cq_dialog/

  2. Agregar el campo de texto Description después del campo de diálogo Text existente

    code language-xml
    ...
    <description
        jcr:primaryType="nt:unstructured"
        sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
        fieldLabel="Description"
        name="./description"/>
    ...
    
  3. Abrir el archivo helloworld.html de la carpeta ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld

  4. Procesar la propiedad Description después del elemento <div> existente de la propiedad 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. AEM Compruebe los cambios en el SDK de la local realizando la compilación de Maven o sincronizando los archivos individuales.

  6. Implemente los cambios en RDE a través del paquete ui.apps o implementando los archivos individuales de Diálogo y HTL:

    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. Compruebe los cambios en el RDE agregando o editando Hello World Component en una página del sitio WKND.

Revisar las opciones de comando install

En el ejemplo de comando de implementación de archivo individual anterior, los indicadores -t y -p se utilizan para indicar el tipo y el destino de la ruta de acceso JCR respectivamente. Revisemos las opciones de comando install disponibles ejecutando el siguiente comando.

$ aio aem:rde:install --help

Los indicadores se explican por sí mismos, el indicador -s es útil para dirigir la implementación solo a los servicios de autor o publicación. AEM Utilice el indicador -t al implementar los archivos content-file o content-xml junto con el indicador -p para especificar la ruta JCR de destino en el entorno de RDE de.

Implementar el paquete OSGi

Para obtener información sobre cómo implementar el paquete OSGi, vamos a mejorar la clase Java™ HelloWorldModel e implementarla en RDE.

  1. Abrir el archivo HelloWorldModel.java de la carpeta core/src/main/java/com/adobe/aem/guides/wknd/core/models

  2. Actualice el método init() como se muestra a continuación:

    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. AEM Compruebe los cambios en el SDK de local implementando el paquete core mediante el comando maven

  4. Implemente los cambios en RDE ejecutando el siguiente comando

    code language-shell
    $ cd core
    $ mvn clean package
    $ aio aem:rde:install target/aem-guides-wknd.core-2.1.3-SNAPSHOT.jar
    
  5. Compruebe los cambios en el RDE agregando o editando Hello World Component en una página del sitio WKND.

Implementar la configuración OSGi

Puede implementar los archivos de configuración individuales o el paquete de configuración completo, por ejemplo:

# 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
Para instalar una configuración OSGi solo en una instancia de autor o publicación, utilice el indicador -s.

Implementar la configuración de Apache o Dispatcher

Los archivos de configuración de Apache o Dispatcher no se pueden implementar individualmente, pero toda la estructura de carpetas de Dispatcher debe implementarse en forma de archivo ZIP.

  1. Realice un cambio deseado en el archivo de configuración del módulo dispatcher; con fines de demostración, actualice dispatcher/src/conf.d/available_vhosts/wknd.vhost para almacenar en caché los archivos de html solo durante 60 segundos.

    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. Verifique los cambios localmente; consulte Ejecutar Dispatcher localmente para obtener más información.

  3. Implemente los cambios en RDE ejecutando el siguiente comando:

    code language-shell
    $ cd dispatcher
    $ mvn clean install
    $ aio aem:rde:install target/aem-guides-wknd.dispatcher.cloud-2.1.3-SNAPSHOT.zip
    
  4. Verificar los cambios en el RDE

AEM Comandos adicionales del complemento RDE

AEM Revisemos los comandos adicionales del complemento RDE para administrar e interactuar con el RDE desde el equipo 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.

Con los comandos anteriores, su RDE se puede administrar desde su IDE favorito para un ciclo de vida de desarrollo/implementación más rápido.

Siguiente paso

Obtenga información acerca del ciclo de vida de desarrollo/implementación usando RDE para ofrecer características con rapidez.

Recursos adicionales

Documentación de comandos RDE

Complemento de CLI de Adobe I/O Runtime AEM para interacciones con entornos de desarrollo rápido de

AEM Configuración del proyecto de

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