- Install dockcheck as a git clone in ~/.local/share/dockcheck with AutoSelfUpdate (git pull also updates notify templates and urls.list); no pinned versions. regctl is refreshed weekly by run_dockcheck.sh. - Since dockcheck ~v0.7, OnlyLabel skips unlabelled containers entirely, so they got no update notices. run_dockcheck.sh now runs twice: update labelled containers quietly, then check everything and notify once. - Running dockcheck.sh by hand now checks everything and changes nothing. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
52 lines
2.1 KiB
Markdown
52 lines
2.1 KiB
Markdown
# Cron Role
|
|
|
|
Cron jobs on the server (tag `cron`). "Cron jobs" in this repo always means
|
|
jobs on the server, never on the machine running Ansible.
|
|
|
|
## Jobs
|
|
|
|
| Time | User | Job |
|
|
|---|---|---|
|
|
| 08:00 daily | phil | `~/.local/bin/run_dockcheck.sh`: container updates |
|
|
| 09:10 daily | root | `/usr/local/bin/update_warhammer_feed.sh`: Warhammer RSS feed |
|
|
|
|
### Dockcheck (container updates)
|
|
- [dockcheck](https://github.com/mag37/dockcheck) is a git clone in
|
|
`/home/phil/.local/share/dockcheck`, linked as `~/.local/bin/dockcheck.sh`.
|
|
It updates itself every run (`AutoSelfUpdate`: `git pull`, which also
|
|
updates its notify templates and `urls.list`). Ansible only makes the first
|
|
clone.
|
|
- `regctl` (`~/.local/bin/regctl`), which dockcheck uses to query
|
|
registries, is refreshed weekly from its latest release by
|
|
`run_dockcheck.sh`.
|
|
- `/home/phil/.config/dockcheck.config` comes from `dockcheck.config.j2`
|
|
(Gotify token from `vault_dockcheck`).
|
|
- At 08:00 `run_dockcheck.sh` runs dockcheck twice:
|
|
1. Update run: containers labelled `mag37.dockcheck.update=true` are
|
|
pulled and recreated. No notification.
|
|
2. Check run: every container is checked and one Gotify notice lists the
|
|
updates still waiting (unlabelled containers, and images held back by
|
|
`DaysOld`).
|
|
- `DaysOld=3`: images newer than 3 days wait for a later run.
|
|
- `BackupForDays=7`: the replaced image is kept for 7 days for rollback.
|
|
List backups with `dockcheck.sh -B`; to roll back, retag the backup and
|
|
recreate the container.
|
|
- `dawarich_db` and `dawarich_redis` are skipped.
|
|
- Logs go to `/var/log/dockcheck/dockcheck.log`, rotated weekly (a year
|
|
kept).
|
|
|
|
To see what needs updating by hand (checks everything, changes nothing,
|
|
sends nothing):
|
|
```bash
|
|
ssh phil@100.70.169.99 '~/.local/bin/dockcheck.sh'
|
|
```
|
|
|
|
### Warhammer RSS feed
|
|
`update_warhammer_feed.sh` runs the `git.thesatelliteoflove.com/phil/rss-warhammer`
|
|
container to build `warhammer_rss_feed.xml` and copies it to
|
|
`/opt/stacks/caddy/site/tsol/feeds/`, where Caddy serves it on the main site.
|
|
|
|
## Adding a job
|
|
Add a `cron` task to `tasks/main.yml` (copy the script with `copy` first if it
|
|
needs one), then `bin/deploy --tags cron`.
|