If you want to give your end users the possibility to create new instances of live demos of your product, while allowing them to customize it (e.g. using an embedded database or an external one, number of cores, ...) - Cluster Broccoli is for you.
Cluster Broccoli is meant to be setup by your IT. Some technical knowledge is required to setup the infrastructure and define the templates. End users can be internal (QA, data scientists) or external (customers, potential customers).
Cluster Broccoli comes with a minimalistic web user interface. It allows you to create, destroy, start and stop your instances based on a set of predefined templates. Please consult the documentation for a detailed description of the Web UI.
Cluster Broccoli provides a RESTful HTTP API. You can control it using curl, writing your own command line wrapper or connect from your microservices. Please consult the documentation for a detailed description of the HTTP API.
- Nomad (HTTP API v1)
- Java (for running the Play application)
- Nomad (HTTP API v1)
- Consul (HTTP API v1)
- Cluster Broccoli Nomad Job + Docker Image (for running the Play application)
Distributed Application Server
Broccoli needs to run as a single instance. It is neither supported to run multiple Broccoli instances sharing the same instance storage, nor running Broccoli in distributed mode because it uses a local cache to store the session IDs.
Using the Production Docker Image
If you only need an image to run the Broccoli distribution, go with the JRE based production-ready image.
docker run -p 9000:9000 frosner/cluster-broccoli \ -Dbroccoli.nomad.url=<your-nomad-url> \ -Dbroccoli.consul.url=<your-consul-url>
Building from Source
Clone this repository and run
sbt dist to build an universal ZIP file in
To build the production Docker image in a local Docker daemon run
sbt docker:publishLocal local instead.
sbt docker:stage creates a directory with intermediate artifacts and the
server/target/docker/stage; use this command to inspect the image contents before building or to manually build the image with a custom docker command.
In order to configure Cluster Broccoli, you can add key value pairs to your configuration. The following configuration properties are supported. Please refer to the Wiki for more information about the individual topics.
Nomad and Consul
||Address of your consul server||
||Lookup method used for consul. Options: