openstack/deb-murano
Code Issues Proposed changes
f0a26f3abf
deb-murano/doc/source/image_builders/linux.rst
Kirill Zaitsev 1a753bf200 Make commands in install manual copy-paste-able 
Before commands in manual.rst and related files started with $ sign.
While this shows, that commands should be executed in shell it also
makes them hard to copy-paste.

This change removes $ and splits commands, that include ';' into
multiple lines. After this change user would be able to copy-paste whole
blocks of code into shell and execute them right away.

Removes `#` that meant that root privileges are required for the
command and adds sudo, where relevant (yum/apt, etc.).
Fixes occasional indentation inconsistencies.

Change-Id: Ib649ae2a3a110bdf09b0bf9c5fbf54a5ce40ccc6
2015-08-25 19:53:16 +00:00

2.3 KiB
Raw Blame History

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/openstack/murano
git clone git://git.openstack.org/openstack/murano-agent
git clone git://git.openstack.org/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 :)