Image building tools for OpenStack
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
OpenDev Sysadmins 0be0a827f7 OpenDev Migration Patch 5 days ago
.zuul.d Use template for lower-constraints 4 months ago
bin Check source-repository-* files for trailing newline 1 year ago
contrib Native zuulv3 tests 5 months ago
diskimage_builder Merge "Fix Fedora aarch64 image location" 6 days ago
doc Update to Fedora 29 5 months ago
playbooks/dib-functests Remove legacy playbooks 5 months ago
releasenotes Merge "simple-init: allow for NetworkManager support" 3 months ago
roles OpenDev Migration Patch 5 days ago
tests Capture ramdisk test run logs 4 months ago
.gitignore Import legacy playbooks 1 year ago
.gitreview OpenDev Migration Patch 5 days ago
.testr.conf package-installs: provide for skip from env var 4 months ago
LICENSE Fix copyrights for HP work. 6 years ago
README.rst Update the documentation link for doc migration 1 year ago
babel.cfg Make it possible for openstack-CI to run tests 6 years ago
bindep.txt Add python3-setuptools to bindep.txt for Fedora 3 months ago
lower-constraints.txt add lower-constraints job 1 year ago
pylint.cfg Refactor: use lazy logging 1 year ago
requirements.txt Constraint networkx to <2.3 for Python 2 1 week ago
setup.cfg [Core] Change openstack-dev to openstack-discuss. 3 months ago Updated from global requirements 2 years ago
test-requirements.txt Only cap pylint for python2 4 months ago
tox.ini [Configuration] Add missing py37 and corrected default envlist. 3 months ago


Image building tools for OpenStack

diskimage-builder is a flexible suite of components for building a wide-range of disk images, filesystem images and ramdisk images for use with OpenStack.

This repository has the core functionality for building such images, both virtual and bare metal. Images are composed using elements; while fundamental elements are provided here, individual projects have the flexibility to customise the image build with their own elements.

For example:

$ DIB_RELEASE=trusty disk-image-create -o ubuntu-trusty.qcow2 vm ubuntu

will create a bootable Ubuntu Trusty based qcow2 image.

diskimage-builder is useful to anyone looking to produce customised images for deployment into clouds. These tools are the components of TripleO that are responsible for building disk images. They are also used extensively to build images for testing OpenStack itself, particularly with nodepool. Platforms supported include Ubuntu, CentOS, RHEL and Fedora.

Full documentation, the source of which is in doc/source/, is published at:


Copyright 2012 Hewlett-Packard Development Company, L.P. Copyright (c) 2012 NTT DOCOMO, INC.

All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.