5184d02a7c
If the image has an ext filesystem and the zerofree utility is present on the build system then run zerofree. This should make images as compressable as possible which is a nice feature when building compressed qcow2 images. Change-Id: Ia6062c291f7a3f58b85a4f408ecb3d0574c65d53
62 lines
1.8 KiB
ReStructuredText
62 lines
1.8 KiB
ReStructuredText
Installation
|
|
============
|
|
|
|
Diskimage-builder can either be run directly out of the source repository or
|
|
installed via pip. If you plan on doing development on diskimage-builder or
|
|
the elements then we recommend you run the tool out of the source repository
|
|
as this installation requires minimal extra effort and does not require an
|
|
extra install step for your changes to take effect.
|
|
|
|
Once installed, you will be able to :doc:`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.
|
|
|
|
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.
|
|
|
|
If the zerofree utility is present on the build system and you are building
|
|
an image with an ext filesystem zerofree will be used to zero out free
|
|
blocks in the image. This makes the resulting images much smaller if
|
|
compressed.
|
|
|
|
|
|
Source Installation
|
|
-------------------
|
|
|
|
Clone the diskimage-builder and dib-utils repositories locally:
|
|
|
|
::
|
|
|
|
git clone https://git.openstack.org/openstack/diskimage-builder
|
|
git clone https://git.openstack.org/openstack/dib-utils
|
|
|
|
|
|
Add the bin dirs to your path:
|
|
|
|
::
|
|
|
|
export PATH=$PATH:$(pwd)/diskimage-builder/bin:$(pwd)/dib-utils/bin
|
|
|
|
|
|
Pip Installation
|
|
----------------
|
|
|
|
Installing via pip is as simple as:
|
|
|
|
::
|
|
|
|
pip install diskimage-builder
|
|
|