Developer Guide

• Design
• Components
• Invocation
• Caches and offline mode
• Developing Elements
• dib-lint
• Stable Interfaces

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.

Finding Work

We maintain a list of low-hanging-fruit tags on launchpad:

• https://bugs.launchpad.net/diskimage-builder/+bugs?field.tag=low-hanging-fruit <https://bugs.launchpad.net/diskimage-builder/+bugs?field.tag=low-hanging-fruit>