Crondock is a solution to run cron jobs in Docker containers. It's a simple Python script that runs your scripts on the specified cron schedule.

• Key Features
• Docker
  • Docker Run
  • Docker Compose
• Planned for the future

Cron Job Scheduling:

• Automatically detects environment variables prefixed with RS_CRON_ to set up cron job schedules for scripts.
• Supports flexible cron expressions for scheduling (e.g., "*/5 * * * *").

Parameter Support:

• Allows you to pass parameters to your scripts using environment variables.

Multi-Script Execution:

• Supports the execution of multiple script types (.sh, .py, etc.) using an EXTENSION_MAP to associate the script extension with the proper interpreter.
• Can be extended to support additional script types like Perl (.pl), Ruby (.rb), PHP (.php), etc.

Parallel Execution:

• Uses concurrent.futures.ThreadPoolExecutor to run scheduled scripts in parallel without blocking the execution of other scheduled jobs.

Graceful Shutdown Handling:

• Listens for SIGTERM and SIGINT signals (e.g., from Docker stop or Ctrl+C) and ensures that the container shuts down gracefully.

Timezone Support:

• Converts all timestamps to the specified timezone (defaults to Europe/Berlin but can be customized using the TZ environment variable).

Automatic Logging:

• Provides informative logs about script execution, including success/failure messages, cron expression schedules, and detailed timestamps for each job.

Lightweight and Extensible:

• Designed to be easily extensible with more interpreters or custom scheduling logic.
• Lightweight and fast execution, optimized for running in a Docker container.

Before starting the container, you'll need to set some mandatory environment variables:

You can add as many scripts as you want, just follow the above format.

docker run -d \  
    --name crondock \ 
    --restart unless-stopped \
    -v /path/to/your/scripts:/code/scripts \
    -e RS_CRON_TESTSCRIPT="*/1 * * * *!/code/scripts/Testscripts/test_shell.sh" \
    -e RS_CRON_RELOAD_WEBSERVER="0 8 * * * *!/code/scripts/webserver/reload.py!-r 1 --verbose" \
    -e TZ=Europe/Berlin \
    ghcr.io/casudo/crondock:latest

version: "3.8"

services:
  crondock:
    container_name: crondock
    image: ghcr.io/casudo/grei:latest
    restart: unless-stopped
    volumes:
      - /path/to/your/scripts:/code/scripts
    environment:
        - RS_CRON_TESTSCRIPT="*/1 * * * *!/code/scripts/Testscripts/test_shell.sh"
        - RS_CRON_RELOAD_WEBSERVER="0 8 * * * *!/code/scripts/webserver/reload.py!-r 1 --verbose"
        - TZ=Europe/Berlin

Save the above as docker-compose.yml and run it with docker-compose up -d.

• Better error handling
• Guide on how to mount scripts and subfolders
• (Instead of cron expression, use smth like "Every 5 minutes" or "Every 1 hour")
• Ability to run commands instead of scripts
• Ensure that scripts are executable