Skip to content

Commit

Permalink
Allow for rejection of image indexes with missing references
Browse files Browse the repository at this point in the history
Be more specific for missing references in the case of image indexes and
not just image manifests.

Signed-off-by: James Hewitt <[email protected]>
  • Loading branch information
Jamstah committed Nov 25, 2021
1 parent 6a86e71 commit 3e65af6
Showing 1 changed file with 6 additions and 3 deletions.
9 changes: 6 additions & 3 deletions spec.md
Original file line number Diff line number Diff line change
Expand Up @@ -190,9 +190,12 @@ If the blob or manifest is not found in the registry, the response code MUST be
#### Push

Pushing an artifact typically works in the opposite order as a pull: the blobs making up the artifact are uploaded first,
and the manifest last. Strictly speaking, content can be uploaded to the registry in any order, but a registry MAY reject
a manifest if it references blobs that are not yet uploaded, resulting in a `BLOB_UNKNOWN` error <sup>[code-1](#error-codes)</sup>.
A useful diagram is provided [here](https://github.com/google/go-containerregistry/tree/d7f8d06c87ed209507dd5f2d723267fe35b38a9f/pkg/v1/remote#anatomy-of-an-image-upload).
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).

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>.

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>.


##### Pushing blobs

Expand Down

0 comments on commit 3e65af6

Please sign in to comment.