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 + +# 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 +$ 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 + + .. _developer_guide_of_openstack: Developer's Guide of OpenStack