User Tools

Site Tools


homelab:services:wud

This is an old revision of the document!


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)
    • 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=false en WATCHEVENTS=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 label wud.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 uit
    • smtp.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

  1. WUD-UI, tabblad Containers
  2. Bij de container: Update (trigger docker.manual)
  3. 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 info laten (debug alleen 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

homelab/services/wud.1792246938.txt.gz · Last modified: by 127.0.0.1