Skip to content

Commit

Permalink
config: Simplify the paragraph contrasting diffIDs with layer digests
Browse files Browse the repository at this point in the history
Trevor and I couldn't agree on more detailed wording [1], and this
paragraph was never normative anyway.

[1]: #388 (comment)

Signed-off-by: Stephen J Day <[email protected]>
Signed-off-by: W. Trevor King <[email protected]>
  • Loading branch information
stevvooe authored and wking committed Jan 19, 2017
1 parent 63ce6dd commit a387698
Showing 1 changed file with 1 addition and 2 deletions.
3 changes: 1 addition & 2 deletions config.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,8 +28,7 @@ Changing it means creating a new derived image, instead of changing the existing
A layer DiffID is a SHA256 digest over the layer's uncompressed tar archive and serialized in the descriptor digest format, e.g., `sha256:a9561eb1b190625c9adb5a9513e72c4dedafc1cb2d4c5236c9a6957ec7dfd5a9`.
Layers must be packed and unpacked reproducibly to avoid changing the layer DiffID, for example by using tar-split to save the tar headers.

The difference between DiffIDs and the layer digests in the [manifest's `layers`](manifest.md#image-manifest-property-descriptions) is that the layer digest is taken over the blob regardless of compression, while the DiffID is taken after removing any compression.
For an [`application/vnd.oci.image.layer.v1.tar+gzip`](layer.md) layer, the layer digest is taken over the `application/vnd.oci.image.layer.v1.tar+gzip` content, while the DiffID is take over the [`application/vnd.oci.image.layer.v1.tar`](media-types.md#oci-image-media-types) content.
Do not confuse DiffIDs with [layer digests](manifest.md#image-manifest-property-descriptions), often referenced in the manifest, which allow digests over compressed or uncompressed content.

### Layer ChainID

Expand Down

0 comments on commit a387698

Please sign in to comment.