crazy-max/diun
Diun
diun is a monitoring service that tracks container registries for new tags or digest changes to notify users when image updates are available. It functions as a container orchestration watcher and registry notification engine, identifying images used within environments to ensure container deployments remain up to date.
The project distinguishes itself by providing automated image discovery across multiple orchestrators and runtimes, including Kubernetes, Docker Swarm, Nomad, and containerd. It supports flexible configuration through YAML files, environment variables, and metadata labels or annotations attached directly to container objects.
The system covers a broad range of capabilities, including registry update monitoring for both running and predefined images, image tag filtering, and the export of runtime telemetry via Prometheus-compatible metrics. Its notification surface includes a wide array of delivery channels such as webhooks, email, and various chat platforms, as well as the ability to trigger custom external scripts.
The service can be deployed as a containerized application or integrated as a system service for automated startup.
Features
- Automated Container Updaters - Monitors container images across various orchestrators and runtimes to detect new tags or digest changes.
- Registry Monitoring - Tracks container registries for new image updates to trigger deployment notifications and workflows.
- Webhook Notification Systems - Dispatches image update alerts to various external services via webhooks and integrated notification providers.
- Container Image Discovery - Identifies images to watch by scanning orchestrators or local container setups.
- Containerd Runtime Discovery - Uses a gRPC API socket to identify active images in containerd and check registries for updates.
- Container Orchestration Integrations - Integrates with multiple container orchestrators to identify images for monitoring.
- Image Discovery - Provides automated discovery of images by scanning active Docker containers.
- Automated Image Updates - Identifies images running in a Kubernetes cluster and monitors their remote registries for newer versions.
- Service Image Monitoring - Analyzes Docker Swarm services to identify used images and track registry updates.
- Image Tracking Definitions - Specifies images to track via a YAML file including options for tag filtering and custom notification metadata.
- Nomad Task Monitoring - Watches images used in Nomad tasks and triggers notifications for new tags or digest changes.
- Orchestration Maintenance - Monitors image versions across Swarm, Nomad, and Kubernetes to ensure up-to-date container environments.
- Orchestrator Image Discovery - Automatically identifies active container images for monitoring by scanning Kubernetes, Swarm, Nomad, and containerd environments.
- Registry Version Polling - Runs scheduled checks against remote container registries to detect new tags or updated image digests.
- Dependency Scan Scheduling - Executes periodic image scans on a built-in timetable to detect available updates.
- Container Monitoring Tools - Tracks the status and image versions of containerized workloads running on a local instance.
- Pod Image Monitoring - Analyzes Kubernetes pods to identify used images and monitor their registries for updates.
- Orchestration Watchers - Acts as a monitoring service that discovers images from Kubernetes, Docker Swarm, Nomad, and containerd environments.
- Annotation-Driven Watch Rules - Overrides default image watching behaviors using service tags or meta attributes to filter tags and notification triggers.
- Image Tracking Lists - Monitors a predefined list of images specified in a configuration file for images not currently running.
- Webhook Notifications - Sends alerts about container image updates to tools like Slack, Discord, and Telegram via webhooks or APIs.
- Configuration via Labels - Determines image tracking rules and notification triggers by reading metadata labels and annotations from container objects.
- Label-Based - Controls update tracking and notification triggers for individual containers using metadata labels.
- Image Tag Filtering - Controls which image tags trigger notifications using include and exclude rules to ignore irrelevant versions.
- External Script Execution - Triggers custom external shell scripts upon detection of image updates, passing metadata via environment variables.
- Notification Dispatchers - Routes update alerts through a pluggable system to multiple external providers including webhooks, chat apps, and message brokers.
- Prometheus Exporters - Exposes runtime telemetry and health metrics through a dedicated Prometheus-compatible HTTP endpoint.
- CI/CD Pipelines - Monitors and notifies about Docker registry image updates.
