Skip to content

Commit

Permalink
layers: describe policy enforcement for foreign layer media type
Browse files Browse the repository at this point in the history
Signed-off-by: Stephen J Day <stephen.day@docker.com>
  • Loading branch information
stevvooe committed Sep 6, 2016
1 parent 7cb680d commit 4b60850
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 1 deletion.
10 changes: 10 additions & 0 deletions layer.md
Original file line number Diff line number Diff line change
Expand Up @@ -156,3 +156,13 @@ Note that this opaque file will apply to _all_ children, including sub-directori
Implementations SHOULD generate layers using _explicit whiteout_ files, but MUST accept both.

Any given image is likely to be composed of several of these Image Filesystem Changeset tar archives.

# Foreign Layers

Certain layers, due to legal requirements, may not be regularly distributable.
Typically, one can download such layers but they should never be uploaded.

Layers that have these restrictions SHOULD be tagged with an alternative mediatype of `application/vnd.oci.image.layer.foreign.tar+gzip`.
[Descriptors](descriptor.md) referencing these layers MAY include `urls` for downloading these layers.
Implementations MUST NOT distribute layers tagged with this media type.

3 changes: 2 additions & 1 deletion media-types.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,9 @@ The following `mediaType` MIME types are used by the formats described here, and
- `application/vnd.oci.descriptor.v1+json`: [Content Descriptor](descriptor.md)
- `application/vnd.oci.image.manifest.list.v1+json`: [Manifest list](manifest.md#manifest-list)
- `application/vnd.oci.image.manifest.v1+json`: [Image manifest format](manifest.md#image-manifest)
- `application/vnd.oci.image.layer.tar+gzip`: ["Layer", as a gzipped tar archive](layer.md)
- `application/vnd.oci.image.config.v1+json`: [Container config JSON](serialization.md)
- `application/vnd.oci.image.layer.tar+gzip`: ["Layer", as a gzipped tar archive](layer.md)
- `application/vnd.oci.image.layer.foreign.tar+gzip`: ["Layer", as a gzipped tar that MUST NOT be distributed](layer.md#foreign-layers)

## Compatibility Matrix

Expand Down

0 comments on commit 4b60850

Please sign in to comment.