Diun 🔔 (Docker Image Update Notifier) 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.
With Go, this can be done with an independent binary distribution across all platforms and architectures that Go supports. This support includes Linux, macOS, and Windows, on architectures like amd64, i386, ARM, PowerPC, and others.
Here are the main features :
- Allow to watch a 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 image os and architecture
- Docker, Swarm, Kubernetes and File providers available
- Get notified through Gotify, Mail, Slack, Telegram and more
- Healthchecks support to monitor Diun watcher
- Enhanced logging
- Official Docker image available
If you choose webhook notification, a HTTP request is sent with a JSON format response that looks like:
{
"diun_version": "4.0.0",
"hostname": "myserver",
"status": "new",
"provider": "file",
"image": "docker.io/crazymax/diun:latest",
"hub_link": "https://hub.docker.com/r/crazymax/diun",
"mime_type": "application/vnd.docker.distribution.manifest.list.v2+json",
"digest": "sha256:216e3ae7de4ca8b553eb11ef7abda00651e79e537e85c46108284e5e91673e01",
"created": "2020-03-26T12:23:56Z",
"platform": "linux/amd64"
}And here is an email sample if you add mail notification:
For more info about configuration structure and available settings, take a look at the GitHub repository. Documentation can be found on https://crazy-max.github.io/diun/
Your feedback is welcome! 🙂
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! 🙏
