User Tools

Site Tools


homelab:besluiten:26.009-updatebeleid_containers_wud

This is an old revision of the document!


26.009 Updatebeleid containers (WUD)

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 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 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

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