wttech / gradle-aem-boot

Example project for booting local AEM instances and AEM dispatcher automatically

AEM Boot

This project could be used to boot local AEM instances and AEM dispatcher automatically.

As an effect, it sets up:

• http://we-retail.example.com - AEM sample content / website,
• http://author.example.com - AEM author instance.

Automation used in this project is based on:

• Gradle AEM Plugin - setting local AEM instances running natively,
• Gradle Environment Plugin - setting AEM dispatcher running on Docker.

Table of Contents

• Quickstart
• Environment
• Tooling
• Extending build

Quickstart

1. Clone project using command:

   git clone https://github.com/wttech/gradle-aem-boot.git && cd gradle-aem-boot

2. Setup user specific AEM configuration using command:

   sh gradlew props

   and specify properties:

   

3. Setup hosts file using command (administrator / super user permissions required):

   sh hosts

   or on Windows

   hosts.bat

4. Setup local AEM instances and environment using command:

   sh gradlew

   or equivalent

   sh gradlew setup await

Repeating command above will:

• install new dependent CRX packages defined
• perform new provisioning steps defined

Environment

Tested on:

• Java 1.8
• Gradle 5.4.1
• Adobe AEM 6.5
• Docker 2.0.0.3

Tooling

• Generating / updating AEM instance configuration: sh gradlew props,
• Monitoring errors in logs: sh gradlew instanceTail,
• Copying content between environments/instances: sh gradlew instanceRcp,
• Running content migration Groovy scripts: sh gradlew instanceGroovyEval.

Review plugin documentation for more details / how to use tools mentioned above.

Extending build

For defining new tasks directly in build see:

• Build Script Basics
• More about Tasks

The easiest way to implement custom plugins and use them in project is a technique related with buildSrc/ directory. For more details please read documentation.

gradle-aem-boot's Issues

Advanced environment setup example with KnotX

Create full example of AEM ecosystem with:

• author
• publish
• dispatcher
• reverse-proxy
• knotx

Open browser after first run of setup

using URLs defined in hosts

Replace We.Retail with WKND Guide

as of we.retail is no longer maintained / reference AEM site has changed.

https://github.com/adobe/aem-guides-wknd