Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stefanwalther/docker-image-tag
CLI tool to search for tags in Docker images (using Docker Registry v2).
https://github.com/stefanwalther/docker-image-tag
cli cli-app docker-image docker-registry docker-registry-v2 semver
Last synced: about 5 hours ago
JSON representation
CLI tool to search for tags in Docker images (using Docker Registry v2).
- Host: GitHub
- URL: https://github.com/stefanwalther/docker-image-tag
- Owner: stefanwalther
- License: mit
- Created: 2018-08-14T03:01:02.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2022-03-07T12:28:34.000Z (over 2 years ago)
- Last Synced: 2024-06-21T02:18:21.377Z (5 months ago)
- Topics: cli, cli-app, docker-image, docker-registry, docker-registry-v2, semver
- Language: Go
- Homepage:
- Size: 1.69 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
Awesome Lists containing this project
README
# docker-image-tag
> CLI tool to search for tags in Docker images (using Docker Registry v2).
[](https://circleci.com/gh/stefanwalther/docker-image-tag/tree/master)
---
## Motivation
_docker-image-tag_ is a CLI tool which helps you to search for **tags in Docker images**.
Think of the following use-cases:
- [x] You want to find the `latest`, `oldest` release.
- [x] List all tags, even if there are hundreds of them
- [ ] Use SemVer queries to find one or more specific tags
## Installation
Go version 1.1 or higher is required. Install or update using the go get command:
```shell
$ go get github.com/stefanwalther/docker-image-tag
```
Using brew:
```shell
$ brew tap stefanwalther/homebrew-docker-image-tag
$ brew install docker-image-tag
```
Or download one of the [releases](https://github.com/stefanwalther/docker-image-tag/releases).
## Usage
Basic usage
```
$ docker-image-tag -u -p qlikcore/engine
> 12.215.0
```
Instead of passing `username` and `password`, _docker-image-tag_ will also use the two environment variables `DOCKER_USER` and `DOCKER_PASS`.
## Use Cases
### No `latest` tag
Let's assume there is Docker image with several tags:
```
Docker image: repo/image
Tags:
11.150.0
11.156.0
12.160.0
12.166.0
```
Using _docker-image_tag_ you can find the latest version (following semantic versioning rules):
```
$ docker-image-tag repo/image
> 12.166.0
```
By providing the `--strategy` flag, you can also search for e.g. the oldest version:
```
$ docker-image-tag repo/image --strategy oldest
> 11.150.0
```
## Commands
### get
> Get the latest/oldest tag of an image
```
$ docker-image-tag get repo/image
```
### list
> Get all tags of an image
```
$ docker-image-tag list repo/image
```
### version
> Get the version of `docker-image-tag`
```
$ docker-image-tag version
```
## About
### Author
**Stefan Walther**
* [twitter](http://twitter.com/waltherstefan)
* [github.com/stefanwalther](http://github.com/stefanwalther)
* [LinkedIn](https://www.linkedin.com/in/stefanwalther/)
* [stefanwalther.io](https://stefanwalther.io)
### Contributing
Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/stefanwalther/docker-image-tag/issues). The process for contributing is outlined below:
1. Create a fork of the project
2. Work on whatever bug or feature you wish
3. Create a pull request (PR)
I cannot guarantee that I will merge all PRs but I will evaluate them all.
### License
MIT
***
_This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.6.0, on December 29, 2019._