deb-murano/doc/source/image_builders/linux.rst
Tetiana Lashchova 5bb2782718 [Docs] Install diskimage-builder by pip
Change-Id: I1191f4e4e09a8f481996480922778b2464ac9bd5
Closes-Bug: #1578991
2016-05-12 20:00:57 +03:00

80 lines
2.0 KiB
ReStructuredText

..
Copyright 2014 Mirantis, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this file except in compliance with the License. You may obtain
a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.
===========
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:
.. code-block:: console
export GITDIR=~/git
mkdir -p $GITDIR
Clone the components required to build an image to that directory:
.. code-block:: console
cd $GITDIR
git clone git://git.openstack.org/openstack/murano
git clone git://git.openstack.org/openstack/murano-agent
Install diskimage-builder
.. code-block:: console
sudo pip install diskimage-builder
Install additional packages required by disk image builder:
.. code-block:: console
sudo apt-get install qemu-utils curl python-tox
Export paths where additional dib elements are located:
.. code-block:: console
export ELEMENTS_PATH=$GITDIR/murano/contrib/elements:$GITDIR/murano-agent/contrib/elements
Build Ubuntu-based image with the murano agent:
.. code-block:: console
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 :)