kloudbuster/doc/source/development.rst
ahothan 8f892eaeeb Include VM image in contaimer
add script to build VM image and container, to extract VM image from container
update doc
remove version check with agent
update vm image upload
auto upload VM image from pkg root dir
show simplified version string

Change-Id: I9dc44c52656d81f271c91d6826dc0e128fed980d
2017-07-24 16:32:10 -07:00

1.7 KiB

Development

Building the KloudBuster VM and Docker images

This section describes how to rebuild:

  • the KloudButer VM Image from the git repository source code
  • the KloudBuster Docker image

A Linux server with python, git and qemu utilities installed is required.

Create a virtual environment (if not done already):

virtualenv vkb
source vkb/bin/activate

Ubuntu/Debian based:

sudo apt-get install python-dev git qemu-utils
pip install PyYAML

Redhat/Fedora/CentOS based:

sudo yum install python-devel git qemu-img
pip install PyYAML

Build the image with below commands:

# Clone the kloudbuster repository if you have not done so
git clone https://github.com/openstack/kloudbuster.git
cd kloudbuster
# Install kloudbuster
pip install -e .
# Run the build image script
$ ./kb_build.sh

After a few minutes, the qcow2 and container images will be built and available in the same directory. The qcow2 and container images will be named after the version (e.g. kloudbuster-7.0.0.qcow2 and berrypatch/kloudbuster:7.0.0).

Pushing the Docker container to DockerHub

The KloudBuster Docker images are published in the DockerHub berrypatch repository: https://hub.docker.com/r/berrypatch/kloudbuster/

To publish you need to be a member of the berrypatch kloudbuster team. After the login (requires your DockerHub username and password), push the appropriate version to berrypatch:

sudo docker login
sudo docker push berrypatch/kloudbuster:7.0.0