From 8b6a7c7371ff57d6996ebc90d5d42de8ddffcfe1 Mon Sep 17 00:00:00 2001
From: Xin <xiyu3@cisco.com>
Date: Wed, 20 Apr 2016 15:16:15 -0700
Subject: [PATCH] add Dockerfile

Change-Id: I1a157942ff7d04b428a623251708a9018294860a
---
 .dockerignore               |  3 +++
 Dockerfile                  | 15 +++++++++++++++
 doc/source/contributing.rst | 21 +++++++++++++++++++++
 3 files changed, 39 insertions(+)
 create mode 100644 .dockerignore
 create mode 100644 Dockerfile

diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000..6c894cf
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,3 @@
+.git
+.gitignore
+.gitreview
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..f9441c9
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,15 @@
+# docker file for creating a container that has kloudbuster installed and ready to use
+FROM ubuntu:14.04
+MAINTAINER kloudbuster-core <kloudbuster-core@lists.launchpad.net>
+
+# Install KloudBuster script and dependencies
+RUN apt-get update && apt-get install -y \
+       libyaml-dev \
+       python \
+       python-dev \
+       python-pip \
+       python-virtualenv \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN pip install pytz 
+RUN pip install kloudbuster
diff --git a/doc/source/contributing.rst b/doc/source/contributing.rst
index 1289628..f809c31 100644
--- a/doc/source/contributing.rst
+++ b/doc/source/contributing.rst
@@ -69,6 +69,27 @@ Bugs should be filed on Launchpad, not GitHub:
    https://bugs.launchpad.net/kloudbuster
 
 
+Build KloudBuster Docker Image
+-----------------------
+
+Two files are used to build the Docker image: *Dockerfile* and *.dockerignore*. The former provides all the build instructions while the latter provides the list of files/directories that should not be copied to the Docker image.
+
+In order to make the Docker image clean, remove all auto generated files from the root of your workspace first. Specify the image name and the tag, and feed them to docker build. Examples to build the image with name "$USER/koudbuster", tag "latest"::
+
+$ cd <koudbuster-ws-root>
+$ sudo docker build --tag=$USER/koudbuster:latest .
+
+The images should be available for use::
+
+$ sudo docker images
+REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
+xiyu3/kloudbuster   latest              0f17ae788c69        8 minutes ago       443.1 MB
+
+For exchanging purposes, the image could be saved to a tar archive. You can distribute the KloudBuster Docker image among your servers easily with this feature::
+
+$ sudo docker save -o <IMAGE_FILE> <IMAGE_ID>
+
+
 .. _developer_guide_of_openstack:
 
 Developer's Guide of OpenStack