Disk image elements for deployment images of OpenStack
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
OpenStack Release Bot a7cd393e03 Update master for stable/stein
Add file to the reno documentation build to show release notes for

Use pbr instruction to increment the minor version number
automatically so that master versions are higher than the versions on

Change-Id: I9a268798f4c8722fc08be32a1430d086f9ff87c2
Sem-Ver: feature
4 years ago
doc/source Switch from oslosphinx to openstackdocstheme 6 years ago
elements Replace openstack.org git:// URLs with https:// 4 years ago
releasenotes Update master for stable/stein 4 years ago
tests Fix unit tests in python3 5 years ago
tools Remove unused tox_install.sh 6 years ago
zuul.d [Configuration] Add missing py37 and corrected default envlist. 5 years ago
.gitignore Add reno support 6 years ago
.gitreview Update stackforge references to openstack 10 years ago
.testr.conf Add a .testr.conf configuration and ignore .testrepository. 11 years ago
HACKING.rst Optimizing the safety of the http link site in HACKING.rst 5 years ago
LICENSE Fix copyrights for HP work. 11 years ago
MANIFEST.in Package with pbr 10 years ago
README.md Merge "Add release note link in README" 5 years ago
babel.cfg Make it possible for openstack-CI to run tests 10 years ago
requirements.txt Update pbr version to match global requirements 8 years ago
run-flake8 PEP8 on the doc and elements files 9 years ago
setup.cfg Change openstack-dev to openstack-discuss 5 years ago
setup.py Align build files and requirements 10 years ago
test-requirements.txt Update hacking version 4 years ago
tox.ini Merge "[Configuration] Add missing py37 and corrected default envlist." 4 years ago


Team and repository tags

Team and repository tags

Image building rules for OpenStack images

These elements are used to build disk images for deploying OpenStack via Heat. They are built as part of the TripleO (https://wiki.openstack.org/wiki/TripleO) umbrella project.


Checkout this source tree and also the diskimage builder, export an ELEMENTS_PATH to add elements from this tree, and build any disk images you need:

virtualenv .
source bin/activate
pip install dib-utils pyyaml
git clone https://git.openstack.org/openstack/diskimage-builder.git
git clone https://git.openstack.org/openstack/tripleo-image-elements.git
export ELEMENTS_PATH=tripleo-image-elements/elements
diskimage-builder/bin/disk-image-create -u base vm bootstrap local-config stackuser heat-cfntools -a i386 -o bootstrap

Common element combinations

Always include heat-cfntools in images that you intend to boot via heat : if that is not done, then the user ssh keys are not reliably pulled down from the metadata server due to interactions with cloud-init.


OpenStack images are intended to be deployed and maintained using Nova + Heat.

As such they should strive to be stateless, maintained entirely via automation.


In a running OpenStack there are several categories of config.

  • per user - e.g. ssh key registration with nova: we repeat this sort of config every time we add a user.
  • local node - e.g. nova.conf or ovs-vsctl add-br br-ex : settings that apply individually to machines
  • inter-node - e.g. credentials on rabbitmq for a given nova compute node
  • application state - e.g. 'neutron net-create ...' : settings that apply to the whole cluster not on a per-user / per-tenant basis

We have five places we can do configuration in TripleO:

  • image build time
  • in-instance heat-driven (ORC scripts)
  • from outside via APIs
  • orchestrated by Heat

Our current heuristic for deciding where to do any particular configuration step:

  • per user config should be done from the outside via APIs, even for users like 'admin' that we know we'll have. Note that service accounts are different - they are a form of inter-node configuration.
  • local node configuration should be done via ORC driven by Heat and/or configuration management system metadata.
  • inter-node configuration should be done by working through Heat. For instance, creating a rabbit account for a nova compute node is something that Heat should arrange, though the act of creating is probably done by a script on the rabbit server - triggered by Heat - and applying the config is done on the compute node by the local node script - again triggered by Heat.
  • application state changes should be done from outside via APIs


Copyright 2012,2013 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.

Release notes for the project can be found at: https://docs.openstack.org/releasenotes/tripleo-image-elements