murano/doc/source/image_builders/linux.rst
Shilla Saebi 98b6030332 cleanup murano docs in the image_builders folder
standart to standard
clean up capitalizations that are unnecessary
harware to hardware
added transition words “the” “a” where needed
avaible changed to available
emtpy should be empty
unatteded should be unattended
Manualy should be manually
Performes should be performs
scrtips should be scripts
changed docs to comply with doc conventions
https://wiki.openstack.org/wiki/Documentation/Conventions

Change-Id: I5324053f4eed28a3f7b37b5fe2b334e7d374ad13
2015-05-28 16:41:37 -04:00

2.3 KiB

Linux Image

At the moment the best way to build a Linux image with the 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 git://git.openstack.org/cgit/openstack/murano
$ git clone git://git.openstack.org/cgit/openstack/murano-agent
$ git clone git://git.openstack.org/cgit/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 the murano agent:

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

If you need a 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 you are done upload the murano-agent.qcow2 image to glance and play :)