Skip to content

Commit 7e33e72

Browse files
committed
gc
Signed-off-by: Piotr Janik <piotr.janik@sap.com>
1 parent 83fb5a8 commit 7e33e72

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

  • doc/04-extensions/03-storage-backends

doc/04-extensions/03-storage-backends/oci.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ The specification also introduces a Component Index artifact used for referrer-b
2929
* [6.3.1 Normative Keys](#631-normative-keys)
3030
* [6.3.2 Integrity Requirements](#632-integrity-requirements)
3131
* [6.3.3 Verification of annotated artifacts](#633-verification-of-annotated-artifacts)
32+
* [6.3.4 Garbage collection](#634-garbage-collection)
3233
* [7. Descriptor Selection Logic](#7-descriptor-selection-logic)
3334
* [8. Component Index (Referrer Anchor)](#8-component-index-referrer-anchor)
3435
* [8.1 Requirements](#81-requirements)
@@ -438,6 +439,16 @@ To verify that an ownership referrer is authentic, clients **MUST**:
438439

439440
When transferring Component Versions between OCI registries or into an OCI Image Layout, implementations **MUST** carry ownership referrers alongside the artifact and maintain the tag fallback where applicable.
440441

442+
#### 6.3.4 Garbage collection
443+
444+
Ownership referrers require a registry with well-behaved garbage collection: an ownership referrer **MUST** stay available and discoverable for as long as its subject manifest exists.
445+
A registry **MAY** remove the referrer once the subject manifest has been deleted.
446+
447+
Registries that may remove an ownership referrer while its subject manifest still exists are not supported.
448+
449+
This is stricter than the OCI Image Specification, which defines the [`subject`](https://github.com/opencontainers/image-spec/blob/v1.1.1/manifest.md#image-manifest-property-descriptions) field as a weak association used for referrer discovery, without lifecycle guarantees.
450+
OCM relies on registries to preserve referrers while the subject exists — a safe assumption given how the OCI Referrers API is already used elsewhere.
451+
441452
## 7. Descriptor Selection Logic
442453

443454
When resolving a component version reference:

0 commit comments

Comments
 (0)