From 8a0c75c94f4b1e6cfeb8f050772c4c35ad8f5db1 Mon Sep 17 00:00:00 2001 From: Stephen J Day Date: Wed, 31 Aug 2016 17:34:28 -0700 Subject: [PATCH 1/2] layers: describe policy enforcement for foreign layer media type Signed-off-by: Stephen J Day --- layer.md | 9 +++++++++ media-types.md | 3 ++- 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/layer.md b/layer.md index 0a1fc2321..ff899b3fd 100644 --- a/layer.md +++ b/layer.md @@ -270,4 +270,13 @@ Implementations SHOULD generate layers using _explicit whiteout_ files, but MUST 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, such layers are downloaded directly from a distributor but are never 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. +It is implementation defined whether or not implementations upload layers tagged with this media type. + [tar-archive]: https://en.wikipedia.org/wiki/Tar_(computing) diff --git a/media-types.md b/media-types.md index d426814da..33c9014b0 100644 --- a/media-types.md +++ b/media-types.md @@ -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 has distribution restrictions](layer.md#foreign-layers) ## Compatibility Matrix From e48e595fc5233bbef7f0300b301202175c559f70 Mon Sep 17 00:00:00 2001 From: Stephen J Day Date: Fri, 9 Sep 2016 14:48:24 -0700 Subject: [PATCH 2/2] layer: change to "non-distributable" over foreign Signed-off-by: Stephen J Day --- layer.md | 4 ++-- media-types.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/layer.md b/layer.md index ff899b3fd..b441b8dba 100644 --- a/layer.md +++ b/layer.md @@ -270,12 +270,12 @@ Implementations SHOULD generate layers using _explicit whiteout_ files, but MUST Any given image is likely to be composed of several of these Image Filesystem Changeset tar archives. -# Foreign Layers +# Non-Distributable Layers Certain layers, due to legal requirements, may not be regularly distributable. Typically, such layers are downloaded directly from a distributor but are never uploaded. -Layers that have these restrictions SHOULD be tagged with an alternative mediatype of `application/vnd.oci.image.layer.foreign.tar+gzip`. +Layers that have these restrictions SHOULD be tagged with an alternative mediatype of `application/vnd.oci.image.layer.nondistributable.tar+gzip`. [Descriptors](descriptor.md) referencing these layers MAY include `urls` for downloading these layers. It is implementation defined whether or not implementations upload layers tagged with this media type. diff --git a/media-types.md b/media-types.md index 33c9014b0..34a5bc9f1 100644 --- a/media-types.md +++ b/media-types.md @@ -7,7 +7,7 @@ The following `mediaType` MIME types are used by the formats described here, and - `application/vnd.oci.image.manifest.v1+json`: [Image manifest format](manifest.md#image-manifest) - `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 has distribution restrictions](layer.md#foreign-layers) +- `application/vnd.oci.image.layer.nondistributable.tar+gzip`: ["Layer", as a gzipped tar that has distribution restrictions](layer.md#non-distributable-layers) ## Compatibility Matrix