1a753bf200
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
84 lines
2.3 KiB
ReStructuredText
84 lines
2.3 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
|
|
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:
|
|
|
|
.. code-block:: console
|
|
|
|
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:
|
|
|
|
.. 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
|
|
|
|
|
|
And build Ubuntu-based image with the murano agent:
|
|
|
|
.. code-block:: console
|
|
|
|
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 :)
|