2014-02-12 08:20:37 +00:00
|
|
|
Image building tools for OpenStack
|
2012-11-09 11:04:13 +00:00
|
|
|
==================================
|
|
|
|
|
2015-08-28 01:48:58 +00:00
|
|
|
``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.
|
2013-04-05 02:27:18 +00:00
|
|
|
|
2015-08-28 01:48:58 +00:00
|
|
|
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.
|
2013-04-05 02:27:18 +00:00
|
|
|
|
2015-08-28 01:48:58 +00:00
|
|
|
For example::
|
2012-11-09 11:04:13 +00:00
|
|
|
|
2015-08-28 01:48:58 +00:00
|
|
|
$ 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 <https://wiki.openstack.org/wiki/TripleO>`__
|
|
|
|
that are responsible for building disk images. They are also used
|
|
|
|
extensively to build images for testing OpenStack itself, particularly
|
|
|
|
with `nodepool
|
|
|
|
<http://docs.openstack.org/infra/system-config/nodepool.html>`__.
|
|
|
|
Platforms supported include Ubuntu, CentOS, RHEL and Fedora.
|
|
|
|
|
|
|
|
Full documentation, the source of which is in ``doc/source/``, is
|
|
|
|
published at:
|
2012-11-09 11:04:13 +00:00
|
|
|
|
2015-06-18 09:24:13 +00:00
|
|
|
* http://docs.openstack.org/developer/diskimage-builder/
|
2012-11-09 11:04:13 +00:00
|
|
|
|
2012-11-15 03:20:32 +00:00
|
|
|
Copyright
|
|
|
|
=========
|
|
|
|
|
|
|
|
Copyright 2012 Hewlett-Packard Development Company, L.P.
|
2014-10-09 09:54:19 +00:00
|
|
|
Copyright (c) 2012 NTT DOCOMO, INC.
|
2012-11-15 03:20:32 +00:00
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
|
|
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.
|