v0.4.0 release preparation

[taraspos]

🎉 Release 0.4.0-beta: Share Your Feedback! 🚀

I'm excited to announce the 0.4.0-beta release of Ofelia, which includes some significant updates based on recent pull requests:

• Dynamic docker labels handling #319

which is based on the original PR from @rdelcorro (thanks a lot for the initial implementation):

• Handle config changes on docker updates #137

Now Ofelia will watch for any new containers running in you're environment (use -f flag to provide docker filter expression) and dynamically register new jobs configured via docker labels (see jobs.md for example label configurations).

💬 How You Can Help:

• Test out the 0.4.0-beta.1 release in your environment.
• Share your feedback on the newly implemented features.
• Report any issues found

---

Update (20 Jul 2025)

v0.4.0-beta.1 got released with the fix for:

• Version 0.4.0-beta can not register jobs any longer #351

Known issues:

• [v0.4.0] Targeted containers are not updated #357

---

TODO

• Add integration tests for config.ini style configurations.
• Replace github.com/op/go-logging with https://pkg.go.dev/log/slog
• Update documentation
• Add more tests for global configurations
• Add tests for mixed configurations (config.ini and docker labels)

[abaugh-intp]

Providing feedback on 0.4.0-beta.

1. So far all is working great in regard to dynamic jobs from docker labels. Jobs are picked up for running containers and removed when containers are in non-running state or removed.

# Container stopped
Job python-sample-job is not found, Removing
Job deregistered (will not fire again) "python-sample-job" - "python python_sample.py" - "@every 15s" - ID: 2

# Container started
New job registered "python-sample-job" - "python python_sample.py" - "@every 15s" - ID: 4

# Update Job (command + schedule)
Job python-sample-job has changed, restarting
New job registered "python-sample-job" - "python python_sample.py && sleep 30" - "@every 15s" - ID: 6

# Update Job (no-overlap) - no log messages but confirmed working via the _skipped_ true/false log messages

2. I was able to remove the job-local type from the Ofelia container, and confirmed it is not stopping due to 0 jobs available.

I do not currently, have a config.ini use case but will test if desired. Any estimates on when or what is required to move from beta?

Edited to add context for updating the docker labels.

[abaugh-intp]

ping @taraspos

[taraspos]

Hi @abaugh-intp,
Thanks for providing your help with testing the beta version and providing such a detailed feedback!

Unfortunately, I do not have a timeline on when this will move from beta, as I do not have much time to work on this at the moment. However, you're welcomed to use the beta version in the meantime!

Before removing the beta tag, there is bunch of refactoring I want to do (like replacing some of the deprecated libraries in favor of some up-to-date ones, etc).