project-config/nodepool/elements
Clark Boylan 53cd995cf6 Add element to handle generic package installs
We end up needing to install a fair bit of stuff on top of the minimal
images in order to make them useable. Do this in a generic infra package
needs element that can grow to accomodate our needs.

For the future we can hopefully get some of this into dib itself so that
others can easily build instances they can ssh into.

Change-Id: I5826df829971e182cd0713b29df1cf70c119a0ab
2016-03-17 12:26:58 -07:00
..
cache-bindep Fix typo with $YUM variable 2016-03-07 13:11:10 -05:00
cache-devstack Cleanup the early devstack clone script 2016-01-19 11:11:28 +11:00
infra-package-needs Add element to handle generic package installs 2016-03-17 12:26:58 -07:00
node-devstack Add element to handle generic package installs 2016-03-17 12:26:58 -07:00
nodepool-base Add a dib-builddate file 2016-03-01 15:16:15 +11:00
openstack-repos Don't cache inactive repos 2016-03-05 18:01:08 -08:00
puppet Add curl package to puppet nodepool element 2016-03-16 16:18:30 +03:00
slave-db Reorganizes project-config 2014-09-25 11:41:04 -04:00
README.rst Determine CentOS 6 platform in cache-devstack 2015-05-01 20:57:05 +00:00

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

Install diskimage-builder:

sudo -H pip install diskimage-builder

Build an image

Building an image is simple, we have a script!

DISTRO="ubuntu" bash tools/build-image.sh

See the script for environment variables to set distribution, etc. You should be left with a .qcow2 image file of your selected distribution.

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.