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] – removed - external edit (Unknown date) 127.0.0.1homelab: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) ======
 +
 +  * **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.