Base manifest configuration for Fedora CoreOS.
Use https://github.com/coreos/coreos-assembler to build it.
Discussions in https://discussion.fedoraproject.org/c/server/coreos. Bug tracking and feature requests at https://github.com/coreos/fedora-coreos-tracker.
There is one branch for each stream. The default branch is
testing-devel
,
on which all development happens. See
the design
and tooling
docs for more information about streams.
All file changes in testing-devel
are propagated to other
branches (to next-devel
, branched
, and rawhide
through
config-bot,
and to testing
and eventually stable
through usual
promotion), with the following exceptions:
manifest.yaml
: contains the stream's name, yum repos used during composes, and thereleasever
.- lockfiles (
manifest-lock.*
files): ontesting-devel
andnext-devel
, lockfiles are pushed by thebump-lockfile
job. Production streams receive them as part of usual promotion. Overrides (manifest-lock.overrides.*
) are managed independently with the help of some GitHub Actions (see sections below).
We intend for Fedora CoreOS to be used directly for a wide variety of use cases. However, we also want to support "custom" derivatives such as Fedora Silverblue, etc. Hence the configuration in this repository is split up into reusable "layers" and components on the rpm-ostree side.
To derive from this repository, the recommendation is to add it
as a git submodule. Then create your own manifest.yaml
which does
include: fedora-coreos-config/ignition-and-ostree.yaml
for example.
You will also want to create an overlay.d
and symlink in components
in this repository's overlay.d
.
By default, all packages for FCOS come from the stable
Fedora repos. However, it is sometimes necessary to either
hold back some packages, or pull in fixes ahead of Bodhi. To
add such overrides, one needs to add the packages to
manifest-lock.overrides.yaml
(there are also arch-specific
variants of these files for the rare occasions the override
should only apply to a specific arch). There is a
tool to help with this, and for simple
cases, an automat