homelab:besluiten:26.009-updatebeleid_containers_wud
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext 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 miels | homelab: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:** | + | |
| - | * Ruim 20 containers | + | * **Betreft**: [[homelab: |
| - | * 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: |
| - | * **[[resources: | + | * **Thema' |
| - | * Uitrol afgerond op 2026-10-18: labels, geheugenlimieten, | + | |
| - | | + | |
| - | * Meldingen achteraf (geslaagd / mislukt / rollback) werken nog niet, zie Evaluatie | + | |
| - | ===== Relaties | + | ===== Context |
| - | ^ Devices | + | |
| - | | [[homelab:devices:synology_ds423|NAS: 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 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, | ||
| + | * **Afgewezen: alles automatisch**: | ||
| + | * **Afgewezen: | ||
| + | * **Afgewezen: | ||
| ===== 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**: | ||
| + | * **Rollback**: | ||
| + | * **Elke container valt in één categorie.** De indeling per container staat op de [[homelab: | ||
| - | * **Gekozen optie:** | + | ^ Categorie ^ Criterium ^ Beleid ^ Voorbeelden ^ |
| - | * **Opt-in.** Een container wordt alleen automatisch bijgewerkt als ik dat expliciet heb ingesteld met het label '' | + | | **A. Laag risico en downloads** | Stuk gaan is hinderlijk, niet erg; geen eigen data die verloren gaat | Automatisch, |
| - | * 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 | + | | **C. Data en infrastructuur** | Databases, en wat het platform zelf draagt | Nooit automatisch, |
| - | * Elke update moet eerst een afkoeltijd ('' | + | | **D. Buiten |
| - | | + | |
| - | * **Motivatie:** | + | |
| - | * Criteria: weinig onderhoud, geen verrassingen, | + | |
| - | * Alternatief // | + | |
| - | * Alternatief //alleen minor standaard automatisch//: | + | |
| - | | + | |
| - | ==== Categorieën ==== | + | Noot bij B: containers met een versie-tag die alleen binnen de huidige hoofdversie meebeweegt |
| - | ^ Categorie ^ Beleid ^ Applicaties ^ | + | |
| - | | **A. Laag risico en downloads** | Automatisch, | + | |
| - | | **B. Stabiel, direct nodig** | Automatisch na lange afkoeltijd | + | |
| - | | **C. Data en infrastructuur** | Nooit automatisch, | + | |
| - | | **D. Buiten WUD** | Geen controle, geen melding ('' | + | |
| - | 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 '' | + | Wat WUD per soort update doet. Alleen bij versie-tags |
| - | + | ||
| - | ==== Per container ==== | + | |
| - | ^ Categorie ^ Applicatie (stack) ^ Image ^ Labels ^ Afkoeltijd ^ | + | |
| - | | A | Dozzle, Beszel, Beszel-Agent, | + | |
| - | | A | OmniTools (23) | '' | + | |
| - | | A | nicotine (53) | '' | + | |
| - | | A | overseerr, prowlarr, sabnzbd, qbittorrent (37) | '' | + | |
| - | | A | Sonarr, Radarr (37) | '' | + | |
| - | | A | ghostfolio-app (42) | '' | + | |
| - | | B | Joplin (3) | '' | + | |
| - | | B | Homepage (4) | '' | + | |
| - | | B | Plex (37) | '' | + | |
| - | | B | dokuwiki (50) | '' | + | |
| - | | C | databases, redis, portainerdsm, | + | |
| - | | D | beatport-tagger (60), anythingllm, | + | |
| - | + | ||
| - | AU = '' | + | |
| - | + | ||
| - | ==== Matrix: risico per categorie ==== | + | |
| - | Wat WUD per soort update doet. Geldt alleen waar versie-tags | + | |
| ^ 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 '' | ||
| + | * Rollback wacht op de healthcheck, | ||
| + | * **Operationeel**: | ||
| + | * Bij een nieuwe container: indelen in A, B, C of D en de labels zetten (zie de [[homelab: | ||
| + | * Voor een update van een container met eigen data (categorie B en C): eerst een back-up van de database of config. | ||
| + | * **Risico' | ||
| + | * Een update die ouder is dan zijn afkoeltijd wordt bij de eerstvolgende scan uitgevoerd, ook bij een handmatige scan. | ||
| + | * Op '' | ||
| + | * Onbekend is of een nieuwe digest de afkoeltijd opnieuw laat beginnen. LinuxServer bouwt '' | ||
| - | * **Technisch: | + | ===== Bronnen ===== |
| - | * Digest-controle voor Docker Hub staat aan via '' | + | * [[https://getwud.github.io/wud/|De documentatie |
| - | * 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: | + | |
| - | * Joplin-DB blijft bewust op '' | + | |
| - | * **Operationeel: | + | |
| - | * Handmatig bijwerken: knop //Update// bij de container in de WUD-UI (trigger '' | + | |
| - | * Voor de eerste automatische run: dump van Joplin-DB en ghostfolio-db, | + | |
| - | * Joplin, Plex, Sonarr en Radarr eerst zelf handmatig bijwerken (grote sprong, ~7 maanden achterstand), | + | |
| - | * 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: | + | |
| - | * Staat een container op //Cooling down//, dan biedt WUD mogelijk geen // | + | |
| - | * Een mislukte stack-deploy in Portainer kan een container achterlaten met een hash-voorvoegsel (bijv. '' | + | |
| - | * **Risico’s / aandachtspunten: | + | |
| - | * Een update die ouder is dan zijn afkoeltijd wordt bij de eerstvolgende scan uitgevoerd. Ook bij //WATCH NOW//. | + | |
| - | * Op '' | + | |
| - | * Het oude label '' | + | |
| - | * Onbekend: of een nieuwere release de afkoeltijd | + | |
| ===== Evaluatie ===== | ===== Evaluatie ===== | ||
| - | + | | |
| - | * **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 |
| - | * Tijdelijke backups van de uitrol (dumps van Joplin-DB en ghostfolio-db, | + | * Bij een nieuwe |
| - | * Open vervolg: qdrant-server (1.17.0) loopt achter op de qdrant-client die de joplin-indexer bij elke start installeert (waarschuwing, | + | |
| - | * Bekend probleem: de mails //Update SUCCESS / FAILED / Rollback// komen niet aan, ook niet met WUD 9.4.1. In het debuglog staat wel " | + | |
| - | * **Wanneer | + | |
| - | * 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 | + | |
| - | * **Aanleiding voor herziening: | + | |
| - | * Nieuwe containers (indelen in A/B/C/D bij installatie). | + | |
| - | * Wijzigingen in WUD (nieuwe | + | |
homelab/besluiten/26.009-updatebeleid_containers_wud.1792503799.txt.gz · Last modified: by miels
