Using the devcontainer

Follow the ublue-os/devcontainer documentation.

Building Bluefin

Bluefin is cloud native, so all the tooling can be run locally or on any server. Check out the Universal Blue Forge if you're interested in self-hosting. Just is used to manage build tasks. It is designed to facilitate local development. It is also useful for building Bluefin on a wider variety of CI/CD systems.

First clone the repo:

git clone https://github.com/projectbluefin/bluefin.git

attention

origin in this repo points to ublue-os/bluefin (the upstream source). Always push to projectbluefin explicitly:

git push projectbluefin your-branch-name

Or install the push guard hook after cloning:

bash .github/scripts/install-hooks.sh

The Justfile at the root of the repo is used to build the images. The general pattern is:

just build <image> <tag> <flavor>

Command	Description
just build bluefin testing main	Build the testing stream image
just build bluefin testing nvidia-open	Build the testing stream NVIDIA image

• Images: bluefin
• Tags: testing, stable
• Flavors: main, nvidia-open

Validate a combination:

just validate bluefin testing main

List available recipes:

just

Tasks

clean

Cleans the repository by removing build directories and the previous.manifest.json file.

validate

Validates the combination of image, tag, and flavor provided as arguments.

• Checks if the provided image, tag, and flavor exist in the predefined associative arrays.

build

Builds an image with specified parameters (image, tag, flavor).

• Validates the input parameters, determines the image name, base image, target, Fedora version, and kernel release.
• Uses podman build to create the container image with appropriate build arguments and labels.
• Optionally calls the rechunk task via build-rechunk.

build-rechunk

A convenience task that calls build followed by the rechunk step to optimize image storage.

rechunk

Rechunks an image to optimize its storage for faster OTA updates.

• Ensures the image is already built and available in the local Podman store.
• Uses rpm-ostree compose build-chunked-oci to chunk the layers.