In order to support better local testing, Bazzite, Bluefin, and main now have several just commands that you can run while inside the git repo.
just build :
Will build the default container. Use the default just command to see what options this can take. In bluefin, it can take up to 3 arguments – Image (bluefin/aurora), Target (base or dx) and major version (gts/latest). In main this is image (silverblue/kinoite… etc) and version (gts or latest). Bazzite can take target (bazzite, bazzite-deck, and bazzite nvidia) and deskop gnome/kde/silverblue/kinoit. The image will be tagged with the current git branch.
just run:
Will run the specified container. This is transient and mostly for checking if things got placed into the right spot. Bluefin has a special Version of this that will “boot” the image. It is not recommended and more of a curiosity. The image is tagged with the current git branch.
just build-iso:
Will build an iso based on the selected container. For Bluefin and Bazzite, it will also download and configure the installer with flatpaks and their dependencies. Main does not do this.
just build-iso-git:
Will build an iso using the git version of the build-container-installer project instead of the current release version. This is helpful for testing how changes to the installer will affect our builds.
just run-iso:
Will spin up a VM with qemu (using a docker container) with the specified ISO that you have built. Connect to the VM by going to http://localhost:8006. This webserver is only exposed on your localhost. You can then install and play around with the VM. It is using noVNC. Modifier keys are not passed to the VM and you will need to use the on-screen keyboard if you need to press CTRL or ALT. On occasion it is necessary to force a reboot while booted by pressing the CTRL+ALT+Delete button 7 times in quick succession to tell systemd to reboot.
Additionally, there are several tasks for vscode configured. All of the ones listed are available plus Connect to VM which will open up VScodes’ built-in web-browser. You may have to hit refresh to connect to the VM. All of the other options are available using the menu system. CTRL+Shift+P and Run Tasks. The build container is the default build option.
Bluefin also has the ability to generate an ISO using the current image on ghcr. Bazzite and Main do not have these actions.
Note, these actions are mostly tested using docker. The build-iso action requires the usage of rootful docker/podman. Build container and run container can work with rootless mode. Bluefin additionally has a devcontainer in the project that will work with the out of box docker configuration on bluefin/aurora-dx.