Create account

DEV Community

CrazyMax

Posted on Jun 9, 2019 • Edited on Nov 19, 2019

Diun - Docker image update notifier

#docker #registry #notification #go

crazy-max / diun

Receive notifications when an image is updated on a Docker registry

About

Diun is a CLI application written in Go and delivered as a single executable (and a Docker image) to receive notifications when a Docker image is updated on a Docker registry.

Documentation

Documentation can be found on https://crazymax.dev/diun/

Contributing

Want to contribute? Awesome! The most basic way to show your support is to star the project, or to raise issues. If you want to open a pull request, please read the contributing guidelines.

You can also support this project by becoming a sponsor on GitHub or by making a Paypal donation to ensure this journey continues indefinitely!

Thanks again for your support, it is much appreciated! 🙏

License

MIT. See LICENSE for more details.

View on GitHub

Diun 🔔 is a CLI application written in Go to receive notifications 📥 when a Docker 🐳 image is updated on a Docker registry.

Here are the main features :

Allow to watch a full Docker repository and report new tags
Include and exclude filters with regular expression for tags
Internal cron implementation through go routines
Worker pool to parallelize analyses
Allow overriding os and architecture when watching
Beautiful email report
Webhook notification

If you choose webhook notification, a HTTP request is sent with a JSON format response that looks like:

{
  "diun_version": "0.3.0",
  "status": "new",
  "image": "docker.io/crazymax/swarm-cronjob:0.2.1",
  "mime_type": "application/vnd.docker.distribution.manifest.v2+json",
  "digest": "sha256:5913d4b5e8dc15430c2f47f40e43ab2ca7f2b8df5eee5db4d5c42311e08dfb79",
  "created": "2019-01-24T10:26:49.152006005Z",
  "architecture": "amd64",
  "os": "linux"
}