Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/apache/brooklyn
Apache Brooklyn
https://github.com/apache/brooklyn
brooklyn cloud java
Last synced: about 1 month ago
JSON representation
Apache Brooklyn
- Host: GitHub
- URL: https://github.com/apache/brooklyn
- Owner: apache
- License: apache-2.0
- Created: 2015-12-02T08:00:06.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-07-17T11:16:26.000Z (4 months ago)
- Last Synced: 2024-09-30T01:21:24.318Z (about 2 months ago)
- Topics: brooklyn, cloud, java
- Language: Dockerfile
- Homepage:
- Size: 774 KB
- Stars: 138
- Watchers: 13
- Forks: 69
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [](https://brooklyn.apache.org/)
### Apache Brooklyn helps to model, deploy, and manage systems.
_This root project is a wrapper around subprojects. **See individual projects for recent changes.**_
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]( https://brooklyn.apache.org/ )**,
where you'll find:
* **[ Pre-built binaries ]( https://brooklyn.apache.org/download/ )**
* **[ Getting Started instructions ]( https://brooklyn.apache.org/v/latest/start/running.html )**
* **[ A Product Tour ](https://brooklyn.apache.org/learnmore/)**
### 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
However, this will not 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:
```bash
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) -Drpm -Ddeb -Dclient -Ddocker
```
You can speed this up by using your local .m2 cache:
```bash
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) -Drpm -Ddeb -Dclient -Ddocker
```
The results are in `brooklyn-dist/dist/target/`, including a tar and a zip.
Or to run straight after the build, do:
```bash
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](https://brooklyn.apache.org/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.2.0-SNAPSHOT)](https://brooklyn.apache.org/v/1.2.0-SNAPSHOT/dev/), [latest stable](https://brooklyn.apache.org/v/latest/dev/), and [older releases](https://brooklyn.apache.org/meta/versions.html).
Useful topics include:
* getting the **[source code](https://brooklyn.apache.org/developers/code/)**
* **[setting up Git](https://brooklyn.apache.org/developers/code/git-more.html)** with forks, submodules (or alternatively [avoiding submodules](https://brooklyn.apache.org/developers/code/git-more.html#not-using-submodules)) and other productivity hints
* the **[maven build](https://brooklyn.apache.org/v/latest/dev/env/maven-build.html)** and what to do on build errors
* **[project structure](https://brooklyn.apache.org/v/1.2.0-SNAPSHOT/dev/code/structure.html)** of the codebase and submodules
* the **[people](https://brooklyn.apache.org/community/)** behind Apache Brooklyn
### 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.