c2ff52a7cf
The `if os.path.isdir(args.manifest)` bit dates from the introduction
of this script, but doesn't really work. I suspect the intent here was
to abstract over some manifests being top-level YAML files and others
being directories).
Except that:
1. The script didn't actually check the right path. It's checking
`$PWD/{args.manifest}` instead of `$MANIFESTDIR/{args.manifest}`.
2. `list` doesn't have the equivalent logic to look for `manifest.yaml`
files in subdirectories.
3. Nowadays, there is both a e.g. `standard.yaml` _and_ a
`standard/manifest.yaml` directory. The established semantic there
AIUI is that the top-level manifests are opinionated for a specific
OS (Fedora/CentOS/RHEL), whereas the directories are shared across
all of those.
So let's just nuke support for the directory path.
|
||
|---|---|---|
| .tekton | ||
| fedora-includes | ||
| finalize.d | ||
| iot | ||
| minimal | ||
| minimal-plus | ||
| standard | ||
| tests | ||
| .gitlab-ci.yml | ||
| .mdl_style.rb | ||
| .mdlrc | ||
| .pre-commit-config.yaml | ||
| bootc-base-imagectl | ||
| bootc-base-imagectl.md | ||
| Containerfile | ||
| COPYING | ||
| fedora-40.yaml | ||
| fedora-41.yaml | ||
| fedora-42.yaml | ||
| fedora-bootc-config.json | ||
| fedora-bootc.yaml | ||
| fedora-iot.yaml | ||
| fedora-minimal-plus.yaml | ||
| fedora-minimal.yaml | ||
| fedora-rawhide.yaml | ||
| fedora-standard.yaml | ||
| fedora.repo | ||
| install-manifests | ||
| iot.yaml | ||
| LICENSE | ||
| minimal-plus.yaml | ||
| minimal.yaml | ||
| README.md | ||
| renovate.json | ||
| standard.yaml | ||
Fedora bootc base images
Create and maintain base bootable container images from Fedora packages.
Motivation
The original Docker container model of using "layers" to model applications has been extremely successful. This project aims to apply the same technique for bootable host systems - using standard OCI/Docker containers as a transport and delivery format for base operating system updates.
Building images
The current default user experience is to build layered images on top of the official binary base images produced and tested by this project. See the documentation5 for more info.
You can build custom base images by forking this repository; however, https://gitlab.com/fedora/bootc/tracker/-/issues/32 tracks a more supportable mechanism that is not simply forking. For more information see6.
Build process
Building the images in this repo can be done with podman build, but
note the build process uses a special podman-ecosystem specific mechanism
to create fully custom images while inside a Containerfile.
You need to enable some privileges as nested containerization is required.
podman build --security-opt=label=disable --cap-add=all \
--device /dev/fuse -t localhost/fedora-bootc .
See the Containerfile for more details. This builds the default standard image.
Fedora versions
By default, the base images are built for Fedora rawhide. To build against a
different Fedora version, you can override the FROM image used to obtain the
Fedora repos and dnf variables. E.g.:
podman build --from quay.io/fedora/fedora:41 ...
Deriving
You are of course also free to fork, customize, and build base images yourself. See this page6 of the documentation for more information.
Tiers
At the current time, there is just one reference base image published to the registry. Internally the content set is split up somewhat into "tiers", but this is an internal implementation detail and may change at any time.
It is planned to rework and improve this in the future, especially to support smaller custom images. For more on this, see this tracker issue.
- standard: This image is the default, what is published as https://quay.io/repository/fedora/fedora-bootc
- minimal: This content set is more of a convenient centralization point for CI and curation around a package set that is intended as a starting point for a container base image.
- minimal-plus: This content set is intended to be the shared base used by all image-based Fedora variants (IoT, Atomic Desktops, and CoreOS).
standard inherits from minimal-plus and minimal-plus in turn inherit from minimal.
All non-trivial changes to minimal and minimal-plus should be ACKed by at least one stakeholder of each Fedora variant WGs.
Available Tiers + Versions
NOTE: The location and naming of these images is subject to change.
| Version | standard | minimal | minimal-plus |
|---|---|---|---|
| Rawhide | quay.io/fedora-testing/fedora-bootc:rawhide-standard | quay.io/fedora-testing/fedora-bootc:rawhide-minimal | quay.io/fedora-testing/fedora-bootc:rawhide-minimal-plus |
| Fedora 42 | quay.io/fedora-testing/fedora-bootc:42-standard | quay.io/fedora-testing/fedora-bootc:42-minimal | quay.io/fedora-testing/fedora-bootc:42-minimal-plus |
More information
Documentation: https://docs.fedoraproject.org/en-US/bootc/
Badges
| Badge | Description | Service |
|---|---|---|
 |
Dependencies | Renovate |
 |
Static quality gates | pre-commit |