====== 26.009 Updatebeleid containers (WUD) ====== * **Wat**: Welke containers automatisch worden bijgewerkt en welke alleen een melding geven, met WUD als uitvoerder. * **Datum**: 2026-10-17 * **Betreft**: [[homelab:services:wud|WUD (What's up Docker)]], [[homelab:devices:synology_ds423|Synology DS423+]] * **[[resources:metadata:tags:status|Status]]**: {{tag>vastgesteld}} * **Thema's**: {{tag>container backup}} ===== Context ===== * Ruim 20 containers (Docker via Portainer op de NAS). Die wil ik niet allemaal handmatig bijhouden, maar ook niet blind automatisch laten updaten. * 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 ===== * **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]]. ^ Categorie ^ Criterium ^ Beleid ^ Voorbeelden ^ | **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 | | **B. Stabiel, direct nodig** | Wordt dagelijks gebruikt of bevat eigen data, maar is updatebestendig | Automatisch na 14 dagen | Plex, Joplin | | **C. Data en infrastructuur** | Databases, en wat het platform zelf draagt | Nooit automatisch, alleen melden | databases, Portainer, Pi-hole | | **D. Buiten WUD** | Eigen of experimentele builds zonder bruikbare updates | Geen controle, geen melding | beatport-tagger | 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. Wat WUD per soort update doet. Alleen bij versie-tags is dit onderscheid te maken; bij ''latest'' is er alleen //nieuwe digest//. ^ Soort update ^ A ^ B ^ C ^ D ^ | Patch of security-patch | automatisch | automatisch | melding | niets | | Minor | automatisch | automatisch | melding | niets | | Major | automatisch | alleen melding (bij een versie-tag) | melding | niets | ===== 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. ===== Bronnen ===== * [[https://getwud.github.io/wud/|De documentatie van WUD]] (labels, triggers en afkoeltijd) ===== Evaluatie ===== * Wanneer heroverwegen: * Na de eerste geplande run en na de eerste automatische update van een container in categorie B. * Als een container in A of B na een update kapotgaat: verplaatsen naar een voorzichtiger categorie. * Bij een nieuwe WUD-versie die labels of triggers wijzigt.