github
/
docker-autotag
mirror of https://github.com/thegeeklab/docker-autotag.git
0
0
Fork 0
Code Issues Projects Releases Wiki Activity
370 Commits 2 Branches 42 Tags 1.4 MiB
Python 100%
Go to file
renovate[bot] 2120f70dc9 chore(deps): update dependency ruff to v0.4.1 2024-04-22 03:21:38 +00:00
.github use list style synatx and cleanup (#297) 2023-12-23 23:25:08 +01:00
.gitsv chore: replace git-chglog by git-sv (#281) 2023-10-16 15:42:52 +02:00
.woodpecker chore(deps): update quay.io/thegeeklab/wp-docker-buildx docker tag to v4 (#321) 2024-04-02 09:05:20 +02:00
dockerautotag chore(deps): update devdeps non-major (#315) 2024-03-11 09:38:58 +01:00
.dictionary ci: migrate to woodpecker (#265) 2023-08-24 23:24:38 +02:00
.gitignore refctor: migrate flake8 to ruff python linter (#216) 2023-02-12 13:40:45 +01:00
.lycheeignore ci: exclude dockerhub from linkcheck due to rate limiting 2023-12-07 09:08:27 +01:00
.markdownlint.yml ci: migrate to woodpecker (#265) 2023-08-24 23:24:38 +02:00
.prettierignore ci: migrate to woodpecker (#265) 2023-08-24 23:24:38 +02:00
CONTRIBUTING.md fix bare url in contribution file (#241) 2023-05-03 09:31:23 +02:00
Containerfile.multiarch chore(docker): update python:3.12-alpine docker digest to ef09762 2024-04-11 03:50:04 +00:00
LICENSE chore: end of the year maintenance 2021-12-21 10:15:40 +01:00
README.md ci: migrate to woodpecker (#265) 2023-08-24 23:24:38 +02:00
poetry.lock chore(deps): update dependency ruff to v0.4.1 2024-04-22 03:21:38 +00:00
pyproject.toml chore(deps): update dependency ruff to v0.4.1 2024-04-22 03:21:38 +00:00
renovate.json disable renovate for python test matrix in ci 2023-12-24 00:03:57 +01:00

README.md

docker-autotag

Create docker tags from a given version string

Build Status Docker Hub Quay.io Python Version PyPi Status PyPi Release GitHub contributors Source: GitHub License: MIT

Simple tool to create a list of docker tags from a given version string.

Environment variables

# if not set a comma-separated list will be printed to stdout
DOCKER_AUTOTAG_OUTPUT_FILE=
# adds a given suffix to every determined tag
DOCKER_AUTOTAG_SUFFIX=
# returns only tags with the applied suffix
DOCKER_AUTOTAG_SUFFIX_STRICT=False
# version string to use; returns 'latest' if nothing is specified
DOCKER_AUTOTAG_VERSION=
# comma-seprated list of static tags to add to the result set
DOCKER_AUTOTAG_EXTRA_TAGS=
# 'latest' tag would only be used if determined tag list is empty; adds always 'latest' to the result
DOCKER_AUTOTAG_FORCE_LATEST=False
# if the given version string contains a prerelease, no other tags will be returned
DOCKER_AUTOTAG_IGNORE_PRERELEASE=False

Examples

DOCKER_AUTOTAG_VERSION=1.0.1 docker-autotag
# 1.0.1,1.0,1

DOCKER_AUTOTAG_VERSION=0.1.0 docker-autotag
# 0.1.0, 0.1

## 'v' prefixes e.g. from git tags will be removed
DOCKER_AUTOTAG_VERSION=v1.0.1 docker-autotag
# 1.0.1,1.0,1

## unsufficient semver version strings will be tried to convert automatically
## if conversion doesn't work return 'latest'
DOCKER_AUTOTAG_VERSION=1.0 docker-autotag
# 1.0.0,1.0,1

DOCKER_AUTOTAG_VERSION=1.0.0-beta docker-autotag
# 1.0.0-beta

## ignore prerelease to always get a full list of tags
DOCKER_AUTOTAG_IGNORE_PRERELEASE=True DOCKER_AUTOTAG_VERSION=1.0.0-beta docker-autotag
# 1.0.0-beta,1.0.0,1.0,1

DOCKER_AUTOTAG_SUFFIX=amd64 DOCKER_AUTOTAG_VERSION=1.0.0 docker-autotag
# 1.0.0,1.0,1,1.0.0-amd64,1.0-amd64,1-amd64

DOCKER_AUTOTAG_SUFFIX=amd64 DOCKER_AUTOTAG_SUFFIX_STRICT=True DOCKER_AUTOTAG_VERSION=1.0.0 docker-autotag
# 1.0.0-amd64,1.0-amd64,1-amd64

DOCKER_AUTOTAG_EXTRA_TAGS=extra1,extra2 DOCKER_AUTOTAG_VERSION=1.0.0 docker-autotag
# 1.0.0,1.0,1,extra1,extra2

Contributors

Special thanks to all contributors. If you would like to contribute, please see the instructions.

License

This project is licensed under the MIT License - see the LICENSE file for details.