murano/doc/source/image_builders/linux.rst
Dmitry Teselkin 363db312ee Update Image Builder documentation
Update formatting.
Fix multiple inconsistiences.
Rewrite some chapters.

Change-Id: Idda8f2849f966617f3c5d3ea9e2dec2da4850ef3
2015-03-26 20:10:42 +03:00

2.3 KiB

Linux Image

At the moment the best way to build a Linux image with Murano agent is to use disk image builder.

Note

Disk image builder requires sudo rights

The process is quite simple. Let's assume that you use a directory ~/git for cloning git repositories:

$ export GITDIR=~/git
$ mkdir -p $GITDIR

Clone the components required to build an image to that directory:

$ cd $GITDIR
$ git clone https://github.com/stackforge/murano
$ git clone https://github.com/stachforge/murano-agent
$ git clone https://github.com/openstack/diskimage-builder

Checkout a change request that allows to build an image using disk image builder completely installed to virtual environment:

$ cd $GITDIR/diskimage-builder
$ git fetch https://review.openstack.org/openstack/diskimage-builder refs/changes/02/168002/2 && git checkout FETCH_HEAD

Install additional packages required by disk image builder:

$ sudo apt-get install qemu-utils curl python-tox

Export paths where additional dib elements are located:

$ export ELEMENTS_PATH=$GITDIR/murano/contrib/elements:$GITDIR/murano-agent/contrib/elements

And build Ubuntu-based image with Murano agent:

$ cd $GITDIR/diskimage-builder
$ tox -e venv -- disk-image-create vm ubuntu murano-agent -o ../murano-agent.qcow2

If you need Fedora based image replace 'ubuntu' to 'fedora' in the last command.

It'll take a while (up to 30 minutes if your hard drive and internet connection are slow).

When done upload murano-agent.qcow2 image to Glance and play :)