History

Clark Boylan a126f3953f Make journald log collection persistent We have had some job runs overrun the journald ring buffer which is used by default resulting in losing older logs during the job runs. Update the journald configuration to persistently store the journal so that we can reliably retrieve those logs when jobs complete. Change-Id: I5626ce76878287be220a8803f9dfe9a9da950d5b		2017-01-03 09:39:06 -08:00
..
cache-bindep	Remove 50-cache-pkgs from cache-bindep	2016-11-29 15:41:37 -05:00
cache-devstack	Stop caching devstack packages	2016-12-14 09:44:13 -05:00
infra-package-needs	nodepool: elements: infra-package-needs: Use the openssh-server element	2016-11-16 11:56:54 +00:00
initialize-urandom	Fix typos in initialize-urandom.py & gerrit-git-prep.sh	2016-11-08 03:57:55 +00:00
nodepool-base	Make journald log collection persistent	2017-01-03 09:39:06 -08:00
openstack-repos	selective caching of git repos	2016-11-23 13:35:29 +02:00
prepare-node	Move prepare-node to it's own element	2016-05-19 21:38:11 -05:00
puppet	safe override of /etc/resolv.conf	2016-11-07 17:00:03 +02:00
stackviz	Disable npm for stackviz on fedora-24	2016-07-13 19:08:44 -04:00
zuul-worker	Add Gentoo support to nodepool	2016-10-16 20:37:14 -05: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.