Chef cookbook to install Ambari server and Ambari agent, then deploy a Hadoop cluster using the Blueprints API
Ruby HTML
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
attributes
recipes
spec
templates/default
.gitignore
.rspec
.rubocop.yml
.travis.yml
Berksfile
Gemfile
LICENSE
README.md
Rakefile
chefignore
metadata.rb

README.md

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.

Requirements

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

Usage

ambari::server

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

{
  "name":"my_node",
  "run_list": [
    "recipe[ambari::server]"
  ]
}

ambari::agent

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'].

{
  "name":"my_node",
  "run_list": [
    "recipe[ambari::agent]"
  ]
}

ambari::blueprints

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 http://public-repo-1.hortonworks.com/ambari/centos5/2.x/updates/2.0.0/ambari.repo
node['ambari']['rhel_6_repo'] URL for the RHEL 6.x repository http://public-repo-1.hortonworks.com/ambari/centos6/2.x/updates/2.0.0/ambari.repo
node['ambari']['suse_11_repo'] URL for the Suse 11.x repository http://public-repo-1.hortonworks.com/ambari/suse11/2.x/updates/2.0.0/ambari.repo
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 : https://cwiki.apache.org/confluence/display/AMBARI/Blueprints#Blueprints-ExampleBlueprint
node['ambari']['blueprints']['cluster_name'] Cluster's name
node['ambari']['blueprints']['cluster_json'] JSON template for the Cluster. See a single-node example here: https://cwiki.apache.org/confluence/display/AMBARI/Blueprints#Blueprints-ExampleClusterCreationTemplate

Contributing

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

http://www.apache.org/licenses/LICENSE-2.0

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.