homelab:besluiten:26.009-updatebeleid_containers_wud
This is an old revision of the document!
Table of Contents
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: WUD (What's up Docker), Synology DS423+
- Thema's:
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
latestis 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 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
latestgeen 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 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
latestkan 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
latestvaak wekelijks opnieuw (nieuwe digest zonder nieuwe app-versie). Als de timer dan telkens reset, haalt een container met 7 dagen afkoeltijd die nooit.
Bronnen
- 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.
homelab/besluiten/26.009-updatebeleid_containers_wud.1792504238.txt.gz · Last modified: by 127.0.0.1
