KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

docker-hdp-lab

★ 35 Open GitHub ↗

Project: docker-hdp-lab

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Docker HDP Lab Cluster

#### Objective

##### To achieve the target of building and starting a complete HDP cluster in less than 5 minutes, using Docker based instances.

-------

#### Introduction

To automate building HDP clusters at such a fast pace, we Run HDP Clusters using Docker based instances, where each docker instance represents a cluster node.
And we prepare ambari-agent and ambari-server images for various releases in addition to maintaining a local HDP repository for all possible versions.
Further, we make use of Ambari blueprints to install and start HDP services in the clusters.

-------

#### Building a Docker HDP Lab

Multiple Docker Host Machines can be used in a Docker Swarm cluster to provide the required hardware resources to the instances.

#####Use the following instructions to setup multiple (or single) Docker Host machines in a Swarm cluster, using an RHEL 7/Centos 7/OEL 7 server

Repeat these steps for all the Docker Host Machines-

*1. Install a Minimal setup of centos7 / rhel7 / oel7 OS on a Physical Hardware / VirtualBox / OpenStack Instance.

*2. Install the package "git" using yum:

yum install -y git

*3. Install the required Docker packages (Optional Step, since the ./install script would install docker-engine)  
  (refer: https://docs.docker.com/engine/installation/linux/centos/ )

*4. Download the docker-hdp-lab setup files:

git clone https://github.com/rmaruthiyodan/docker-hdp-lab/

*5. Place the config file - "docker-hdp-lab.conf" in /etc/

cd docker-hdp-lab
	cp docker-hdp-lab.conf /etc/

*6. Edit the configs in: '/etc/docker-hdp-lab.conf' and set the following properties as appropriate for your environment:

---

> SWARM_MANAGER  -  Defines the Docker Host that will run the Docker Swarm manager instance.
> LOCAL_REPO_NODE  -  Defines the Docker Host where the local repos will be saved and which will run a httpd instance to serve local repos.
> DEFAULT_DOMAIN_NAME  -  This will be the name set for the overlay network.
> OVERLAY_NETWORK  -  Defines the subnet and the netmask for the overlay network(example: 10.0.1.0/24).
> LOCAL_IP  -  Define the IP address of the Docker host.  
  
>  The SWARM_MANAGER Docker Host will run the following instances as well:
>  i_ consul instance
>  ii_ overlay-gatewaynode

---

*7. Check (and config if needed) that all the Docker host machines can resolve each other's hostnames (FQDN) , including its own hostname.

*8. Run the "install" command:

# cd docker-hdp-lab
	# ./install.sh  
	
>Run the install.sh command first on the node that will act as SWARM Manager Node, and then on LocalRepository server and others.

The "install.sh" script mainly does the following activities:  
 a) Installs and configures docker-engine  
 b) Starts consul, swarm manager and swarm join containers  
 c) Creates overlay network, creates a Gateway Container and sets up required routing on each docker-host.  
 d) Enables and starts the systemd service: "docker-hdp-lab.service:"

-------

##### At this Stage, the setup is completed and let's start using it...

*9. To start with, prepare the Ambari images using public repo (or using a local repo, as given in step 10)  
Run the "build_image.sh" command and specify the Ambari version along with the Repository Base URL:  
  
(this step may take more than an hour, but it should be that slow only for the first image build process, since docker images re-uses the layers for the subsequent builds)

# source /etc/docker-hdp-lab.conf
	
	# nohup build_image.sh  2.2.2.0  http://public-repo-1.hortonworks.com/ambari/centos6/2.x/updates/2.2.2.0/ &
	(To Build images for Ambari version 2.2.2.0, using public repository)
	
  
*10. (Optional) You may also Download the Ambari tarball file locally and build the images using that:
For this, go to the Server desginated for LocalRepository and run -

# cd /var/www/html/repo ; nohup wget http://public-repo-1.hortonworks.com/ambari/centos6/2.x/updates/2.2.2.0/ambari-2.2.2.0-centos6.tar.gz &

Extract the file once the Download is finished (monitor nohup.out file for the progress)
	# tar -xf ambari-2.2.2.0-centos6.tar.gz
	
	And use the localrepo location to build the Ambari images locally:
	# source /etc/docker-hdp-lab.conf
	# nohup build_image.sh 2.2.2.0 http://$LOCAL_REPO_NODE/AMBARI-2.2.2.0/centos6/2.2.2.0-460/  &

*11. On the LocalRepository server, download and prepare Local HDP Repository for all the required versions  
  
	# localize_hdp.sh add <HDP_VERSION> <HDP Tarball URL>
	Example::  
	# nohup localize_hdp.sh 2.4.2.0 http://public-repo-1.hortonworks.com/HDP/centos6/2.x/updates/2.4.2.0/HDP-2.4.2.0-centos6-rpm.tar.gz > /tmp/hdp_2420.out 2>&1 &
	(And then monitor the file: /tmp/hdp_2420.out for progress)  
  
  
*12. Edit cluster.props file and create your first cluster:

# mkdir ~/<username>
	# cp cluster.props  ~/<username>/  ;  cd  ~/<username>  -- And edit the file
	# create_cluster.sh cluster.props
To make the deployment faster, use only local HDP repositories and specify their location inside "cluster.props" file
  
  
*13. To see the list of Nodes & their IPs in your cluster run either of the below commands:

# show_cluster.sh all

Or

# show_cluster.sh <username>  
	
  	
*14. Add route on your laptop/desktop to reach the Instance IPs directly, so that UIs such as Ambari or RM/NN UI can be opened in the local browser

Example: # route add -net 10.0.5.0/24 $SWARM_MANAGER_IP  
	Or 
	Use ssh tunnels:   ssh -L 8080:10.0.5.5:8080 $SWARM_MANAGER_IP  
	& use the broswer to open Ambari UI at http://127.0.0.1:8080
  
  
*15. Start using the scripts such as "start_cluster", "stop_cluster", "delete_cluster" and others to manage HDP clusters.  
  
Instructions on How to Manage HDP Clusters inside the Docker-HDP-Lab Cluster is given at: https://github.com/rmaruthiyodan/docker-hdp-lab/wiki/Managing-HDP-Clusters-in-the-docker-hdp-lab-Cluster

---------

#####	Happy HDP'ing \o/

Tip:  Create an ssh alias as follows, in order to avoid repeatedly updating HostKeys in known_hosts file and the warnings:

alias ssh='ssh -o CheckHostIP=no -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no'

docker-hdp-lab

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README