This directory contains the scripts used to generate the Chameleon KVM and bare-metal Ubuntu images. It relies on diskimage-builder.
Install on Ubuntu or CentOS with install-reqs.sh
. It installs
- QEMU utilities
- pip
- disk-image-builder
The main script takes an output variant as a single input parameter:
python create-image.py <output_variant> [--release {trusty, xenial}]
For this image, the current supported variants are:
base
: General Ubuntu imagegpu
: includes CUDA 8 driver, only supported with 16.04 Xenial.- Needs to be built from another Ubuntu image with the same kernel as it grabs the kernel info to install headers, and also on a GPU node so the NVidia installer doesn't abort.
arm64
: Creates post-processed kernel and ramdisk, and bootscript for U-Boot- Can only be built on an ARM64 node, currently
The .py
script does some parameter parsing, configures then environment, then
exec
's the .sh
script. Calling the .sh
directly requires a few envvars
to be set
At the end of its execution, the script provides the Glance command that can be used to upload the image to an existing OpenStack infrastructure.
This script does the following:
- Download an Ubuntu cloud image from upstream
- Customize it for Chameleon (see
elements
directory for details) - Generate an image compatible with OpenStack KVM and bare-metal
The image must then be uploaded and registered with Glance (currently done manually, by running the Glance command given at the end of execution).
Cloned/run by Jenkins with https://github.com/ChameleonCloud/abracadabra
If the script is run by Abracadabra, it looks for the magic line "Image built in (path)", so don't change that (without changing the other).