bluebuild 命令

常用示例

说明

BlueBuild is a tool for creating custom immutable Linux images based on Universal Blue and Fedora Atomic. It uses YAML recipe files to declaratively define image customizations including packages, scripts, and system configurations. The tool simplifies the process of building custom rpm-ostree images that can be deployed on Fedora Silverblue, Kinoite, or other atomic Fedora variants. Recipes can specify base images, add/remove packages, include custom scripts, and configure system settings. BlueBuild integrates with GitHub Actions for automated CI/CD builds. The generate command creates workflow files that automatically build and push images when recipe changes are committed. Images are typically hosted on GitHub Container Registry (ghcr.io). Users can switch to BlueBuild images on existing Fedora Atomic systems using rpm-ostree rebase. The project provides a library of reusable modules for common customizations like adding Flatpak repositories, configuring fonts, or setting up development tools.

参数

build _recipe_

Build a container image from the specified recipe file.

generate _recipe_

Generate GitHub Actions workflow files for automated builds.

template

Create a new BlueBuild project with starter files.

validate _recipe_

Check recipe file for syntax errors and valid configuration.

rebase _image_

Switch the current system to a different image (rpm-ostree systems).

--push

Push the built image to the configured container registry.

--tag _name_

Specify the image tag (default: from recipe).

--registry _url_

Override the container registry URL.

--no-cache

Build without using cached layers.

--squash

Squash all layers into a single layer.

-v, --verbose

Enable verbose output.

--help

Display help information.