project-config/nodepool/elements
Alfredo Moralejo e17d562000 Revert "Use virtualenv --seeder=pip so that libs are accessible"
--seeder=pip is breaking images where pip is not installed from source.

New virtualenv upstream release 20.0.2 has fixed the issue seen when
using sudo [1] by copying instead of symlinking and does not need this
fix anymore.

[1] f4fd6a0991

This reverts commit be9530ae16.

Change-Id: I799982d9c023141cf612901084d4ecbd4447e969
2020-02-12 09:42:54 +00:00
..
cache-devstack Cache dstast_graph on nodepool images 2019-07-02 07:32:11 -07:00
control-plane-minimal Build ubuntu bionic minimal images for control plane 2019-05-21 12:49:25 -05:00
infra-package-needs Revert "Use virtualenv --seeder=pip so that libs are accessible" 2020-02-12 09:42:54 +00:00
initialize-urandom Fix flake8 2017-10-21 18:37:10 +02:00
nodepool-base Revert "Use virtualenv --seeder=pip so that libs are accessible" 2020-02-12 09:42:54 +00:00
openstack-repos Cache repos in /opt/git/opendev.org 2019-09-18 09:09:09 -07:00
zuul-worker zuul-worker: no selinux python2 libs on CentOS 8 2019-10-09 03:07:05 +00:00
README.rst Update doc to have 'debootstrap' dep and describe minimal 2016-10-12 19:27:05 -07:00
bindep-fallback.txt Remove references to OpenSUSE 423 2019-10-14 09:14:08 -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.