Docker image for Apache Eagle https://hub.docker.com/r/apacheeagle/sandbox
This is docker container for eagle to help users to have a quick preview about eagle features. And this project is to build apache/eagle images and provide eagle-functions to start the containers of eagle.
The fastest way to get started with Eagle is to run with docker by one of following options:
Pull latest eagle docker image from docker hub directly:
docker pull apacheeagle/sandbox
Then run eagle docker image:
docker run -p 9099:9099 -p 8080:8080 -p 8744:8744 -p 2181:2181 -p 2888:2888 -p 6667:6667 -p 60020:60020 \ -p 60030:60030 -p 60010:60010 -d --dns 127.0.0.1 --entrypoint /usr/local/serf/bin/start-serf-agent.sh \ -e KEYCHAIN= --env EAGLE_SERVER_HOST=sandbox.eagle.incubator.apache.org --name sandbox \ -h sandbox.eagle.incubator.apache.org --privileged=true apacheeagle/sandbox:latest \ --tag ambari-server=true docker run -it --rm -e EXPECTED_HOST_COUNT=1 -e BLUEPRINT=hdp-singlenode-eagle --link sandbox:ambariserver\ --entrypoint /bin/sh apacheeagle/sandbox:latest -c /tmp/install-cluster.sh
Build eagle docker image from source code with eagle-docker:
git clone https://github.com/apache/incubator-eagle.git cd incubator-eagle && ./eagle-docker boot
Basic usage of the entry script of eagle-docker: bin/eagle-docker.sh
Usage: ./eagle-docker [options] [command] Apache Eagle Docker Image : apacheeagle/sandbox:latest Commands: build Build eagle docker image deploy Deploy eagle docker image start Start eagle docker instance stop Stop eagle docker instance status List eagle docker image and instance status clean Clean docker image and instance shell Execute docker instance bash, default: eagle-sandbox boot Simply bootstrap eagle docker by building then deploying Options: --node [num] Docker instances node number, default is 1 --help Display eagle docker image usage information
Build Image: Go to the root directory where the Dockerfile is in, build image with following command:
docker built -t apacheeagle/sandbox .
The docker image is named
apacheeagle/sandbox
. Eagle docker image is based onambari:1.7.0
, it will install ganglia, hbase,hive,storm,kafka and so on in this image. Add startup script and buleprint file into image.
Verify Image: After building the apacheeagle/sandbox
image successfully, verify the images and could find eagle image.
docker images
Deploy Image: This project also provides helper functions in script eagle-lib.sh for convenience.
# Firstly, load the helper functions into context source eagle-functions # Secondly, start to deploy eagle cluster # (1) start single-node container eagle-deploy-cluster 1 # (2) Or muti-node containers eagle-deploy-cluster 3
Find IP and Port Mapping: After the container is up and running. The first thing you need to do is finding the IP address and port mapping of the docker container:
docker inspect -f '{{ .NetworkSettings.IPAddress }}' eagle-server docker ps
Start to use Eagle: Congratulations! You are able to start using Eagle now. Please open eagle ui at following address (username: ADMIN, password: secret by default)
http://{{container_ip}}:9099/eagle-service
Manage Eagle Cluster: This step is about how to managing the eagle cluster though not must-have at starting. Eagle docker depends on Ambari to manage the cluster infrastructure of Eagle. Following are some helpful links:
http://{{container_ip}}:8080
(username: ADMIN, password: ADMIN)http://{{container_ip}}:8744
The fastest way to get response from eagle community is to send email to the mail list dev@eagle.incubator.apache.org, and remember to subscribe our mail list via dev-subscribe@eagle.incubator.apache.org
https://cwiki.apache.org/confluence/display/EAG/FAQ#FAQ-EagleDocker
Licensed under the Apache License, Version 2.0. More details, please refer to LICENSE file.