Builder of CZERTAINLY Appliance, if you are not interested in development you should just download the published Appliance image. This repository is meant for developers.
- a Debian based Linux system with root access - tested on GNU Debian/Linux 11 (Bullseye). Root access is needed for
debbootstrap, mounting qemu disk format, formatting disk image - most of the task is run as root. gitfor cloning this repo- VirtualBox 7.0 (6.0 version doesn't have
--delete-alloption otherwise script should run) qemu-imgandqemu-nbdfromqemu-utils, complete Qemu installation isn't neededdebootstrapdosfstoolsfor creating FAT partition with EFI stuff
In short:
apt install git virtualbox qemu-utils debbootstrap dosfstools
git clone https://github.com/3KeyCompany/CZERTAINLY-Appliance.git
cd CZERTAINLY-Appliance
sudo ./build-appliance
Building requires root permisions as it creates QUEMU virtual disk device.
Finished appliance is exported into file tmp/czertainly-appliance-$APPLIANCEVERSION."%g%m%d.%H%M%S.ova. The process takes about 7 minutes on i7-6700 CPU @ 3.40GHz.
The appliance comes with a preconfigured Debian system. You need to initialize rke2 cluster and install CZERTAINLY. Please follow the instructions from the official documentation.
By default Appliance builder uses parameters from vars/develop you can make your modifications to that file and pass it as the first argument of the builder, for example:
sudo BUILD_PARAMS=vars/local bash ./build-appliance
Playbook for CZERTAINLY installation depends on the following Ansible roles:
- ansible-role-czertainly-branding
- ansible-role-http-proxy
- ansible-role-postgres
- ansible-role-helm
- ansible-role-rke2
- ansible-role-czertainly
they are provided by package czertainly-appliance-tools, without any git tracking information. If you need to work on any of them, the best option is to clone a repository of the role you need to work on into the right place under /etc/czertainly-ansible/roles.
If you want to run Ansible playbooks by hand don't forget to set ANSIBLE_CONFIG to the right values. Typically you can run the installation command from the menu of Text UI.
All Ansible roles have tags. You can run only parts you need to re-run to save your time. For example, when you want just reinstall czeratinly you can do:
kubectl delete ns czertainly
ANSIBLE_CONFIG=/etc/czertainly-ansible/ansible.cfg ansible-playbook /etc/czertainly-ansible/playbooks/czertainly.yml --tags czertainly --skip-tags czertainly_sleep10
- VirtualBox 6.1
- VirtualBox 7.0.4 / working environment
- VMPlayer 16.2.4
- VMPlayer 17.0.0
Originally was the appliance builder based on preseed.cfg file which official way for customizing Debian installation. It is documented, but can be sometimes quite tricky to get it working correctly. The main problem with this approach was that it required VT-x instructions, for full virtualization. That is not available in Ubuntu based GitHub runners. With some modifications, it was possible to run it on MacOS based runners, but the building process was taking too long and often was terminated by GitHub after 6 hours. Those modifications for MacOS were replace genisoimage=>mkisofs and isohybrid=>mkhybrid which are luckyily dropin replacements.
The actual way of building the appliance is heavily based on the blog post Building Debian VMs with debootstrap. This way of building the appliance is much faster and it runs even on Ubuntu runners on GitHub.