mirror of
https://github.com/docker/metadata-action.git
synced 2024-11-23 04:25:40 +01:00
Note about image name and tag sanitization
Signed-off-by: CrazyMax <crazy-max@users.noreply.github.com>
This commit is contained in:
parent
e44c1fbe6e
commit
678218f2be
17
README.md
17
README.md
@ -31,6 +31,7 @@ ___
|
|||||||
* [`type=raw`](#typeraw)
|
* [`type=raw`](#typeraw)
|
||||||
* [`type=sha`](#typesha)
|
* [`type=sha`](#typesha)
|
||||||
* [Notes](#notes)
|
* [Notes](#notes)
|
||||||
|
* [Image name and tag sanitization](#image-name-and-tag-sanitization)
|
||||||
* [Latest tag](#latest-tag)
|
* [Latest tag](#latest-tag)
|
||||||
* [Global expressions](#global-expressions)
|
* [Global expressions](#global-expressions)
|
||||||
* [`{{branch}}`](#branch)
|
* [`{{branch}}`](#branch)
|
||||||
@ -625,6 +626,22 @@ tags: |
|
|||||||
|
|
||||||
## Notes
|
## Notes
|
||||||
|
|
||||||
|
### Image name and tag sanitization
|
||||||
|
|
||||||
|
In order to comply with [the specification](https://docs.docker.com/engine/reference/commandline/tag/#extended-description),
|
||||||
|
the image name components may contain lowercase letters, digits and separators.
|
||||||
|
A separator is defined as a period, one or two underscores, or one or more
|
||||||
|
dashes. A name component may not start or end with a separator.
|
||||||
|
|
||||||
|
A tag name must be a valid ASCII chars sequences and may contain lowercase and
|
||||||
|
uppercase letters, digits, underscores, periods and dashes. A tag name may not
|
||||||
|
start with a period or a dash and may contain a maximum of 128 characters.
|
||||||
|
|
||||||
|
To ease the integration in your workflow, this action will automatically:
|
||||||
|
|
||||||
|
* Lowercase the image name
|
||||||
|
* Replace invalid chars sequences with `-` for tags
|
||||||
|
|
||||||
### Latest tag
|
### Latest tag
|
||||||
|
|
||||||
`latest` tag is handled through the [`flavor` input](#flavor-input). It will be generated by default (`auto` mode) for:
|
`latest` tag is handled through the [`flavor` input](#flavor-input). It will be generated by default (`auto` mode) for:
|
||||||
|
Loading…
Reference in New Issue
Block a user