Damon v1.0 - Release Notes

Features

• Event-driven architecture that processes Nomad cluster Events Stream in real-time
• Persistent state storage using Valkey/Redis
• Support for multiple simultaneous providers with independent configurations
• Plugin system for extending functionality

Providers

DNS Provider

• Creates a lightweight DNS server for Nomad service discovery
• Responds to A, SRV, and NS queries for registered services
• Service filtering by tags
• Automatic registration and deregistration of services

Nomad Provider

• Automatically creates secondary jobs based on primary job metadata
• Template-based job and ACL policy generation
• Supports cleaning up secondary jobs when primary jobs are removed
• Useful for automation of operational tasks like backups

Extending Damon

Apart from the built-in providers, Damon can be extended using plugin-based external providers which are loaded at runtime.

Damon Plugins

Damon supports plugins using go plugins system. Although this is not the recommended way of using Damon, the functionality exists to provide users with an option to create their own plugins and use Damon without contributing back to the repository.

To get started, you can refer to the example slack notifications plugin under the examples/plugin folder in the repository, where a sample Slack notification plugin is provided:

Slack Notifications

• Sends notifications to Slack when Nomad events occur
• Configurable filtering of event types
• Customizable message formatting

Installation

Download the release binary below or use the Docker image:

docker pull thunderbottom/damon:latest

A docker compose setup is also present in the repository to get you up and running in a few minutes.

See the README for detailed installation and configuration instructions.

Full Changelog: https://github.com/Thunderbottom/damon/commits/v1.0.0