project-config/nodepool/elements/README.rst
Clark Boylan 82e7504c36 Retire devstack-gate
This removes devstack-gate from the CI system and updates ACLS for the
repo in Gerrit to the openstack retired repo config. There are also
cleanups to nodepool elements and irc bots to remove references to
devstack-gate where we don't need them anymore.

Depends-On: https://review.opendev.org/c/openstack/governance/+/919629
Change-Id: I50ce4e5aa7001ba52bea78a65855278be68e61a5
2024-05-14 15:16:58 -07:00

75 lines
1.9 KiB
ReStructuredText

Using diskimage-builder to build opendev-ci nodes
====================================================
In addition to being able to just download and consume images that are the
same as what run devstack, 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/opendev-ci-node-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 opendev-ci-node-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.