Skip to content

Commit

Permalink
Major-changes: Document the switch to OCI for updates
Browse files Browse the repository at this point in the history
With the f42 rebase we will switch disk images to use OCI for
updates. While this is transparent for most users, it's still a big
technical change so it's worth mentionning it, at least so users using
can look into it.

See https://fedoraproject.org/wiki/Changes/CoreOSOstree2OCIUpdates
coreos/fedora-coreos-tracker#1823
  • Loading branch information
jbtrystram committed Jan 23, 2025
1 parent 9dc8d6d commit 0d11aad
Showing 1 changed file with 34 additions and 0 deletions.
34 changes: 34 additions & 0 deletions modules/ROOT/pages/major-changes.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,40 @@ This list is in reverse chronological order to keep recent changes at the top.

// To add a new change here, see the template at the end of the file.

== Switch to OCI updates

Starting in Fedora 42, Fedora CoreOS will be updating through OCI images instead of the
OSTree repo.
Fedora Change request: https://fedoraproject.org/wiki/Changes/CoreOSOstree2OCIUpdates
More discussion: https://github.com/coreos/fedora-coreos-tracker/issues/1823

=== Planning

This change has been introduced first in bootimages for the testing stream, for the Fedora 42 rebase. After a few releases
we will migrate existing machines through a barrier release.

|===
|Update Stream |Targeted release date

|`next` | 2025-02-04
|`testing`| 2025-04-22
|`stable`| Will follow `testing` as usual
|===

=== Notes

Currently, Fedora CoreOS hosts pull updates from the OSTree repository.
With this change, the hosts will pull updates from the Quay.io container registry instead.
This is a transparent change, except for proxied environnements, as the nodes will reach to a different address for updates.

Note: Disk images will be updated first, so new installations of F42 based Fedora CoreOS will use OCI images.
After a few releases, we will migrate existing nodes.

This change is only scoped to switching to OCI as the transport for Fedora CoreOS content.
While derivation of these Fedora CoreOS images is possible with containers builds and use bootc, this comes with limitations:
there is currently no tooling to follow our updates guidance or local layering.
Until we make progress on these topics, we recommend sticking to official images using Ignition and rpm-ostree to make your changes.

== cgroups v1 support disabled

In systemd v256, cgroups v1 support was disabled.
Expand Down

0 comments on commit 0d11aad

Please sign in to comment.