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,
|
2019-06-18 15:25:49 +00:00
|
|
|
both virtual and bare metal. Images are composed using `elements`;
|
2015-08-28 01:48:58 +00:00
|
|
|
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
|
|
|
|
2020-04-22 23:55:19 +00:00
|
|
|
$ DIB_RELEASE=bionic disk-image-create -o ubuntu-bionic.qcow2 vm ubuntu
|
2015-08-28 01:48:58 +00:00
|
|
|
|
|
|
|
will create a bootable Ubuntu Trusty based ``qcow2`` image.
|
|
|
|
|
|
|
|
``diskimage-builder`` is useful to anyone looking to produce
|
2019-06-18 15:25:49 +00:00
|
|
|
customised images for deployment into clouds. These tools are the
|
2015-08-28 01:48:58 +00:00
|
|
|
components of `TripleO <https://wiki.openstack.org/wiki/TripleO>`__
|
2019-06-18 15:25:49 +00:00
|
|
|
that are responsible for building disk images. They are also used
|
2015-08-28 01:48:58 +00:00
|
|
|
extensively to build images for testing OpenStack itself, particularly
|
|
|
|
with `nodepool
|
2017-06-05 10:31:49 +00:00
|
|
|
<https://docs.openstack.org/infra/system-config/nodepool.html>`__.
|
2015-08-28 01:48:58 +00:00
|
|
|
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
|
|
|
|
2017-07-14 05:51:23 +00:00
|
|
|
* https://docs.openstack.org/diskimage-builder/latest/
|
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.
|