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 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/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:
|
|
|
|
.. 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 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 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 :)
|