crontab url caller

Dockers/cron-url-caller/README.md

@@ -0,0 +1,52 @@
+# cron-url-caller
+
+Minimale Docker image die op een gegeven **CRON**-schema een **GET**-request doet naar een **URL**.
+
+## Environment variables
+
+### Required
+
+| Variable | Description |
+|----------|-------------|
+| `URL` | URL die aangeroepen wordt |
+| `CRON` | 5-veld cron-expressie (bijv. `0 3 * * *`) of macro (`@hourly`, `@daily`, ...) |
+
+### Optional
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `TZ` | `Europe/Brussels` | Tijdzone |
+| `TIMEOUT` | `30` | Request-timeout in seconden |
+| `ON_STARTUP` | `true` | Direct een request doen bij opstart (`true`/`false`) |
+
+## Voorbeeld
+
+```bash
+docker run -d \
+  -e URL=https://example.com/health-check \
+  -e 'CRON=*/5 * * * *' \
+  -e TZ=Europe/Brussels \
+  --name cron-url-caller \
+  bramkel/cron-url-caller:latest
+```
+
+## Compose
+
+```yaml
+  cron-url-caller:
+    image: bramkel/cron-url-caller:latest
+    container_name: cron-url-caller
+    restart: unless-stopped
+    environment:
+      - TZ=Europe/Brussels
+      - URL=https://example.com/health-check
+      - 'CRON=*/5 * * * *'
+      - TIMEOUT=30
+      - ON_STARTUP=true
+```
+
+## Gedrag
+
+1. Bij opstart wordt (indien `ON_STARTUP=true`) direct een GET-request gedaan.
+2. Vervolgens wordt gewacht tot het volgende CRON-tijdstip en opnieuw een GET-request gedaan.
+3. HTTP-status en eventuele fouten worden gelogd.