Como usar o ambiente de desenvolvimento rápido

Saiba mais como usar Ambiente de desenvolvimento rápido (RDE) 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.

Usar Projeto AEM WKND Sites você aprende a implantar vários artefatos de AEM no RDE executando AEM-RDE install do seu 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
• O Apache e o Dispatcher configuram a implantação como um arquivo zip
• Arquivos individuais como HTL, .content.xml Implantação do (caixa de diálogo XML)
• Revisar outros comandos RDE como status, reset and delete

Pré-requisitos

Clonar o Sites da WKND projeto e abra-o em seu IDE favorito para implantar os artefatos de 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

Usar o aem:rde:install , vamos implantar vários artefatos AEM.

Implantar all e dispatcher pacotes

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

# 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

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.

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

2. Adicione o Description campo de texto após o existente Text campo de diálogo

   ...
   <description
       jcr:primaryType="nt:unstructured"
       sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
       fieldLabel="Description"
       name="./description"/>
   ...
   

3. Abra o helloworld.html arquivo de ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld pasta

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

   ...
   <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. Verifique as alterações no AEM-SDK local executando a compilação maven ou sincronizando arquivos individuais.

6. Implante as alterações no RDE via ui.apps pacote ou implantando a caixa de diálogo individual e os arquivos 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
   

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

Revise o install opções de comando

No exemplo de comando de implantação de arquivo individual acima, a variável -t e -p Os sinalizadores são usados para indicar o tipo e o destino do caminho JCR, respectivamente. Vamos analisar os disponíveis install executando o comando a seguir.

$ aio aem:rde:install --help

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

Implantar pacote OSGi

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

1. Abra o HelloWorldModel.java arquivo de core/src/main/java/com/adobe/aem/guides/wknd/core/models pasta

2. Atualize o init() como abaixo:

   ...
   message = "Hello World!\n"
       + "Resource type is: " + resourceType + "\n"
       + "Current page is:  " + currentPagePath + "\n"
       + "Changes deployed via RDE, lets try faster dev cycles";
   ...
   

3. Verifique as alterações no AEM-SDK local implantando o core pacote via comando maven

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

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

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

Implantar a configuração do Apache ou Dispatcher

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

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

   ...
   <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 as alterações localmente, consulte Executar o Dispatcher localmente para obter mais detalhes.

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

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

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

Próxima etapa

Saiba mais sobre o ciclo de vida de desenvolvimento/implantação usando RDE para fornecer recursos com velocidade.

Recursos adicionais

Documentação de comandos RDE

Plug-in da CLI da Adobe I/O Runtime para interações com ambientes de desenvolvimento AEM Rapid

Configuração de projeto AEM