AEM Platform BuildEnv is a Docker-based environment for building AEM OpenCloud repositories. The Docker image already contains the software required to run all build targets from those repositories.
Pull AEM Platform BuildEnv Docker image from Docker Hub:
docker pull shinesolutions/aem-platform-buildenv
Or alternatively, you can create the Docker image:
# Install Hashicorp packer tool for your OS
https://www.packer.io/intro/getting-started/install.html
# Install Ruby bundler module (may require sudo)
gem install bundler --conservative
git clone https://github.com/shinesolutions/aem-platform-buildenv
cd aem-platform-buildenv
make deps
make docker-base
Run a Docker container from the repository directory: (you might want to create an alias for the lengthy command below)
docker run \
--rm \
--workdir /opt/workspace \
-v /var/run/docker.sock:/var/run/docker.sock \
-v `pwd`:/opt/workspace \
-i -t shinesolutions/aem-platform-buildenv
You can also run the command without --rm flag if you want to keep the container along with the downloaded tools and dependencies.
Please note that the above image does not contain any credential. It's up to you to set up your AWS/SCM/etc credentials.
| Name | Image | Description |
|---|---|---|
| py2 | base, sandpit |
Enable Python 2 (currently 2.7) Virtualenv |
| py3 | base, sandpit |
Enable Python 3 (currently 3.4) Virtualenv |
| gsso2aws | sandpit |
Authenticate to AWS using Google SSO |
Starting from AEM Platform BuildEnv 1.0.0, it's possible to use AWS ECR as an alternative to Docker Hub as Docker registry.
- Create ECR repository named
aem-platform-buildenv - Create configuration file
aws.regionanddocker.repository - Create Docker image by running
make docker-base config_path=<path/to/config/dir> - Publish Docker image by running
make publish-base config_path=<path/to/config/dir>