Skip to content

Commit 59f0304

Browse files
committed
annotations: restrict character set of ref.name values
URI are standard enough, though % opens it a bit too much. After much discussion we're going to keep it as close to the docker tag as possible but with +, @ and / reference: #671 (comment) Fixes #599 Signed-off-by: Vincent Batts <[email protected]>
1 parent 7bab734 commit 59f0304

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

annotations.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,10 @@ This specification defines the following annotation keys, intended for but not l
2626
* **org.opencontainers.image.revision** Source control revision identifier for the packaged software.
2727
* **org.opencontainers.image.vendor** Name of the distributing entity, organization or individual.
2828
* **org.opencontainers.image.licenses** Comma-separated list of licenses under which contained software is distributed, in [SPDX Short identifier](https://spdx.org/licenses/) form.
29-
* **org.opencontainers.image.ref.name** Name of the reference for a target (string). SHOULD only be considered valid when on descriptors on `index.json` within [image layout](image-layout.md).
29+
* **org.opencontainers.image.ref.name** Name of the reference for a target (string).
30+
* SHOULD only be considered valid when on descriptors on `index.json` within [image layout](image-layout.md).
31+
* Character set of the value SHOULD conform to alphanum of `A-Za-z0-9` and separator set of `-._:@/+`
32+
* Recommended regular expression of `/[A-Za-z0-9]+[-._:@/+A-Za-z0-9]*[A-Za-z0-9]+/`
3033
* **org.opencontainers.image.name** Human-readable name of the software packaged in the image (string)
3134
* **org.opencontainers.image.description** Human-readable description of the software packaged in the image (string)
3235

0 commit comments

Comments
 (0)