Skip to content

Identify the latest DD-DeCaF tag on a particular Docker image.

License

Notifications You must be signed in to change notification settings

DD-DeCaF/tag-spy

Repository files navigation

Docker Tag Spy

Current PyPI Version Supported Python Versions Apache Software License Version 2.0 Code of Conduct GitHub Actions Codecov Black Documentation Status

Identify the latest DD-DeCaF tag on a particular Docker image.

The package was designed to only depend on the standard library in order to not have any fast moving dependencies. It depends on Python 3.7+ for fromisoformat date parsing.

Usage

The main purpose of this package is to provide a command line interface (CLI) for retrieving the latest of all of a Docker image's tags. The DD-DeCaF organization uses a particular tag format in order to manage dependencies between Docker images. Take dddecaf/wsgi-base:alpine_2020-04-28_24fe0a0 as an example, it consists of the base tag alpine, the date when it was built, and the short hash of the git commit from which the image was generated. The corresponding "latest" image is dddecaf/wsgi-base:alpine, however, child images should depend on the explicit tag. In order to manage this more easily, this package provides a script for retrieving the correct information. Sometimes, multiple images exist for the same date which is why the label for the exact build timestamp is required. The following command

tag-spy dddecaf/wsgi-base alpine dk.dtu.biosustain.wsgi-base.alpine.build.timestamp

may result in something like

alpine_2020-04-28_24fe0a0

For more information, also check out the help.

tag-spy --help

Install

It's as simple as:

pip install tag-spy

Copyright