Merge "Update install docs to be more user friendly"

This commit is contained in:
Jenkins 2015-05-19 22:31:19 +00:00 committed by Gerrit Code Review
commit 2835199ace

View File

@ -1,24 +1,69 @@
Installation Installation
============ ============
Diskimage-builder is run directly out of the source repository. 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 `build images <building_an_image>` using
disk-image-create and the elements included in the main diskimage-builder
repository.
Requirements Requirements
------------ ------------
If you have 4GB of available physical RAM (As reported by Most image formats require the qemu-img tool which is provided by the
/proc/meminfo MemTotal), or more, diskimage-builder will create a tmpfs mount qemu-utils package on Ubuntu/Debian or the qemu package on
to build the image in. This will improve image build time by building in RAM. Fedora/RHEL/opensuse.
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.
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
Speedups
--------
If you have 4GB of available physical RAM (As reported by /proc/meminfo
MemTotal), or more, diskimage-builder will create a tmpfs mount to build the
image in. This will improve image build time by building in RAM.
This can be disabled completely by passing --no-tmpfs to disk-image-create. This can be disabled completely by passing --no-tmpfs to disk-image-create.
ramdisk-image-create builds a regular image and then within that does ramdisk ramdisk-image-create builds a regular image and then within that does ramdisk
creation. If tmpfs is not used, you will need enough room in /tmp to store two creation. If tmpfs is not used, you will need enough room in /tmp to store two
uncompressed cloud images. If you do have tmpfs, you will still need /tmp space uncompressed cloud images. If you do have tmpfs, you will still need /tmp space
for one uncompressed cloud image and about 20% of that for working files. for one uncompressed cloud image and about 20% of that for working files.
Installation
------------
* Clone the repository locally, then add bin to your path.
* Make sure you have qemu-img (qemu-utils package on Ubuntu/Debian,
qemu on Fedora/RHEL/openSUSE) and kpartx installed.