Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Major-changes: Document the switch to OCI for updates #698

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Major-changes: Document the switch to OCI for updates #698

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 34 additions & 0 deletions modules/ROOT/pages/major-changes.adoc
View file
Open in desktop
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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This change has been introduced first in bootimages for the testing stream, for the Fedora 42 rebase. After a few releases
This change will be introduced first in new disk images for the testing stream, as part of the rebase to Fedora 42. After a few releases

we will migrate existing machines through a barrier release.

|===
|Update Stream |Targeted release date

|`next` | 2025-02-04
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Those dates may change so let's write the condition (first release on F42) here instead. We'll update the page once we have the exact releases.

|`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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We claim that it's transparent and then mention exceptions. Let's say that it should be transparent but the following points may require attention: proxy configuration, etc.


Note: Disk images will be updated first, so new installations of F42 based Fedora CoreOS will use OCI images.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Note: Disk images will be updated first, so new installations of F42 based Fedora CoreOS will use OCI images.
Note: Disk images will be updated first, so new installations of Fedora CoreOS based on Fedora 41 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:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will need some rewording

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
Loading