docs: rewriting OCM OCI repository mapping #134
Merged
+1,158
−140
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
jakobmoellerdev
force-pushed
the
oci-repo-mapping
branch
from
68ebbb2 to
90ca905
Compare
…d image index representations Signed-off-by: Jakob Möller <[email protected]>
jakobmoellerdev
changed the title
jakobmoellerdev
force-pushed
the
oci-repo-mapping
branch
from
90ca905 to
1aab7a3
Compare
morri-son
reviewed
Nov 25, 2025
morri-son
reviewed
Nov 25, 2025
morri-son
reviewed
Nov 25, 2025
morri-son
reviewed
Nov 25, 2025
morri-son
reviewed
Nov 25, 2025
morri-son
reviewed
Nov 25, 2025
morri-son
reviewed
Nov 25, 2025
frewilhelm
reviewed
Nov 27, 2025
Contributor
frewilhelm
left a comment
frewilhelm
left a comment
There was a problem hiding this comment.
Overall, everything sounded pretty logic. Well done!
matthiasbruns
left a comment
matthiasbruns
left a comment
There was a problem hiding this comment.
I liked this very much but felt it hard to follow after a while. Maybe it would benefit from a table showing MUST, MAY fields etc for each section?
Signed-off-by: Jakob Möller <[email protected]>
Signed-off-by: Jakob Möller <[email protected]>
Signed-off-by: Jakob Möller <[email protected]>
…ample Signed-off-by: Jakob Möller <[email protected]>
Signed-off-by: Jakob Möller <[email protected]>
jakobmoellerdev
added a commit
to open-component-model/open-component-model
that referenced
this pull request
Nov 28, 2025
…or annotations (#1277) <!-- markdownlint-disable MD041 --> #### What this PR does / why we need it removes 2 accidental whitespaces we create #### Which issue(s) this PR fixes <!-- Usage: `Fixes #<issue number>`, or `Fixes (paste link of issue)`. --> spotted originally in open-component-model/ocm-spec#134 (comment) Signed-off-by: Jakob Möller <[email protected]>
jakobmoellerdev
added a commit
to open-component-model/open-component-model
that referenced
this pull request
Nov 28, 2025
<!-- markdownlint-disable MD041 --> #### What this PR does / why we need it when writing the component version annotation, we do not want to preserve the component descriptor prefix, even if it can exist on some legacy versions #### Which issue(s) this PR fixes <!-- Usage: `Fixes #<issue number>`, or `Fixes (paste link of issue)`. --> catched as part of open-component-model/ocm-spec#134 (comment) Signed-off-by: Jakob Möller <[email protected]>
4 tasks
morri-son
reviewed
Dec 5, 2025
morri-son
reviewed
Dec 5, 2025
morri-son
reviewed
Dec 5, 2025
morri-son
reviewed
Dec 5, 2025
Signed-off-by: Jakob Möller <[email protected]>
frewilhelm
reviewed
Dec 11, 2025
Contributor
frewilhelm
left a comment
frewilhelm
left a comment
There was a problem hiding this comment.
In general a nice rework - Thanks! Easier to understand, but I still had some issues understanding everything,
Skarlso
reviewed
Dec 11, 2025
Skarlso
reviewed
Dec 11, 2025
Skarlso
reviewed
Dec 11, 2025
Contributor
Skarlso
left a comment
Skarlso
left a comment
There was a problem hiding this comment.
I just had two questions in the entire thing. :D LGTM. :)
Signed-off-by: Jakob Möller <[email protected]>
Signed-off-by: Jakob Möller <[email protected]>
Signed-off-by: Jakob Möller <[email protected]>
Signed-off-by: Jakob Möller <[email protected]>
Signed-off-by: Jakob Möller <[email protected]>
Signed-off-by: Jakob Möller <[email protected]>
Signed-off-by: Jakob Möller <[email protected]>
jakobmoellerdev
force-pushed
the
oci-repo-mapping
branch
9 times, most recently
from
6afc6da to
bb8ce66
Compare
Signed-off-by: Jakob Möller <[email protected]>
jakobmoellerdev
force-pushed
the
oci-repo-mapping
branch
from
bb8ce66 to
2932d28
Compare
frewilhelm
reviewed
Dec 12, 2025
frewilhelm
previously approved these changes
Dec 12, 2025
Signed-off-by: Jakob Möller <[email protected]>
jakobmoellerdev
force-pushed
the
oci-repo-mapping
branch
from
56b9691 to
0089e68
Compare
frewilhelm
approved these changes
Dec 12, 2025
jakobmoellerdev
merged commit e9273b1
into
open-component-model:main
3 of 5 checks passed
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What this PR does / why we need it
The specification defines how OCM repositories, component descriptors, and artifacts are stored and resolved inside OCI registries.
It standardizes the repository format, how component names map to OCI paths, and how versions are represented using either OCI manifests or OCI indexes.
It prescribes strict rules for descriptor selection, LocalBlob handling, digest validation, and version-to-tag mapping.
The specification also introduces a Component Index artifact used for referrer-based version discovery and defines fallback mechanisms for registries lacking referrer support.
Which issue(s) this PR is related to
This completely revamps the OCI mapping specification and makes it much more detailled and normative so we can base our multiple client implementations on it.
fixes open-component-model/ocm-project#718
based on open-component-model/open-component-model#1048