Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/030/dip
Docker Image Patrol (DIP) is a tool that returns the latest version of a docker image using a regular expression.
https://github.com/030/dip
cli devops devops-tools docker docker-image docker-registry go golang kubernetes openshift tags versions
Last synced: 11 days ago
JSON representation
Docker Image Patrol (DIP) is a tool that returns the latest version of a docker image using a regular expression.
- Host: GitHub
- URL: https://github.com/030/dip
- Owner: 030
- License: mit
- Created: 2019-11-04T18:43:07.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-04-14T08:08:07.000Z (7 months ago)
- Last Synced: 2024-04-14T16:18:10.972Z (7 months ago)
- Topics: cli, devops, devops-tools, docker, docker-image, docker-registry, go, golang, kubernetes, openshift, tags, versions
- Language: Go
- Homepage: https://dip.releasesoftwaremoreoften.com/
- Size: 250 KB
- Stars: 5
- Watchers: 3
- Forks: 6
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DIP
[](https://github.com/030/dip/actions?query=workflow%3AGo)
[![GoDoc Widget]][godoc]
[](https://goreportcard.com/report/github.com/030/dip)
[](https://stackoverflow.com/tags/dip)
[](https://devops.stackexchange.com/tags/dip)
[](https://serverfault.com/tags/dip)
[](https://hub.docker.com/r/utrecht/dip)
[](https://github.com/030/dip/releases/latest)
[](https://sonarcloud.io/dashboard?id=030_dip)
[](https://sonarcloud.io/dashboard?id=030_dip)
[](https://sonarcloud.io/dashboard?id=030_dip)
[](https://sonarcloud.io/dashboard?id=030_dip)
[](https://sonarcloud.io/dashboard?id=030_dip)
[](https://sonarcloud.io/dashboard?id=030_dip)
[](https://sonarcloud.io/dashboard?id=030_dip)
[](https://sonarcloud.io/dashboard?id=030_dip)
[](https://sonarcloud.io/dashboard?id=030_dip)
[](https://sonarcloud.io/dashboard?id=030_dip)
[](https://sonarcloud.io/dashboard?id=030_dip)
[](https://codecov.io/gh/030/dip)
[](https://golangci.com/r/github.com/030/dip)
[](https://chocolatey.org/packages/dip)
[](https://snapcraft.io/dip)
[](https://codebeat.co/projects/github-com-030-dip-main)
[](https://conventionalcommits.org)
[](https://github.com/semantic-release/semantic-release)
[godoc]: https://godoc.org/github.com/030/dip
[godoc widget]: https://godoc.org/github.com/030/dip?status.svg
Docker Image Patrol (DIP) keeps docker images up-to-date.
## Installation
Keep Docker Images Up To Date (KDIUTD)
```bash
sudo snap install kdiutd
```
## Usage
```bash
Usage:
dip [flags]
dip [command]
Available Commands:
help Help about any command
image A brief description of your command
Flags:
--configCredHome string config and cred file home directory (default is $HOME/.dip)
--debug debugging mode
-h, --help help for dip
-v, --version version for dip
Use "dip [command] --help" for more information about a command.
```
## k8s
Create a `~/.dip/config.yml` file:
```bash
dip_images:
docker.io/alpine: 3\.[0-9]+\.[0-9]+
elastic/elasticsearch: 7\.[0-9]+\.[0-9]+
fluent/fluentd-kubernetes-daemonset: v.*-debian-elasticsearch7-.*
grafana/grafana: 7\.[0-9]+\.[0-9]+
docker.io/kibana: 7\.[0-9]+\.[0-9]+
kubernetesui/dashboard: v2\.[0-9]+\.[0-9]+
kubernetesui/metrics-scraper: v1\.[0-9]+\.[0-9]+
docker.io/mongo: 4\.[0-9]+\.[0-9]+
docker.io/postgres: 13\.[0-9]+\.[0-9]+
prom/alertmanager: v0\.[0-9]+\.[0-9]+
prom/prometheus: v2\.[0-9]+\.[0-9]+
prom/pushgateway: v1\.[0-9]+\.[0-9]+
sonatype/nexus3: 3\.[0-9]+\.[0-9]+
```
and create a `~/.dip/creds.yml` file:
```bash
slack_channel_id: someSlackChannelID
slack_token: some-token
```
or for k8s:
```bash
apiVersion: v1
kind: ConfigMap
metadata:
name: dip
namespace: dip
data:
config.yml: |-
---
dip_images:
docker.io/alpine: 3\.[0-9]+\.[0-9]+
elastic/elasticsearch: 7\.[0-9]+\.[0-9]+
```
and
```bash
apiVersion: v1
kind: Secret
metadata:
name: dip
namespace: dip
stringData:
creds.yml: |-
---
slack_channel_id: some-id
slack_token: some-token
```
Note: follow these steps to create
[a Slack Token](https://github.com/030/sasm#create-a-slack-token).
## latest
### alpine
```bash
dip image --name=alpine --regex="(\d+\.){2}\d"
```
### minio
```bash
dip image --name=minio/minio --regex="RELEASE\.2019.*"
```
### nexus
```bash
dip image --name=sonatype/nexus3 --regex="(\d+\.){2}\d"
```
### nginx
```bash
dip image --name=nginx --regex=".*(\d+\.){2}\d-alpine$"
```
### sonarqube
```bash
dip image --name=sonarqube --regex=".*-community$"
```
### traefik
```bash
dip image --name=traefik --regex="^v(\d+\.){1,2}\d+$"
```
### ubuntu
```bash
dip image --name=ubuntu --regex="^xenial.*"
```
## dockerfile
Use `-dockerfile` to check whether the image that is defined in the `FROM`
should be updated. If the command is run in the Continuous Integration (CI),
the pipeline will fail as an exit 1 is returned if an image is outdated.
### golang
```bash
dip image --name=golang --regex="([0-9]+\.){2}[0-9]+$" --dockerfile
```
### adoptopenjdk
```bash
dip image --name=adoptopenjdk --regex="14.*-jre-hotspot-bionic" --dockerfile
```
## docker
[](https://hub.docker.com/r/utrecht/dip)
```bash
docker run utrecht/dip:4.2.3 dip image --name=grafana/grafana --regex=^7\.5\.7$
```
will return:
```bash
7.5.7
```
## updateDockerfile
Use the `--updateDockerfile` to check and update the image that is defined in
the `FROM` inside a Dockerfile.
### golang alpine builder
```bash
dip image --name=golang --regex="^([0-9]+\.){2}[0-9]-alpine([0-9]+\.)[0-9]{2}$" --updateDockerfile
```
## quay
```bash
dip image --name=prometheus/prometheus --regex="^v2(\.[0-9]+){2}$" --quayIo
```
