Developer Documentation

This documentation explains how to get started with creating your own disk-image-builder elements as well as some high level concepts for element creation.

Quickstart

To get started developing with diskimage-builder, install to a virtualenv:

$ mkdir dib
$ cd dib
$ virtualenv env
$ source env/bin/activate
$ git clone https://git.openstack.org/openstack/diskimage-builder
$ cd diskimage-builder
$ pip install -e .

You can now simply use disk-image-create to start building images and testing your changes. When you are done editing, use git review to submit changes to the upstream gerrit.

• Design
• Components
• Invocation
• Caches and offline mode
  • Base images
  • source-repositories
  • C and C++ compilation
  • PyPI
• Developing Elements
  • Phase Subdirectories
  • Other Subdirectories
  • Environment Variables
  • Dependencies
  • Operating system elements
  • Ramdisk Elements
  • Element coding standard
• dib-lint
• Stable Interfaces