====== 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 dat expliciet is ingesteld. * **Doel**: Containers up-to-date houden met minimaal handwerk, zonder onverwachte updates. Het beleid staat in [[homelab:besluiten:26.009-updatebeleid_containers_wud|het updatebeleid voor containers]]. * **GUI**: [[https://wud.miels.synology.me/|de webinterface van WUD]] * **Device**: [[homelab:devices:synology_ds423|Synology DS423+]] * **[[resources:metadata:tags:status|Status]]**: {{tag>vastgesteld}} ===== Afwijkende instellingen (met reden) ===== * Login verplicht met één admin-account (''wud-admin''). Reden: WUD kan containers bijwerken en is via internet bereikbaar. * **Watcher** ''LOCAL'' (via de Docker-socket): * ''WATCHBYDEFAULT=true'', ''WATCHALL=false''. Reden: alle draaiende containers volgen, gestopte niet. * Cron: vrijdag 07:00 UTC. ''WATCHATSTART=false'' en ''WATCHEVENTS=false''. Reden: alleen scannen op een vast moment of bij //WATCH NOW//, zodat er niets onverwachts gebeurt. * ''DELAY=3d''. Reden: standaard afkoeltijd uit het beleid. * **Triggers**: * ''docker.autoupdate'' met ''INCLUDEBYDEFAULT=false'', prune en rollback. Reden: opt-in; alleen containers met het label voor autoupdate. * ''docker.manual'': de knop //Update// in de UI, voor alle containers. Voert niets zelf uit. * ''smtp.gmail'' in batch. Reden: één wekelijkse mail met alle beschikbare updates in plaats van één per container. * **Registries**: * Docker Hub met login en ''WUD_REGISTRY_HUB_PUBLIC_WATCHDIGEST=true''. Reden: zonder digest-controle zie je op ''latest'' geen updates; met login is het pull-limiet hoger (200 per 6 uur). * GHCR met token. Reden: Homepage en nicotine staan op ghcr.io. GHCR controleert de digest standaard al. * Loglevel ''info''. ''debug'' alleen tijdelijk bij het zoeken naar een probleem. ===== Labels ===== Te zetten in de compose van de container. ^ Label ^ Betekenis ^ | ''wud.trigger.docker.autoupdate.enabled=true'' | Deze container mag automatisch bijgewerkt worden (opt-in) | | ''wud.watch.delay=7d'' | Afwijkende afkoeltijd (alleen bij afwijking van 3 dagen) | | ''wud.watch=false'' | Container volledig buiten WUD houden (categorie D) | | ''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 moet ''$'' dubbel: ''$$'' | Het oude label ''wud.watch.autoupdate'' doet niets meer. ===== Indeling per container ===== Categorieën en hun criteria: zie [[homelab:besluiten:26.009-updatebeleid_containers_wud|het updatebeleid]]. AU = ''wud.trigger.docker.autoupdate.enabled=true''. Het getal tussen haakjes is het stacknummer in Portainer. ^ Categorie ^ Container (stack) ^ Image ^ Labels ^ Afkoeltijd ^ | A | Dozzle, Beszel, Beszel-Agent, docker-iperf3 (20) | ''latest'' | AU | 3d | | A | OmniTools (23) | ''latest'' | AU | 3d | | A | nicotine (53) | ''latest'' | AU | 3d | | A | overseerr, prowlarr, sabnzbd, qbittorrent (37) | ''latest'' | AU | 3d | | A | Sonarr, Radarr (37) | ''latest'' | AU | 7d | | A | ghostfolio-app (42) | ''latest'' | AU | 3d | | B | Joplin (3) | ''joplin/server:amd64-3'' | AU | 14d | | B | Homepage (4) | ''ghcr.io/gethomepage/homepage:v2'' | AU, ''wud.watch.digest=true'', ''wud.tag.include=^v2$$'' | 14d | | B | Plex (37) | ''latest'' | AU | 14d | | B | dokuwiki (50) | ''latest'' | AU | 14d | | C | ghostfolio-db, ghostfolio-redis, Joplin-DB, portainerdsm, WUD, Pi-hole | ongewijzigd | geen | alleen melden | | D | beatport-tagger (60), anythingllm, qdrant, joplin-indexer (58) | ongewijzigd | ''wud.watch=false'' | n.v.t. | ===== Beheer ===== * Opzet: versie 9.4.1, eigen stack in Portainer (stack 48), store (instellingen en geschiedenis) in ''/volume2/docker/wud2''. * **Handmatig bijwerken**: WUD-UI, tabblad //Containers//, bij de container //Update//. Bij containers met eigen data eerst een back-up. * **Container staat op //Cooling down//**: WUD biedt dan mogelijk geen //Update//-knop. Bijwerken via Portainer: //Containers → Recreate// met //Pull latest image version//. * **Stacks in Portainer bijwerken** met //Re-pull image// uit, zodat er geen image-update buiten WUD om binnenkomt. * **Mislukte stack-deploy**: Portainer kan een container achterlaten met een hash-voorvoegsel (bijv. ''38d3eb85889b_qdrant''). Herstellen met ''docker rename''. * **Draaiende versie controleren**: ''%%docker inspect --format '{{index .Config.Labels "org.opencontainers.image.version"}}'%%''. Dit is de versie van het image; bij Plex klopt dat niet, zie [[homelab:services:plex|Plex]]. * **Logs**: via Dozzle. Bij problemen met meldingen eerst de test-trigger in de UI proberen. * **Bekend probleem**: de mails //Update SUCCESS / FAILED / Rollback// komen niet aan (ook niet met 9.4.1). In het debuglog staat "Handling successful update event", maar er gaat geen mail uit en er is geen fout. De testmail uit de UI werkt wel. ===== Backups ===== Volgens de [[homelab:standaarden:backups|backupstandaard]]: de store staat op de docker-share (volume 2) en valt onder de NVMe-backup. De compose staat in Portainer. Geen afwijkingen. ===== Relaties ===== * Besluiten: \\ {{backlinks>.#homelab:besluiten}} * Services: \\ {{backlinks>.#homelab:services}} * Thema's: {{tag>container}}