User Tools

Site Tools


homelab:besluiten:26.009-updatebeleid_containers_wud

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
homelab:besluiten:26.009-updatebeleid_containers_wud [2026/10/20 15:43] – ↷ Page name changed from homelab:besluiten:26.009_updatebeleid_containers_wud to homelab:besluiten:26.009-updatebeleid_containers_wud mielshomelab:besluiten:26.009-updatebeleid_containers_wud [2026/10/20 17:19] (current) – [26.009 Updatebeleid containers (WUD)] status: vastgesteld miels
Line 1: Line 1:
-===== 26.009 Updatebeleid containers (WUD) =====+====== 26.009 Updatebeleid containers (WUD) ======
  
-  * **Aangemaakt:** 2026-10-17 +  * **Wat**: Welke containers automatisch worden bijgewerkt en welke alleen een melding geven, met WUD als uitvoerder. 
-  * **Context / Aanleiding:** +  * **Datum**: 2026-10-17 
-    * Ruim 20 containers (Docker via Portainer op de NAS), die ik niet allemaal handmatig wil bijhouden, maar ook niet blind automatisch wil laten updaten. +  * **Betreft**: [[homelab:services:wud|WUD (What's up Docker)]], [[homelab:devices:synology_ds423|Synology DS423+]] 
-    * De eerste WUD-configuratie werkte niet zoals bedoeld: updates van o.a. Sonarr en Radarr werden nooit gemeld (digest-controle stond uit) en bij het opstarten van WUD begon hij meteen zelf te updaten. +  * **[[resources:metadata:tags:status|Status]]**: {{tag>vastgesteld}} 
-  * **[[resources:metadata:tags:status|Status]]**: {{tag>concept}} +  * **Thema's**: {{tag>container backup}}
-    * Uitrol afgerond op 2026-10-18: labels, geheugenlimieten, backups en de handmatige updates van Joplin (3.7.2), Plex, Sonarr (4.0.20) en Radarr (6.4.4) +
-    * Eerste echte geplande run: vrijdag 2026-10-23, 09:00 +
-    * Meldingen achteraf (geslaagd / mislukt / rollback) werken nog niet, zie Evaluatie+
  
-===== Relaties ===== +===== Context ===== 
-^ Devices      ^ Services       ^ [[resources:metadata:tags:thema|Tags]]  ^ +  * Ruim 20 containers (Docker via Portainer op de NAS). Die wil ik niet allemaal handmatig bijhouden, maar ook niet blind automatisch laten updaten. 
-| [[homelab:devices:synology_ds423|NAS: Synology DS423+]]   | [[homelab:services:wud|WUD (What's up Docker)]]   | {{tag>container backup}}  |+  * De eerste WUD-configuratie werkte niet zoals bedoeld: updates van o.a. Sonarr en Radarr werden nooit gemeld (digest-controle stond uit) en bij het opstarten begon WUD meteen zelf te updaten. 
 + 
 +===== Opties ===== 
 +  * **Gekozen: opt-in per container**: automatisch bijwerken alleen waar ik dat expliciet instel, voor de rest een melding. Criteria: weinig onderhoud, geen verrassingen, en het risico per container bepalen op basis van wat er misgaat als het stuk is. 
 +  * **Afgewezen: alles automatisch**: te riskant voor databases en voor apps met eigen data (Joplin, Plex). 
 +  * **Afgewezen: alleen minor-updates standaard automatisch**: bij ''latest'' is er geen onderscheid tussen minor en major (WUD ziet daar alleen een nieuwe digest). Kan alleen met versie-tags, en dat past maar bij een paar images. 
 +  * **Afgewezen: Compose-trigger**: vraagt een mount van de Portainer-map en padmapping, en levert voor deze opzet te weinig op.
  
 ===== Besluit ===== ===== Besluit =====
 +  * **Opt-in**: een container wordt alleen automatisch bijgewerkt als hij daarvoor gemarkeerd is. Voor alle andere containers komt er een wekelijkse mail (vrijdagochtend) met de beschikbare updates.
 +  * **Alleen scannen op een vast moment** (wekelijks) of op mijn verzoek, niet bij het opstarten en niet bij Docker-events. Zo gebeurt er niets onverwachts.
 +  * **Afkoeltijd**: een update moet eerst een tijd oud zijn voordat hij wordt uitgevoerd. Standaard 3 dagen, per container langer waar dat nodig is.
 +  * **Rollback**: bij een automatische update gaat WUD terug naar de vorige container als de nieuwe niet gezond start.
 +  * **Elke container valt in één categorie.** De indeling per container staat op de [[homelab:services:wud|WUD-pagina]].
  
-  * **Gekozen optie:** +^ Categorie ^ Criterium ^ Beleid ^ Voorbeelden ^ 
-    * **Opt-in.** Een container wordt alleen automatisch bijgewerkt als ik dat expliciet heb ingesteld met het label ''wud.trigger.docker.autoupdate.enabled=true''. +| **A. Laag risico en downloads** | Stuk gaan is hinderlijk, niet erg; geen eigen data die verloren gaat | Automatisch, ook major, na 3 dagen (7 dagen waar updates vaker iets breken) | Dozzle, de arr-stack | 
-    * Voor alle andere containers krijg ik alleen een melding (wekelijkse mail, vrijdag 09:00) dat er een update beschikbaar is. +| **B. Stabiel, direct nodig** | Wordt dagelijks gebruikt of bevat eigen data, maar is updatebestendig | Automatisch na 14 dagen | Plex, Joplin | 
-    * WUD scant alleen op het ingestelde moment (cron) of als ik zelf op //WATCH NOW// druk. Niet bij het opstarten en niet bij Docker-events. +| **C. Data en infrastructuur** | Databases, en wat het platform zelf draagt | Nooit automatisch, alleen melden | databases, Portainer, Pi-hole | 
-    * Elke update moet eerst een afkoeltijd (''wud.watch.delay'') hebben doorstaan: standaard 3 dagen, per container aan te passen. +| **D. Buiten WUD** | Eigen of experimentele builds zonder bruikbare updates | Geen controle, geen melding | beatport-tagger |
-    * Bij een automatische update draait de rollback aan: als de nieuwe container niet gezond start, gaat WUD terug naar de vorige. +
-  * **Motivatie:** +
-    * Criteria: weinig onderhoud, geen verrassingen, risico per container bepalen op basis van wat er misgaat als het stuk is. +
-    * Alternatief //alles automatisch//: afgewezen, te riskant voor databases en voor apps met eigen data (Joplin, Plex). +
-    * Alternatief //alleen minor standaard automatisch//: bij ''latest'' is er geen onderscheid tussen minor en major (WUD ziet daar alleen een nieuwe digest). Kan alleen met versie-tags, en dat past maar bij een paar images. +
-    * Alternatief //Compose-trigger//: niet gekozen, vraagt een mount van de Portainer-map en padmapping, en levert voor deze opzet te weinig op.+
  
-==== Categorieën ==== +Noot bij B: containers met een versie-tag die alleen binnen de huidige hoofdversie meebeweegt (Joplin, Homepage) krijgen een major-update niet vanzelf. Containers op ''latest'' (Plex, DokuWiki) wel, want daar is geen onderscheid tussen minor en major te maken. Dat is bewust geaccepteerd; de afkoeltijd van 14 dagen is de bescherming.
-^ Categorie ^ Beleid ^ Applicaties ^ +
-| **A. Laag risico en downloads** | Automatisch, ook major | Dozzle, Beszel, Beszel-Agent, docker-iperf3, OmniTools, nicotine, overseerr, Sonarr, Radarr, prowlarr, sabnzbd, qbittorrent, ghostfolio-app | +
-| **B. Stabiel, direct nodig** | Automatisch na lange afkoeltijd (14 dagen), zie noot | Plex, Joplin, Homepage, dokuwiki | +
-| **C. Data en infrastructuur** | Nooit automatisch, alleen melden | ghostfolio-db, ghostfolio-redis, Joplin-DB, portainerdsm, WUD, Pi-hole | +
-| **D. Buiten WUD** | Geen controle, geen melding (''wud.watch=false'') | beatport-tagger, anythingllm, qdrant, joplin-indexer |+
  
-Noot bij B: Joplin en Homepage volgen een versie-tag die alleen binnen de huidige hoofdversie meebeweegt (zie hieronder), dus een major-update komt daar niet vanzelf binnen. Plex en dokuwiki staan op ''latest'': daar is geen onderscheid tussen minor en major te maken. Dat is bewust geaccepteerd; de afkoeltijd van 14 dagen is de bescherming. +Wat WUD per soort update doet. Alleen bij versie-tags is dit onderscheid te maken; bij ''latest'' is er alleen //nieuwe digest//.
- +
-==== Per container ==== +
-^ Categorie ^ Applicatie (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 | databases, redis, portainerdsm, WUD, Pi-hole | ongewijzigd | geen | alleen melden | +
-| D | beatport-tagger (60), anythingllm, qdrant, joplin-indexer (58) | ongewijzigd | ''wud.watch=false'' | n.v.t. | +
- +
-AU = ''wud.trigger.docker.autoupdate.enabled=true''. Afkoeltijd instellen met ''wud.watch.delay=<tijd>'' (alleen bij afwijking van de standaard van 3 dagen). In een compose-bestand moet ''$'' in een regex dubbel: ''$$''. +
- +
-==== Matrix: risico per categorie ==== +
-Wat WUD per soort update doet. Geldt alleen waar versie-tags of drijvende hoofdversies worden gebruikt; bij ''latest'' is er alleen //nieuwe digest//.+
  
 ^ Soort update ^ A ^ B ^ C ^ D ^ ^ Soort update ^ A ^ B ^ C ^ D ^
-| Geen | niets | niets | niets | niets | +| Patch of security-patch | automatisch | automatisch | melding | niets |
-| Security-patch / patch | automatisch | automatisch | melding | niets |+
 | Minor | automatisch | automatisch | melding | niets | | Minor | automatisch | automatisch | melding | niets |
-| Major | automatisch | alleen melding (bij Joplin en Homepage) | melding | niets |+| Major | automatisch | alleen melding (bij een versie-tag) | melding | niets |
  
 ===== Gevolgen ===== ===== Gevolgen =====
 +  * **Technisch**:
 +    * Digest-controle voor Docker Hub moet aan staan, anders zie je op ''latest'' geen updates. Het pull-limiet van Docker Hub is voor een wekelijkse scan ruim voldoende.
 +    * Rollback wacht op de healthcheck, of eist een korte uptime als een container er geen heeft. Een databasemigratie wordt **niet** teruggedraaid.
 +  * **Operationeel**:
 +    * Bij een nieuwe container: indelen in A, B, C of D en de labels zetten (zie de [[homelab:services:wud|WUD-pagina]]).
 +    * Voor een update van een container met eigen data (categorie B en C): eerst een back-up van de database of config.
 +  * **Risico's**:
 +    * Een update die ouder is dan zijn afkoeltijd wordt bij de eerstvolgende scan uitgevoerd, ook bij een handmatige scan.
 +    * Op ''latest'' kan een major-versie toch binnenkomen (Plex, DokuWiki). Mitigatie: afkoeltijd van 14 dagen en een back-up van de config.
 +    * Onbekend is of een nieuwe digest de afkoeltijd opnieuw laat beginnen. LinuxServer bouwt ''latest'' vaak wekelijks opnieuw (nieuwe digest zonder nieuwe app-versie). Als de timer dan telkens reset, haalt een container met 7 dagen afkoeltijd die nooit.
  
-  * **Technisch:** +===== Bronnen ===== 
-    * Digest-controle voor Docker Hub staat aan via ''WUD_REGISTRY_HUB_PUBLIC_WATCHDIGEST=true'' (anders zie je op ''latest'' geen updates). GHCR doet dit standaard al. +  * [[https://getwud.github.io/wud/|De documentatie van WUD]] (labels, triggers en afkoeltijd)
-    * Hub-limiet: 200 pulls per 6 uur (ingelogd), ruim voldoende voor een wekelijkse scan. +
-    * Rollback wacht op de healthcheck (max. 5 min), of eist 10 s uptime als de container er geen heeft. Een databasemigratie wordt **niet** teruggedraaid. +
-    * Geheugenlimieten: de meeste containers hebben een ''mem_limit'' (gebaseerd op gemeten gebruik, ruim erboven), zodat een geheugenlek een herstart van die ene container geeft in plaats van een trage NAS. ''cpus'' werkt niet op de DS423+ (kernel zonder CPU CFS-scheduler, Portainer geeft dan een 500-fout); gebruik ''cpu_shares'' (relatief gewicht). +
-    * Joplin-DB blijft bewust op ''postgres:16'': dat is de versie in het officiële voorbeeld van Joplin. De major-sprong naar 18 vraagt dump en restore en levert niets op. +
-  * **Operationeel:** +
-    * Handmatig bijwerken: knop //Update// bij de container in de WUD-UI (trigger ''docker.manual''). +
-    * Voor de eerste automatische run: dump van Joplin-DB en ghostfolio-db, en een kopie van de config-mappen van Plex, Sonarr en Radarr. +
-    * Joplin, Plex, Sonarr en Radarr eerst zelf handmatig bijwerken (grote sprong, ~7 maanden achterstand), pas daarna hun label zetten. +
-    * Na een Joplin-update de joplin-indexer één keer draaien: WUD ziet niet of die breekt. +
-    * Stacks in Portainer bijwerken met //Re-pull image// uit. +
-    * Draaiende versie controleren: ''%%docker inspect <container> --format '{{index .Config.Labels "org.opencontainers.image.version"}}'%%''. Dat is de versie van het //image//. Bij Plex klopt dat niet, omdat die container zichzelf bijwerkt; gebruik daar ''curl -s http://localhost:32400/identity''. +
-    * Staat een container op //Cooling down//, dan biedt WUD mogelijk geen //Update//-knop. Bijwerken kan dan via Portainer: //Containers → Recreate// met //Pull latest image version//. +
-    * Een mislukte stack-deploy in Portainer kan een container achterlaten met een hash-voorvoegsel (bijv. ''38d3eb85889b_qdrant''). Herstellen met ''docker rename''. +
-  * **Risico’s / aandachtspunten:** +
-    * Een update die ouder is dan zijn afkoeltijd wordt bij de eerstvolgende scan uitgevoerd. Ook bij //WATCH NOW//. +
-    * Op ''latest'' kan een major-versie toch binnenkomen (Plex, dokuwiki). Mitigatie: afkoeltijd 14d en back-up van de config. +
-    * Het oude label ''wud.watch.autoupdate'' doet niets meer. +
-    * Onbekend: of een nieuwere release de afkoeltijd opnieuw laat beginnen. De WUD-documentatie zegt er niets over. LinuxServer bouwt ''latest'' vaak wekelijks opnieuw (nieuwe digest zonder nieuwe app-versie); als de timer dan telkens reset, haalt Sonarr/Radarr met 7d nooit de afkoeltijd. Beoordelen bij de eerste echte run; zo nodig terug naar 3d.+
  
 ===== Evaluatie ===== ===== Evaluatie =====
- +  * Wanneer heroverwegen: 
-  * **Ervaring:** +    * Na de eerste geplande run en na de eerste automatische update van een container in categorie B. 
-    * Nog niet beoordeeld; eerste echte run is 2026-10-23. +    * Als een container in A of B na een update kapotgaat: verplaatsen naar een voorzichtiger categorie. 
-    * Tijdelijke backups van de uitrol (dumps van Joplin-DB en ghostfolio-db, en een kopie van de config van Plex, Sonarr en Radarr) opruimen na ongeveer een week zonder problemen. +    * Bij een nieuwe WUD-versie die labels of triggers wijzigt.
-    * Open vervolg: qdrant-server (1.17.0) loopt achter op de qdrant-client die de joplin-indexer bij elke start installeert (waarschuwing, geen fout). Server bijwerken of de client vastzetten. +
-    * Bekend probleem: de mails //Update SUCCESS / FAILED / Rollback// komen niet aan, ook niet met WUD 9.4.1. In het debuglog staat wel "Handling successful update event", maar er wordt geen mail verstuurd en er is geen fout. De testmail uit de WUD-UI werkt wel. Mogelijke vervolgstappen: melden bij het WUD-project op GitHub (met log), trace-niveau, of een post-update-hook. +
-  * **Wanneer herbeoordelen:** +
-    * Na de eerste geplande run en na de eerste automatische update van een categorie-B-container. +
-    * Als een app in A of B toch kapotgaat na een update: container verplaatsen naar een voorzichtiger categorie. +
-  * **Aanleiding voor herziening:** +
-    * Nieuwe containers (indelen in A/B/C/D bij installatie). +
-    * Wijzigingen in WUD (nieuwe versie, wijziging in labels of triggers).+
  
homelab/besluiten/26.009-updatebeleid_containers_wud.1792503799.txt.gz · Last modified: by miels