A job scheduler for Docker containers, configured via container labels.
Documentation: https://deck-chores.readthedocs.io
Code repository: https://github.com/funkyfuture/deck-chores
Issue tracker: https://github.com/funkyfuture/deck-chores/issues
Free software: ISC license
Features
define regular jobs to run within a container context with container and optionally with image labels
use date, interval and cron-like triggers
set a maximum of simultaneously running instances per job
restrict job scheduling to one container per service
multi-architecture image supports amd64, arm64 and arm platforms (the latter are currently not provided for download)
Example
Let’s say you want to dump the database of a Wordpress once a day. Here’s a docker-compose.yml that defines a job that will be handled by deck-chores:
version: "3.7"
services:
wordpress:
image: wordpress
mysql:
image: mariadb
volumes:
- ./database_dumps:/dumps
labels:
deck-chores.dump.command: sh -c "mysqldump --all-databases > /dumps/dump-$$(date -Idate)"
deck-chores.dump.interval: dailyIt is however recommended to use scripts with a proper shebang for such actions. Their outputs to stdout and stderr as well as their exit code will be logged by deck-chores.
Maintenance
The final release is supposed to receive monthly updates that includes updates of all updateable dependencies. If one is skipped, don’t worry. When a second maintenance release is skipped, feel free to open an issue to ask what the status is.
You can always build images upon an up-to-date base image with:
make build
Limitations
When running on a cluster of Docker Swarm nodes, each deck-chores instance can only observe the containers on the node it’s running on, and hence only restrict to run one job per service within the node’s context.
Acknowledgements
It wouldn’t be as charming to write this piece of software without these projects:
1 maintainer
Metadata
1 maintainer
Release files for deck-chores 1.4.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| deck_chores-1.4.12.tar.gz | 13.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| deck_chores-1.4.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 28.3 kB
Release files / deck_chores-1.4.12.tar.gz
| Download URL | deck_chores-1.4.12.tar.gz |
|---|---|
| Size | 13.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1718c6ba506840c952b0c5acd5815b165b487a747fe10d064ff8d1ed8f2459cc
|
|
BLAKE2b-256 checksum How to use checksums |
deacfcc34c0b10d8954c436803f2f1eb5d33c390d5f0a62d4ee4a8258d1c0e3e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / deck_chores-1.4.12-py3-none-any.whl
| Download URL | deck_chores-1.4.12-py3-none-any.whl |
|---|---|
| Size | 14.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e25077066a023ea06e347daf14c4b568cb130cf0433bd31b2714d1592e77c60c
|
|
BLAKE2b-256 checksum How to use checksums |
df27cb2dbed611c9a837931a3cd7afb4e614e40c9903f53b97087f513568e442
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
