Chef cookbook to install Ambari server and Ambari agent, then deploy a Hadoop cluster using the Blueprints API
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Ambari Cookbook

Travis CI status

Install ambari-server and ambari-agent in order to provision a cluster with the Hortonworks Data Platform. This cookbook also supports provisioning supported services through the Ambari API via Ambari Blueprints. For more on blueprints, please refer to the Apache project's documentation here.


Supports all OS distributions and versions supported by Ambari. Supports Ambari versions 1.7 through 2.4.

  • RHEL, CentOS, and Oracle Linux 5, 6, and 7.
  • Suse 11
  • Ubuntu 12 and 14.
  • Debian 7



Include ambari::server in your node's run_list:

  "run_list": [


Include ambari::agent in your node's run_list (all the nodes of your cluster):

The Ambari Server will be automatically detected, but you can override this detection using the attribute node['ambari']['server_fqdn'].

  "run_list": [


Include ambari::blueprints in your node's run_list. Then configure the blueprints attributes listed below.

Main Attributes

Key Description Default
node['ambari']['rhel_5_repo'] URL for the RHEL 5.x repository
node['ambari']['rhel_6_repo'] URL for the RHEL 6.x repository
node['ambari']['suse_11_repo'] URL for the Suse 11.x repository
node['ambari']['server_fdqn'] FQDN for the Ambari server Found by searching a node using the recipe ambari::server in the same environment

Blueprints Attributes

Key Description
node['ambari']['blueprints']['blueprint_name'] Name of the cluster's blueprint
node['ambari']['blueprints']['blueprint_json'] JSON description of the Blueprint. See a single-node example here :
node['ambari']['blueprints']['cluster_name'] Cluster's name
node['ambari']['blueprints']['cluster_json'] JSON template for the Cluster. See a single-node example here:


If you wish to contribute on this cookbook:

  1. Fork the repository on Github
  2. Create a named feature branch (like add_component_x)
  3. Write your change
  4. Write tests for your change (if applicable)
  5. Run the tests, ensuring they all pass
  6. Submit a Pull Request using Github

License and Authors

Author: Julien Pellet

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.