Mirror of Apache Brooklyn
Latest commit a915db7 Oct 1, 2018

README.md

Brooklyn

Apache Brooklyn helps to model, deploy, and manage systems.

It supports blueprints in YAML or Java, and deploys them to many clouds and other target environments. It monitors those deployments, maintains a live model, and runs autonomic policies to maintain their health.

For more information visit brooklyn.apache.org, where you'll find:

Quick Start

This is the uber-repo. To build the entire codebase, get this project and its sub-modules:

git clone http://github.com/apache/brooklyn/
cd brooklyn
git submodule init
git submodule update --remote --merge --recursive

And then, with jdk 1.8+ and maven 3.1+ installed:

mvn clean install -Dno-go-client -Dno-rpm -Dno-deb

However, you won't be able to build the RPM/DEB packages, as well as the CLI. That's why we would recommand to use the alternative: a docker container to build this project:

docker build -t brooklyn .
docker run -i --rm --name brooklyn -u $(id -u):$(id -g) \
      --mount type=bind,source="${HOME}/.m2/settings.xml",target=/var/maven/.m2/settings.xml,readonly \
      -v ${PWD}:/usr/build -w /usr/build \
      brooklyn mvn clean install -Duser.home=/var/maven -Duser.name=$(id -un)

You can speed this up by using your local .m2 cache:

docker run -i --rm --name brooklyn -u $(id -u):$(id -g) \
      -v ${HOME}/.m2:/var/maven/.m2 \
      -v ${PWD}:/usr/build -w /usr/build \
      brooklyn mvn clean install -Duser.home=/var/maven -Duser.name=$(id -un)

The results are in brooklyn-dist/dist/target/, including a tar and a zip. Or to run straight after the build, do:

pushd brooklyn-dist/karaf/apache-brooklyn/target/assembly/
./bin/start

Resources

The Developers section of the main website contains more detail on working with the codebase. There is also a more Developer Guide specific to each version, including this branch (1.0.0-SNAPSHOT), latest stable, and older releases.

Useful topics include:

License

This software is distributed under the Apache License, version 2.0, copyright (c) The Apache Software Foundation and contributors. Please see the LICENSE file for (1) the full text of the Apache License, followed by (2) notices for bundled software and (3) licenses for bundled software.