## Developer Guide

updated: 2018-03-01 11:27

# Developer Guide

- Design
- Components
- Developer Installation
- 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.

## Python module documentation

For internal documentation on the DIB python components, see the Module Index

## 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>

updated: 2018-03-01 11:27

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug questions?