openstack/diskimage-builder
Code Issues Proposed changes
91e3b72a23
diskimage-builder/doc/source/user_guide/installation.rst
Yolanda Robla 1492d1c55f Add kpartx as a requirement to build images 
Testing on a ubuntu cloud image, the build is not possible
because it is missing the kpartx dependency. Adding that
as a requirement, when producing images with partitions.

Change-Id: I0c8f39b5233dd450d8130735ed801bbed6bca0e9
2017-08-11 15:16:13 +02:00

1.4 KiB
Raw Blame History

Installation

If your distribution does not proivde packages, you should install diskimage-builder via pip, mostly likely in a virtualenv to keep it separate.

For example, to create a virtualenv and install from pip

virtualenv ~/dib-virtualenv
. ~/dib-virtualenv/bin/activate
pip install diskimage-builder

Once installed, you will be able to build images <building_an_image> using disk-image-create and the elements included in the main diskimage-builder repository.

Requirements

Most image formats require the qemu-img tool which is provided by the qemu-utils package on Ubuntu/Debian or the qemu package on Fedora/RHEL/opensuse/Gentoo.

When generating images with partitions, the kpartx tool is needed, which is provided by the kpartx package.

Some image formats, such as VHD, may require additional tools. Please see the disk-image-create help output for more information.

Individual elements can also have additional dependencies for the build host. It is recommended you check the documentation for each element you are using to determine if there are any additional dependencies. Of particular note is the need for the dev-python/pyyaml package on Gentoo hosts.

Package Installation

On Gentoo you can emerge diskimage-builder directly.

emerge app-emulation/diskimage-builder