homelab:services:wud
This is an old revision of the document!
Table of Contents
WUD (What's up Docker)
- Wat: Houdt bij of er nieuwe versies van Docker-images zijn, meldt dat per mail en werkt alleen de containers bij waarvoor ik dat expliciet heb ingesteld
- Doel: Containers up-to-date houden met minimaal handwerk, zonder onverwachte updates
- Link: Web-UI van WUD (login met het
wud-admin-account) - Device: Synology DS423+
-
- Uitrol van de labels per stack loopt nog
- Meldingen na een update (succes / mislukt / rollback) werken nog niet
- Beleid en categorieën: zie 26.009_updatebeleid_containers_wud
Opzet
- Versie 9.4.1, draait als eigen stack in Portainer (stack 48), eigen store in
/volume2/docker/wud2 - Login verplicht: één admin-account (
wud-admin); wachtwoord staat alleen in de stack, niet hier - Watcher (naam
LOCAL): kijkt via de Docker-socket naar alle containers (WATCHBYDEFAULT=true), maar niet naar gestopte (WATCHALL=false)- Scant alleen volgens cron: vrijdag 07:00 UTC (= 09:00 lokale tijd), of als ik WATCH NOW druk
WATCHATSTART=falseenWATCHEVENTS=false: niet bij het opstarten en niet bij Docker-events- Standaard afkoeltijd 3 dagen (
DELAY=3d)
- Triggers
docker.autoupdate: automatisch bijwerken, alleen voor containers met het labelwud.trigger.docker.autoupdate.enabled=true(INCLUDEBYDEFAULT=false). Met prune en rollback.docker.manual: de knop Update in de UI, geldt voor alle containers, voert niets zelf uitsmtp.gmail: wekelijkse mail met alle beschikbare updates (batch, één mail)
- Registries: Docker Hub met login en digest-controle aan; GHCR met token (Homepage en nicotine staan op ghcr.io)
Labels
| Label | Betekenis |
|---|---|
wud.trigger.docker.autoupdate.enabled=true | Deze container mag automatisch bijgewerkt worden (opt-in) |
wud.watch.delay=7d | Afwijkende afkoeltijd voor deze container |
wud.watch=false | Container volledig buiten WUD houden |
wud.watch.digest=true | Ook op digest controleren (nodig bij een drijvende tag als v2) |
wud.tag.include=^v2$$ | Alleen tags die deze regex matchen ($$ in compose) |
Handmatig bijwerken
- WUD-UI, tabblad Containers
- Bij de container: Update (trigger
docker.manual) - Bij gevoelige containers eerst een back-up (zie besluit)
Backups
- Wat: de WUD-store (instellingen, geschiedenis) in
/volume2/docker/wud2; de compose staat in Portainer - Hoe: nog vast te leggen (valt de docker-share onder de NVME-backup?)
Beheer
- Monitoring: Dozzle voor logs. Loglevel op
infolaten (debugalleen tijdelijk) - Notities:
- Bij problemen met meldingen: eerst de test-trigger in de UI proberen
- Open: dubbel WUD-item in de lijst (oude
docker-watcher in de store)
Relaties
- Gerelateerde besluiten:
Plugin Backlinks: Nothing was found. - Thema’s:
homelab/services/wud.1792246938.txt.gz · Last modified: by 127.0.0.1
