Skip to content

Commit 6c5b891

Browse files
committed
layers: describe policy enforcement for foreign layer media type
Signed-off-by: Stephen J Day <[email protected]>
1 parent 259eb6b commit 6c5b891

File tree

2 files changed

+11
-0
lines changed

2 files changed

+11
-0
lines changed

layer.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -156,3 +156,13 @@ Note that this opaque file will apply to _all_ children, including sub-directori
156156
Implementations SHOULD generate layers using _explicit whiteout_ files, but MUST accept both.
157157

158158
Any given image is likely to be composed of several of these Image Filesystem Changeset tar archives.
159+
160+
# Foreign Layers
161+
162+
Certain layers, due to legal requirements, may not be regularly distributable.
163+
Typically, one can download such layers but they should never be uploaded.
164+
165+
Layers that have these restrictions SHOULD be tagged with an alternative mediatype of `application/vnd.oci.image.serialization.rootfs.foreign.tar.gzip`.
166+
[Descriptors](descriptor.md) referencing these layers MAY include `urls` for downloading these layers.
167+
Implementations MUST NOT distribute layers tagged with this media type.
168+

media-types.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ The following `mediaType` MIME types are used by the formats described here, and
77
- `application/vnd.oci.image.manifest.v1+json`: [Image manifest format](manifest.md#image-manifest)
88
- `application/vnd.oci.image.serialization.config.v1+json`: [Container config JSON](serialization.md)
99
- `application/vnd.oci.image.serialization.rootfs.tar.gzip`: ["Layer", as a gzipped tar archive](layer.md)
10+
- `application/vnd.oci.image.serialization.rootfs.foreign.tar.gzip`: ["Layer", as a gzipped tar that should never be pushed](serialization.md#foreign-layers)
1011

1112
## Compatibility Matrix
1213

0 commit comments

Comments
 (0)