Apache Brooklyn

Clone this repo:
  1. 47c1246 Merge pull request #31 from nakomis/ignore-java-version by Thomas Bouron · 3 days ago master
  2. f7ef3e7 Merge pull request #32 from infrastation/master by Thomas Bouron · 3 days ago
  3. 4a83d86 Merge pull request #33 from tbouron/master by Thomas Bouron · 4 days ago
  4. ae872cd Add jenkinsfile for multibranch job on Jenkins by Thomas Bouron · 6 days ago
  5. 7e815e4 fixup README.md by Denis Ovsienko · 11 days ago

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 https://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 -DskipDocker

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 /var/run/docker.sock:/var/run/docker.sock \
      -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 /var/run/docker.sock:/var/run/docker.sock \
      -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

Non-Git Build

If you are performing a build on code not in source control (e.g. from a ZIP of source code, or after deleting SCM metadata), you will need to manually set two variables that are normally inferred from the environment:

  • -DbuildNumber=manual
  • -DscmBranch=manual

You can set these properties to any value you wish. When using a checkout from git, the buildNumber is set to the SHA1 commit ID (short form) of the containing project, and the scmBranch is set to the git branch.

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.