Documentação AEM Tutoriais do AEM Tutorials do AEM as a Cloud Service

Como usar o ambiente de desenvolvimento rápido

Last update: Fri Aug 09 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Ferramentas de desenvolvedores

Criado para:

Iniciante
Desenvolvedor

Saiba como usar o Ambiente de desenvolvimento rápido (RDE) do no AEM as a Cloud Service. Implante código e conteúdo para ciclos de desenvolvimento mais rápidos do seu código quase final no RDE, a partir do seu ambiente de desenvolvimento integrado (IDE) favorito.

Usando o Projeto AEM WKND Sites, você aprenderá a implantar vários artefatos AEM no RDE executando o comando AEM-RDE install no IDE favorito.

Implantação do código e do pacote de conteúdo do AEM (all, ui.apps)
Implantação do pacote OSGi e do arquivo de configuração
Implantação de configurações do Apache e Dispatcher como um arquivo zip
Arquivos individuais como HTL, implantação de .content.xml (caixa de diálogo XML)
Revisar outros comandos RDE como status, reset and delete

video poster

https://video.tv.adobe.com/v/3415491?quality=12&learn=on

Pré-requisitos

Clonar o projeto WKND Sites e abri-lo em seu IDE favorito para implantar os artefatos do AEM no RDE.

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

Em seguida, crie e implante-o no AEM-SDK local executando o seguinte comando maven.

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

Implantar artefatos de AEM usando o plug-in AEM-RDE

Primeiro, verifique se você tem o último aio módulo CLI instalado.

Em seguida, use o comando aio aem:rde:install para implantar vários artefatos de AEM. Agora que você deve

Implantar pacotes `all` e `dispatcher`

Um ponto de partida comum é primeiro implantar os pacotes all e dispatcher executando os comandos a seguir.

# 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

Após implantações bem-sucedidas, verifique o site do WKND nos serviços de criação e publicação. Você deve ser capaz de adicionar, editar e publicar o conteúdo nas páginas do site WKND.

Aprimorar e implantar um componente

Vamos aprimorar o Hello World Component e implantá-lo no RDE.

Abrir o arquivo XML da caixa de diálogo (.content.xml) da pasta ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld/_cq_dialog/

Adicionar o campo de texto Description após o 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"/> ...`

Abrir o arquivo helloworld.html da pasta ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld

Renderize a propriedade Description após o elemento <div> existente da propriedade Text.

code language-html

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

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

Verifique as alterações no SDK AEM local executando a compilação do Maven ou sincronizando arquivos individuais.

Implante as alterações no RDE por meio do pacote ui.apps ou implantando a caixa de diálogo individual e os arquivos HTL:

code language-shell

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

# 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

Verifique as alterações no RDE adicionando ou editando o Hello World Component em uma página do site WKND.

Examine as opções do comando `install`

No exemplo de comando de implantação de arquivo individual acima, os sinalizadores -t e -p são usados para indicar o tipo e o destino do caminho JCR, respectivamente. Vamos revisar as opções de comando install disponíveis executando o seguinte comando.

$ aio aem:rde:install --help

Os sinalizadores são autoexplicativos, o sinalizador -s é útil para direcionar a implantação apenas para os serviços de autoria ou publicação. Use o sinalizador -t ao implantar os arquivos content-file ou content-xml junto com o sinalizador -p para especificar o caminho JCR de destino no ambiente AEM RDE.

Implantar pacote OSGi

Para saber como implantar o pacote OSGi, vamos aprimorar a classe Java™ HelloWorldModel e implantá-la no RDE.

Abrir o arquivo HelloWorldModel.java da pasta core/src/main/java/com/adobe/aem/guides/wknd/core/models

Atualize o método init() conforme abaixo:

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"; ...`

Verifique as alterações no AEM-SDK local implantando o pacote core por meio do comando maven

Implante as alterações no RDE executando o seguinte comando

code language-shell
`$ cd core $ mvn clean package $ aio aem:rde:install target/aem-guides-wknd.core-2.1.3-SNAPSHOT.jar`

Verifique as alterações no RDE adicionando ou editando o Hello World Component em uma página do site WKND.

Implantar configuração OSGi

Você pode implantar os arquivos de configuração individuais ou concluir o pacote de configuração, por exemplo:

# 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 uma configuração OSGi somente em uma instância de autor ou publicação, use o sinalizador -s.

Implantar a configuração do Apache ou Dispatcher

Os arquivos de configuração do Apache ou Dispatcher não podem ser implantados individualmente, mas toda a estrutura de pastas do Dispatcher precisa ser implantada no formato de um arquivo ZIP.

Faça uma alteração desejada no arquivo de configuração do módulo dispatcher, para fins de demonstração, atualize o dispatcher/src/conf.d/available_vhosts/wknd.vhost para armazenar os arquivos html em cache somente por 60 segundos.

code language-none

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

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

Verifique as alterações localmente. Consulte Executar o Dispatcher localmente para obter mais detalhes.

Implante as alterações no RDE executando o seguinte comando:

code language-shell
`$ cd dispatcher $ mvn clean install $ aio aem:rde:install target/aem-guides-wknd.dispatcher.cloud-2.1.3-SNAPSHOT.zip`

Verificar alterações no RDE

Comandos adicionais do plug-in AEM RDE

Vamos rever os comandos adicionais do plug-in AEM RDE para gerenciar e interagir com o RDE na sua máquina 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.

Usando os comandos acima, seu RDE pode ser gerenciado a partir de seu IDE favorito para um ciclo de vida de desenvolvimento/implantação mais rápido.