mirror of
https://gitlab.com/fedora/bootc/base-images.git
synced 2026-08-29 12:32:40 +00:00
Jonathan Lebon
0bf47996ecAdd optional rechunker and chunked stages that use chunkah for content-based layer splitting. This allows folding the splitting step into the build step. Through some build arg and redirection trickery, this leaves the unchunked path functionally identical. Assisted-by: OpenCode (Claude Opus 4.6)
37 lines
1.3 KiB
Markdown
37 lines
1.3 KiB
Markdown
# Contributing to fedora-bootc base images
|
|
|
|
## Prerequisites
|
|
|
|
Everything revolves around our Containerfile, but there's
|
|
a high level wrapper in `Justfile` which you should use.
|
|
So installing `podman` (or `buildah`) and `just` are strongly recommended.
|
|
|
|
## Building and testing
|
|
|
|
Run `just --list` to see available targets and `just show-config` to
|
|
see current settings. The Justfile is also what CI invokes, so anything
|
|
you run locally is the same as what runs in the pipeline.
|
|
|
|
Configuration is via environment variables — see the comments at the
|
|
top of the `Justfile` for the full list. For example:
|
|
|
|
```bash
|
|
just build # defaults
|
|
TIER=minimal just build # different tier
|
|
FEDORA_VERSION=43 just test # different Fedora version
|
|
BUILDER=podman just build # use podman instead of buildah
|
|
just ci # full CI run (validate + test all tiers)
|
|
```
|
|
|
|
## Building a split image
|
|
|
|
The Containerfile supports building a split (content-based layered)
|
|
image using [chunkah](https://github.com/coreos/chunkah) via the
|
|
`chunked` build target:
|
|
|
|
```bash
|
|
just build --chunkah
|
|
```
|
|
|
|
Extra arguments can be passed to chunkah via the `CHUNKAH_ARGS` build
|
|
arg (e.g. `BUILDER_EXTRA='--build-arg CHUNKAH_ARGS="--max-layers 128"' just build --chunkah`).
|