README.md

cron-socat

Forked from djpic's docker-images project on Gitlab.

Removed non-cron items, modified to use alpine/socat instead of alpine, removed fastcgi, and switched CI/CD to Github Actions.

My purpose for this is as a simple scheduler for docker container actions without Docker Swarm or k8s. The idea is to pass through docker.sock and communicate with the socket with socat to control containers on the host.

Source Repo

• Github
• Gitlab (mirror)

Docker Image

• GHCR
• Dockerhub

How to use

Mount script(s) into the directories below to run them at the associated interval:

• /etc/periodic/1min/
• /etc/periodic/15min/
• /etc/periodic/30min/
• /etc/periodic/hourly/
• /etc/periodic/12hour/
• /etc/periodic/daily/
• /etc/periodic/weekly/
• /etc/periodic/monthly/

See crontab file for details on the exact schedule for each associated folder.

docker-compose example

version: "3.2"
services:
  cron:
    image: 11matt556/cron-socat:latest
    volumes: 
         - /var/run/docker.sock:/var/run/docker.sock # Only if your script needs to interface with other docker containers
         - ${PWD}/foo.sh:/etc/periodic/1min/foo.sh
    restart: unless-stopped

CI/CD

This project uses Github actions for the following:

• Mirror from GitHub to GitLab
• Publish Github releases to GHCR and Dockerhub.

Credits

• https://hub.docker.com/r/djpic/cron
• https://hub.docker.com/r/alpine/socat

TODO

• Setup Github Actions to update/notify when new alpine/socat base image is available