Cloudbreak simplifies the provisioning, management and monitoring of on-demand HDP clusters in virtual and cloud environments. Cloudbreak leverages the cloud infrastructure platform resources to create host instances, uses Docker technology to deploy the requisite containers cloud-agnostically, and uses Apache Ambari (via Ambari Blueprints) to install and manage the HDP cluster.

Use the Cloudbreak Web UI or CLI to launch HDP clusters on public cloud infrastructure platforms such as Microsoft Azure, Amazon Web Services (AWS), and Google Cloud Platform (GCP) and the private cloud infrastructure platform OpenStack.

Cloudbreak has two main components: the Cloudbreak Application and the Cloudbreak Deployer.

The Cloudbreak Application is made up from microservices (Cloudbreak, Uluwatu, Sultans, ...). The Cloudbreak Deployer helps you to deploy the Cloudbreak application automatically with Docker support. Once the Cloudbreak Application is deployed, you can use it to provision HDP clusters in different cloud environments.

For an architectural overview of the Cloudbreak Deployer, the Cloudbreak Application, Apache Ambari, Docker and the rest of the Cloudbreak components, please follow this link.


The high-level process to be able to use Cloudbreak to install an HDP cluster includes the following steps:

  1. Install the Cloudbreak Deployer by either: installing the Cloudbreak Deployer on your own VM/host (Option #1); or by instantiating one of the pre-built cloud images that includes Cloudbreak Deployer pre-installed (Option #2).
  2. Configure the Cloudbreak Deployer and install the Cloudbreak Application. Once you have installed Cloudbreak Deployer (called "cbd"), it will start up several Docker containers: Cloudbreak API, Cloudbreak Web UI (called "Uluwatu"), Identity Server and supporting databases. You have finished this step if you are able to login in your browser to Cloudbreak Web UI.
  3. Provision an HDP Cluster using the Cloudbreak Application.

Installing the Cloudbreak Deployer (Install Option #1)

Minimum and Recommended System requirements: RHEL / CentOS / Oracle Linux 7 (64-bit), Docker 1.9.1, 4GB RAM, 10GB disk, 2 cores recommended

You can install the Cloudbreak Deployer on your own VM/host manually. Once installed, you will use the Deployer to setup the Cloudbreak Application. We suggest you install the Cloudbreak Application as close to the desired HDP clusters as possible. For example, if you plan to launch clusters on AWS, install the Cloudbreak Application in AWS.

Follow the instructions for installing the Cloudbreak Deployer. Alternatively, you can consider using one of the pre-built cloud images that includes Cloudbreak Deployer pre-installed.

IMPORTANT: If you plan to use Cloudbreak on Azure, you must use the Azure Setup instructions to configure the image.

Using the Pre-Built Cloud Images (Install Option #2)

We have pre-built cloud images with Cloudbreak Deployer pre-installed. In the below table you can find the provider specific guides to configure and launch cbd (Cloudbreak Deployer) then clusters.

Minimum and Recommended VM requirements: 4GB RAM, 10GB disk, 2 cores recommended

Cloud Cloud Image
AWS You can follow the AWS instructions using this link.
Azure There are no pre-built cloud images available for Azure. But we provide an option to use Azure Resource Manager Templates instead. See Azure Setup to get the Cloudbreak Deployer installed and configured.
GCP You can follow the GCP instructions using this link
OpenStack You can follow the OpenStack instructions using this link

Learn More

For more information on Cloudbreak, Docker, Ambari and Ambari Blueprints, see:

Resource Description
Cloudbreak Project Cloudbreak is a tool to help simplify the provisioning of HDP clusters in virtual and cloud environments.
Cloudbreak Forums Get connected with the community in the Cloudbreak Forums.
Apache Ambari Project Apache Ambari is an operational platform for provisioning, managing, and monitoring Apache Hadoop clusters. Ambari exposes a robust set of REST APIs and a rich Web interface for cluster management.
Ambari Blueprints Ambari Blueprints are a declarative definition of a Hadoop cluster that Ambari can use to create Hadoop clusters.
Docker Docker is an open platform for developers and system administrators to build, ship, and run distributed applications.
Edit on GitHub