cloud
/
cloudbuild
3
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
An automated VM template builder for the CSC cloud
24 Commits 1 Branch 0 Tags 351 KiB
Go 92.7%
Shell 5.6%
Makefile 1.7%
Go to file
Max Erenberg dac1b10c5d fix bug in check for rolling release distros 2023-01-07 22:05:42 -05:00
pkg fix bug in check for rolling release distros 2023-01-07 22:05:42 -05:00
scripts add create-libguestfs-module.sh 2022-06-25 12:51:49 -04:00
.gitignore first commit 2022-06-21 02:36:42 -04:00
Makefile add some perf optimizations for Fedora 2022-11-02 00:58:49 +00:00
README.md update SSH_KEY_PATH documentation in README 2022-11-19 06:57:50 +00:00
go.mod first commit 2022-06-21 02:36:42 -04:00
go.sum first commit 2022-06-21 02:36:42 -04:00
main.go verify VMs and delete old templates 2022-07-16 18:30:36 -04:00

README.md

cloudbuild

cloudbuild downloads, modifies and uploads VM templates for the CSC cloud (CloudStack) using publicly available images for common Linux distros.

Installing dependencies

Run the following in a Debian Docker/Podman container.

apt install golang-guestfs-dev
scripts/create-libguestfs-module.sh

Optional dependencies

If you are developing cloudbuild, you may wish to install guestfish, an interactive shell for guestfs:

apt install libguestfs-tools

To run:

make guestfish

><fs> add /path/to/your/template.img
><fs> run
><fs> inspect-os
><fs> # use the output from inspect-os to find the root partition
><fs> mount /dev/sda4 /

Creating the appliance

Next you need an appliance, which is a kernel + initrd + rootfs used by the VM created by guestfs. You have two options:

  1. Download an appliance: 
    make appliance-download

OR

  1. Create an appliance using the host's kernel: 
    make supermin-download
make appliance

Building the program

make

Running the program

Make sure the following environment variables are set:

# these values must be obtained from the CloudStack web UI
export CLOUDSTACK_API_KEY=secret
export CLOUDSTACK_SECRET_KEY=secret
# set these to the distros for which cloudbuild will create templates
export DISTROS_TO_CHECK=ubuntu,fedora
# the modified templates will be temporarily moved here so that CloudStack
# can download them
export UPLOAD_DIRECTORY=/var/www/csc-cloud-images
# the modified templates (in the UPLOAD_DIRECTORY) must be downloadable
# from this base URL
export UPLOAD_BASE_URL=http://biloba.csclub.uwaterloo.ca/csc-cloud-images
# notification emails will be sent here
export EMAIL_RECIPIENT=root@csclub.uwaterloo.ca
# path of SSH key used to SSH into VMs created in CloudStack
export SSH_KEY_PATH=~/.ssh/id_rsa_cloudstack

Finally:

make run