Merge pull request #233 from stevvooe/foreign-layer-media-type

layers: describe policy enforcement for foreign layer media type

Author: philips

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.
 
+# 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.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.
+
 [tar-archive]: https://en.wikipedia.org/wiki/Tar_(computing)

media-types.md

@@ -5,8 +5,9 @@ The following media types identify the formats described here and their referenc
 - `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.nondistributable.tar+gzip`: ["Layer", as a gzipped tar that has distribution restrictions](layer.md#non-distributable-layers)
 
 ## Compatibility Matrix