Fedora CoreOS artifacts and streams are described by metadata objects, in the form of JSON documents. This allows the general audience to consume releases and updates in a machine-friendly way.
The following types of metadata exist:
- stream metadata
- updates metadata
- release index
- release metadata
- coreos-assembler builds
This document contains details about latest available artifacts, on each stream.
- URL:
https://builds.coreos.fedoraproject.org/streams/${stream}.json - Usage: Primary entrypoint for users. Documented at https://docs.fedoraproject.org/en-US/fedora-coreos/getting-started/ and e.g. consumed by the getfedora.org download page
- (TODO) stream metadata JSON schema
- stream metadata sample
- comments and rationale
Projects/Code:
- https://github.com/coreos/stream-metadata-go
- https://github.com/coreos/fedora-coreos-stream-generator/
This document contains details about updates and rollouts, on each stream.
- URL:
https://builds.coreos.fedoraproject.org/updates/${stream}.json - Usage: consumed by Cincinnati to discover valid update-paths
- JSON document specifications
- updates metadata JSON schema
- updates metadata sample
This piece of metadata is meant to list all existing releases, on each stream.
- URL:
https://builds.coreos.fedoraproject.org/prod/streams/${stream}/releases.json - Usage: consumed by Cincinnati to discover valid releases
- JSON document specifications
- release-index JSON schema
- release-index sample
Projects/Code:
This document contains details about artifacts belonging to each release.
- URL: dynamic for each release, provided by the release-index
- Usage: internal tooling, artifacts mirroring, auditing
- (TODO) release metadata JSON schema
- release metadata sample
This is the primary artifact of coreos-assembler, which turns RPMs and our configuration into images and ostree commits.
Projects: