History

Paul Belanger 9deb72e02e Remove git-review from DIB elements Looking at the git history for git-review, it isn't clear where we are actually using it. Additionally, codesearch.o.o seems to show some projects already managing git-review as a requirement. Ensure everybody is okay with this change by sending a ML post too. Change-Id: I53a45736de74b842c5c01982bb153f04bff5622c Signed-off-by: Paul Belanger <pabelanger@redhat.com>		2017-05-29 08:40:17 -04:00
..
cache-devstack	Remove 99-cache-testrepository-db from cache-devstack element	2017-05-25 11:45:17 -04:00
infra-package-needs	Remove git-review from DIB elements	2017-05-29 08:40:17 -04:00
initialize-urandom	Fix typos in initialize-urandom.py & gerrit-git-prep.sh	2016-11-08 03:57:55 +00:00
jenkins-slave	Let the jenkins user own the cache files	2017-04-29 01:39:15 +02:00
nodepool-base	Allow nova servers to reach heat services on port 80	2017-05-24 23:44:55 +05:30
openstack-repos	Python3 support for cache-devstack/openstack-repos	2017-05-17 15:22:34 +10:00
prepare-node	Stop installing and running puppet in node builds	2017-04-27 23:23:32 +02:00
stackviz	Remove .npm cache from stackviz element	2017-05-25 11:16:27 -04:00
zuul-worker	Always add zuul group to zuul user	2017-04-28 10:14:59 +02:00
README.rst	Update doc to have 'debootstrap' dep and describe minimal	2016-10-12 19:27:05 -07:00

README.rst

Using diskimage-builder to build devstack-gate nodes

In addition to being able to just download and consume images that are the same as what run devstack-gate, it's easy to make your own for local dev or testing - or just for fun.

Install diskimage-builder

Install the dependencies:

sudo apt-get install kpartx qemu-utils curl python-yaml debootstrap

Install diskimage-builder:

sudo -H pip install diskimage-builder

Build an image

Building an image is simple, we have a script!

bash tools/build-image.sh

See the script for environment variables to set distribution, etc. By default it builds an ubuntu-minimal based image. You should be left with a .qcow2 image file of your selected distribution.

Infra uses the -minimal build type for building Ubuntu/CentOS/Fedora. For example: ubuntu-minimal.

It is a good idea to set TMP_DIR to somewhere with plenty of space to avoid the disappointment of a full-disk mid-way through the script run.

While testing, consider exporting DIB_OFFLINE=true, to skip updating the cache.

Mounting the image

If you would like to examine the contents of the image, you can mount it on a loopback device using qemu-nbd.

sudo apt-get install qemu-utils
sudo modprobe nbd max_part=16
sudo mkdir -p /tmp/newimage
sudo qemu-nbd -c /dev/nbd1 /path/to/devstack-gate-precise.qcow2
sudo mount /dev/nbd1p1 /tmp/newimage

or use the scripts

sudo apt-get install qemu-utils
sudo modprobe nbd max_part=16
sudo tools/mount-image.sh devstack-gate-precise.qcow2
sudo tools/umount-image.sh

Other things

It's a qcow2 image, so you can do tons of things with it. You can upload it to glance, you can boot it using kvm, and you can even copy it to a cloud server, replace the contents of the server with it and kexec the new kernel.