https://github.com/dd-decaf/tag-spy
Identify the latest DD-DeCaF tag on a particular Docker image.
https://github.com/dd-decaf/tag-spy
docker docker-image docker-tags tag
Last synced: about 2 months ago
JSON representation
Identify the latest DD-DeCaF tag on a particular Docker image.
- Host: GitHub
- URL: https://github.com/dd-decaf/tag-spy
- Owner: DD-DeCaF
- License: apache-2.0
- Created: 2020-04-29T13:22:57.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-05-29T14:17:41.000Z (about 6 years ago)
- Last Synced: 2024-10-11T23:18:55.813Z (over 1 year ago)
- Topics: docker, docker-image, docker-tags, tag
- Language: Python
- Homepage: https://pypi.org/project/tag-spy/
- Size: 95.7 KB
- Stars: 0
- Watchers: 6
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.rst
- Contributing: .github/CONTRIBUTING.rst
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
==============
Docker Tag Spy
==============
.. image:: https://img.shields.io/pypi/v/tag-spy.svg
:target: https://pypi.org/project/tag-spy/
:alt: Current PyPI Version
.. image:: https://img.shields.io/pypi/pyversions/tag-spy.svg
:target: https://pypi.org/project/tag-spy/
:alt: Supported Python Versions
.. image:: https://img.shields.io/pypi/l/tag-spy.svg
:target: https://www.apache.org/licenses/LICENSE-2.0
:alt: Apache Software License Version 2.0
.. image:: https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg
:target: https://github.com/dd-decaf/tag-spy/blob/master/.github/CODE_OF_CONDUCT.md
:alt: Code of Conduct
.. image:: https://github.com/DD-DeCaF/tag-spy/workflows/CI/badge.svg
:target: https://github.com/DD-DeCaF/tag-spy/workflows/CI
:alt: GitHub Actions
.. image:: https://codecov.io/gh/dd-decaf/tag-spy/branch/master/graph/badge.svg
:target: https://codecov.io/gh/dd-decaf/tag-spy
:alt: Codecov
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/ambv/black
:alt: Black
.. image:: https://readthedocs.org/projects/tag-spy/badge/?version=latest
:target: https://tag-spy.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. summary-start
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
.. code-block:: console
tag-spy dddecaf/wsgi-base alpine dk.dtu.biosustain.wsgi-base.alpine.build.timestamp
may result in something like
.. code-block:: console
alpine_2020-04-28_24fe0a0
For more information, also check out the help.
.. code-block:: console
tag-spy --help
Install
=======
It's as simple as:
.. code-block:: console
pip install tag-spy
Copyright
=========
* Copyright © 2020, DD-DeCaF.
* Free software distributed under the `Apache Software License 2.0
`_.
.. summary-end