Skip to content

Commit 276abe4

Browse files
committed
Fix examples to include full descriptor
Signed-off-by: Steve Lasker <stevenlasker@hotmail.com>
1 parent 24207bb commit 276abe4

1 file changed

Lines changed: 11 additions & 7 deletions

File tree

docs/distribution/README.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -551,6 +551,8 @@ Partial config object, referring to the digest and tag of the `net-monitor:v1` c
551551
"references": [
552552
"registry.acme-rockets.com/net-monitor:v1"
553553
]
554+
}
555+
}
554556
```
555557

556558
**Pros with this approach:**
@@ -625,10 +627,10 @@ The following options are offered:
625627
### Signature Discovery - Option 1: Signature Listing API
626628

627629
Similar to the [_tags api][tags-api], a new signatures API is proposed. The signatures API uses the digest as the path to find all signatures related to said digest.
628-
In the below example, the `net-monitor:v1` tag has a digest of: `sha256:90659bf80b44ce6be8234e6ff90a1ac34acbeb826903b02cfa0da11c82cbc042`
630+
In the below example, the `net-monitor:v1` tag has a digest of: `sha256:111ma2d22ae5ef400769fa51c84717264cd1520ac8d93dc071374c1be49a111m`
629631

630632
```HTTP
631-
GET /v2/<name>/manifests/sha256:90659bf80b44ce6be8234e6ff90a1ac34acbeb826903b02cfa0da11c82cbc042/signatures/
633+
GET /v2/<name>/manifests/sha256:111ma2d22ae5ef400769fa51c84717264cd1520ac8d93dc071374c1be49a111m/signatures/
632634
```
633635

634636
The response will be in the following format:
@@ -637,16 +639,18 @@ The response will be in the following format:
637639
200 OK
638640
Content-Type: application/json
639641
{
640-
"digest": "sha256:90659bf80b44ce6be8234e6ff90a1ac34acbeb826903b02cfa0da11c82cbc042",
642+
"digest": "sha256:111ma2d22ae5ef400769fa51c84717264cd1520ac8d93dc071374c1be49a111m",
643+
"mediaType": "application/vnd.oci.image.manifest.v1+json",
644+
"size": "1331",
641645
"signatures": [
642646
{
643-
"digest": "sha256:90659bf80b44ce6be8234e6ff90a1ac34acbeb826903b02cfa0da11c82cbc042",
647+
"digest": "sha256:222ibbf80b44ce6be8234e6ff90a1ac34acbeb826903b02cfa0da11c82cb222i",
644648
"mediaType": "application/vnd.oci.image.index.v1+json",
645649
"size": "1024",
646650
"signature-typ": "x509"
647651
},
648652
{
649-
"digest": "sha256:007170c33ebc4a74a0a554c86ac2b28ddf3454a5ad9cf90ea8cea9f9e75a153b",
653+
"digest": "sha256:333ic0c33ebc4a74a0a554c86ac2b28ddf3454a5ad9cf90ea8cea9f9e75c333i",
650654
"mediaType": "application/vnd.oci.image.index.v1+json",
651655
"size": "1025",
652656
"signature-typ": "x509"
@@ -835,8 +839,8 @@ These assume:
835839
### Artifacts submitted to a registry
836840

837841
The following are artifacts that represent a container image, or signature artifact. Depending on the example above, the signatures are represented as an oci manifest or oci index.
838-
|Artifact |`config.mediaType` | Digest |
839-
|----------------------------------|-------------------------------------------|-------------------------------------------------------------------------|
842+
|Artifact |`config.mediaType` | Digest |
843+
|--------------------------------------|-------------------------------------------|-------------------------------------------------------------------------|
840844
|`net-monitor:v1` image **manifest** |`application/vnd.oci.image.config.v1+json` |`sha256:111ma2d22ae5ef400769fa51c84717264cd1520ac8d93dc071374c1be49a111m`|
841845
|`net-monitor:v1` multi-arch **index** |`application/vnd.oci.image.config.v1+json` |`sha256:111ia2d22ae5ef400769fa51c84717264cd1520ac8d93dc071374c1be49a111i`|
842846
|wabbit-networks signature **manifest**|`application/vnd.cncf.notary.config.v2+jwt`|`sha256:222mbbf80b44ce6be8234e6ff90a1ac34acbeb826903b02cfa0da11c82cb222m`|

0 commit comments

Comments
 (0)