shinesolutions-aem_curator

Puppet module for installing and configuring a curated set of Adobe Experience Manager (AEM) components


Keywords
adobe-experience-manager, aem, cq, aem-opencloud, puppet
License
Apache-2.0
Install
puppet module install shinesolutions-aem_curator --version 2.8.0

Documentation

Build Status Published Version Downloads Count Known Vulnerabilities

Puppet AEM Curator

A Puppet module for installing and configuring a curated set of Adobe Experience Manager (AEM) components.

This module supports AEM installation for various versions along with a combination of Service Packs, Cumulative Fix Packs, and hotfixes. Those combinations are bundled into what this module calls AEM Profiles.

Other than AEM installation, it also supports some common AEM management events:

  • Deployment of a single AEM package or a single Dispatcher package
  • Deployment of multiple AEM packages and Dispatcher packages declared in a descriptor file
  • Enable and disable CRXDE
  • Promote an AEM Author Standby to AEM Author Primary
  • Flush AEM Dispatcher cache
  • Export a single AEM package for backup
  • Export multiple AEM packages for backup, declared in a descriptor file
  • Import a single backup AEM package
  • List AEM packages
  • AEM Upgrade automation

Puppet AEM Curator is designed to provision an AEM environment in two phases:

  1. Installation of AEM
  2. Configuration and running of AEM

Phase 1: Installation of AEM

A single AEM installation can take quite a while. Rough timing of an AEM installation (on AWS EC2 instance type m4.2xlarge) which includes variation of service packs, cumulative fix packs, and hotfixes, can take about half an hour plus.

Due to the above, the desire is to take a machine image of this AEM installation, so we don't have to reinstall AEM every time a new AEM environment is created. This AEM installation can then be used across multiple environments, hence the installation cost is only once per AEM / service pack / cumulative fix version for a given machine image.

The installation is implemented in the following manifests:

The above manifests result in AEM being gracefully stopped in order to ensure the correctness of the repository.

Phase 2: Configuration and running of AEM

The configuration and running of AEM ends up with the AEM instance being provisioned with environment-specific details (e.g. an admin password that is unique to that environment, a configuration file that uses the ip address of the server, etc). The idea here is that we can stand up dozens of AEM environments without installing AEM each and every time. It simply uses the machine image taken on step one above (Installation of AEM).

The configuration and running are implemented in the following manifests:

The above manifests result in AEM being configured, up and running, ready to accept incoming requests.

Learn more about Puppet AEM Curator:

Puppet AEM Curator is part of AEM OpenCloud platform but it can be used as a stand-alone.

Installation

puppet module install shinesolutions-aem_curator

Or via a Puppetfile:

mod 'shinesolutions/aem_curator'

If you want to use the master version:

mod 'shinesolutions/aem_curator', :git => 'https://github.com/shinesolutions/puppet-aem-curator'

Usage

TODO: example class/definition calls