53 lines
1.3 KiB
Markdown
53 lines
1.3 KiB
Markdown
# 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.
|