Skip to content

Commit ee1d972

Browse files
committed
Clarifications around manifest reference validation
Be more specific for missing references in all manifests and not just image manifests. Signed-off-by: James Hewitt <james.hewitt@uk.ibm.com>
1 parent 6a86e71 commit ee1d972

1 file changed

Lines changed: 6 additions & 3 deletions

File tree

spec.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -190,9 +190,12 @@ If the blob or manifest is not found in the registry, the response code MUST be
190190
#### Push
191191

192192
Pushing an artifact typically works in the opposite order as a pull: the blobs making up the artifact are uploaded first,
193-
and the manifest last. Strictly speaking, content can be uploaded to the registry in any order, but a registry MAY reject
194-
a manifest if it references blobs that are not yet uploaded, resulting in a `BLOB_UNKNOWN` error <sup>[code-1](#error-codes)</sup>.
195-
A useful diagram is provided [here](https://github.com/google/go-containerregistry/tree/d7f8d06c87ed209507dd5f2d723267fe35b38a9f/pkg/v1/remote#anatomy-of-an-image-upload).
193+
and the manifest last. A useful diagram is provided [here](https://github.com/google/go-containerregistry/tree/d7f8d06c87ed209507dd5f2d723267fe35b38a9f/pkg/v1/remote#anatomy-of-an-image-upload).
194+
195+
A registry MAY reject an image manifest if it references blobs that are not yet uploaded, resulting in a `BLOB_UNKNOWN` error <sup>[code-1](#error-codes)</sup>.
196+
197+
A registry MAY reject an image index if it references digests that do not exist in the registry, resulting in a `MANIFEST_BLOB_UNKNOWN` error <sup>[code-5](#error-codes)</sup>.
198+
196199

197200
##### Pushing blobs
198201

0 commit comments

Comments
 (0)