Twee minuten vijfenveertig: mijn eerste Nextcloud-app-update via Ansible (en de vangrail die ik er vlak daarvoor in zette)

Illustratie bij het artikel over het updaten van Nextcloud op K3s

🌐 Ook in: English · Deutsch · Français · Español · Italiano · Português · Polski

Tijd voor een bekentenis: de productie-Nextcloud uit het strijdverslag van de migratie draait al een week op K3s, de repo heeft al maanden een playbook nextcloud-update.yml, en ik had het nog nooit echt gedraaid. Apps werden op de ouderwetse manier geüpdatet, door te klikken in de admin-UI, of helemaal niet. Vandaag veranderde dat. De run zelf duurde 2 minuten en 45 seconden. Het interessante deel was alles eromheen.

Zelfde workflow als altijd: ik beslis, mijn AI-medebeheerder (Claude) controleert, bouwt en verifieert. En het allereerste wat hij vond was geen bug in de updatelogica, maar een geladen geweer gericht op mijn voet in regel drie.

Inhoud

🧭 Waarom überhaupt een apart update-playbook?

Eerst een vraag die ik echt moest stellen: als ik het hoofd-playbook draai, worden mijn apps dan geüpdatet? Antwoord: nee, en dat is zo bedoeld. Er zijn twee onafhankelijke redenen, en het hoofd-playbook dekt bewust geen van beide.

Reden 1: zelfde tag, nieuwere image

Een image-tag zoals nextcloud:34.0.4-fpm is gewoon een naam die naar een image wijst. Officiële images worden onder dezelfde naam opnieuw gebouwd zodra er iets onder de motorkap gepatcht wordt: een Debian-securityfix, een PHP-point release, OpenSSL. De Nextcloud-versie blijft 34.0.4; de inhoud niet.

Mijn pods draaien met imagePullPolicy: IfNotPresent: als er al een image met die naam in de lokale containerd-store staat, vraagt K3s de registry nooit meer. Dus zolang de tag in de inventory niet verandert, past het hoofd-playbook identieke manifests toe, ziet K3s niets te doen en blijft de oude build eindeloos draaien. Het update-playbook dwingt de vergelijking af met crictl pull en herstart daarna. Hetzelfde voor Collabora.

Reden 2: de apps zitten niet in de image

Dit is de grotere. De codemap van Nextcloud, /var/www/html, is een HostPath-volume op de server (/srv/nextcloud-www), en apps uit de app store worden precies daar geïnstalleerd, naast de core. Een nieuwe image brengt een nieuwe core en de meegeleverde apps. Apps van derden zoals audioplayer, drawio of Deck raakt hij nooit aan. Die bewegen alleen met occ app:update (of een klik in de admin-UI). Het hoofd-playbook dwingt alleen de app-indeling af: deze aan, deze uit, installeer wat ontbreekt. Er is een opt-in-schakelaar (nextcloud_apps_update), standaard false.

Drie lagen, drie hendels

Wat verandert er?VoorbeeldHendel
Nextcloud-versie34.0.4 → 34.0.5, of → 35Tag in de inventory wijzigen, nextcloud-k3s.yml draaien
Herbouwde image, zelfde tagSecurityfix in PHP of Debiannextcloud-update.yml (pull + restart)
Apps uit de app storeaudioplayer 3 → 4nextcloud-update.yml (occ app:update --all)

Waarom niet alles in één run stoppen? Omdat het hoofd-playbook idempotent en voorspelbaar hoort te zijn: het convergeert naar een gedeclareerde toestand, en het twee keer draaien verandert de tweede keer niets. Updates zijn het tegenovergestelde: ze halen op wat er nieuw is op internet en wisselen draaiende code om. Dat verdient een eigen moment, een eigen backupcheck en een eigen blik op de logs achteraf. Anders zou elke kleine configuratierun stilletjes en passant apps updaten, en als er daarna iets kapotging, wist je nooit of het jouw configwijziging was of de release van iemand anders.

🔫 Het geweer op je voet: hosts: nextcloud

De play richt zich op de inventory-groep nextcloud. Die groep bevat op dit moment de productie-instantie, een testhost en een tweede instantie die midden in een migratie zit: de database ervan wordt bij elke sync overschreven tot de dag van de cutover, en hij is vastgepind op exact de versie van de oude server. Vergeet één keer --limit en de update rolt over alle drie, met pod-herstarts op een machine die volkomen stil hoort te staan.

De fix is vier regels en zorgt dat het playbook weigert te starten zonder limit:

- name: Update | Refuse to run without --limit
  ansible.builtin.assert:
    that: ansible_limit is defined
    fail_msg: "Run with --limit <host>, e.g. --limit cvjm - this playbook restarts Nextcloud."
  run_once: true

ansible_limit is een magische variabele die alleen bestaat als --limit is meegegeven. Goedkoop, expliciet, en het verandert “oeps” in een foutmelding. Eerste task van de run van vandaag: “All assertions passed”. 🎉

✅ Pre-flight: vier checks, twee minuten

  • Backup vers? De dagelijkse pull van de backupbak was om 12:30 klaar, met DB-dump en data. Een update zonder vers herstelpunt is gokken, geen onderhoud.
  • Wat gaat er echt veranderen? occ app:update --all --showonly is de dry run. Resultaat: precies één app, audioplayer, die naar 4.0.0 springt.
  • Gezonde uitgangssituatie? occ status: geen onderhoudsmodus, geen openstaande DB-upgrade, alle pods draaien, 190 GB vrij. Dingen die je vooraf wilt weten, zodat je achteraf kunt zeggen of jij iets kapot hebt gemaakt of dat het al kapot was.
  • Wie is er online? Vijf gebruikers actief in de laatste 15 minuten. Twee Nextcloud-herstarts en één Collabora-herstart betekenen dat open Office-documenten de verbinding verliezen. Genoteerd, geaccepteerd, het is een rustige dinsdagmiddag rond lunchtijd.

⚙️ Anatomie van de run

StapTijdWaarom hij er is
crictl pull Nextcloud + Collabora51 sPods gebruiken imagePullPolicy: IfNotPresent, dus K3s haalt een tag nooit uit zichzelf opnieuw op. Hier is de tag vastgepind op een exacte patch release, dus dit bevestigde vooral dat de vastgepinde image nog steeds de vastgepinde image is.
Nextcloud herstarten42 sPakt een verse image op als die er is. De deployment gebruikt de strategie Recreate: maar één pod mag de HostPath-volumes aanraken, dus er is een korte onderbreking in plaats van een rolling overdracht.
Collabora herstarten20 sZelfde idee voor de Office-server.
occ upgrade2 sHet entrypoint van de container draait het al bij het starten; dit is het vangnet.
occ app:update --all2 saudioplayer → 4.0.0. De app store biedt alleen releases aan die compatibel zijn met de draaiende major, dus dit kan niets binnenhalen dat Nextcloud 34 breekt.
Nextcloud nog een keer herstarten43 sDe interessante, zie hieronder.

🧠 Waarom twee keer herstarten? OPcache en een instelling die niet vergeeft

De PHP-configuratie draait met opcache.validate_timestamps=0. Dat is een performance-instelling: PHP compileert elk bestand één keer en controleert het bestand op schijf nooit meer gedurende de levensduur van het proces. Geweldig voor snelheid, maar het heeft een vervelende consequentie voor updates.

De eerste herstart gebeurt voordat occ iets schrijft; die is er om images op te pakken. Daarna overschrijft app:update de PHP-bestanden van de app op het persistente volume, maar de draaiende PHP-FPM blijft de oude bytecode uit zijn cache serveren. De update lijkt klaar, app:list toont het nieuwe versienummer, en de oude code blijft draaien tot de volgende herstart die er niets mee te maken heeft. Bij een securityfix is dat de ergste soort “klaar”. Vandaar de tweede herstart, en alleen als er echt iets veranderd is.

Leuk detail: dit bijt alleen geüpdatete apps. Een vers geïnstalleerde app zat nooit in de cache, dus die wordt vers gecompileerd. Het zijn specifiek updates die stilletjes geen effect hebben.

🐛 Bug #2: een task die altijd “changed” zei

De task occ upgrade meldde changed terwijl er niets te upgraden viel. Zijn changed_when zocht naar de afwezigheid van de zin “already at the latest version”, en Nextcloud 34 print die zin niet meer. Bij een no-op-run print hij nu alleen een notitie die naar de upgradedocumentatie verwijst. De afwezigheid van een string die niet meer bestaat is altijd waar, dus de task claimde altijd een wijziging.

# before: true forever on NC 34
changed_when: "'already at the latest version' not in occ_upgrade.stdout"
# after: only a real upgrade prints this
changed_when: "'Update successful' in occ_upgrade.stdout"

Vandaag onschuldig, want de app-update triggerde de tweede herstart toch al. Maar een playbook dat liegt over wijzigingen leert je zijn output te negeren, en op een dag doet die output ertoe. Les: match op het positieve signaal, niet op de afwezigheid van een oud signaal.

🔍 Post-flight: vertrouwen, maar verifiëren

  • audioplayer 4.0.0 ingeschakeld; de lijst met uitgeschakelde apps ongewijzigd, dus er is niets achter mijn rug om aan- of uitgezet.
  • nextcloud.log sinds de run: nul warnings, nul errors. Geen PHP-fouten in de container.
  • Collabora: discovery antwoordt, de Nextcloud-kant van de verbinding is intact.
  • Zelftest van notify_push: alle drie de checks groen. De push-server verbond zichzelf na de herstarts opnieuw.
  • 5xx bij de ingress: vijf requests, allemaal van telefoons en sync-clients tijdens de seconden dat de pod herstartte. Verwacht met Recreate; de clients proberen het automatisch opnieuw.

🎯 Conclusie

De update zelf was het minst spannende deel: één app, onder de drie minuten, schone logs. De waarde zat in de randen. Een vangrail die de gevaarlijke standaard onmogelijk maakt, een herstart die bestaat vanwege één cache-instelling, en een statuscheck die sinds de laatste major versie stilletjes loog. Infrastructure as code maakt updates niet magisch. Het maakt ze saai, en saai is precies wat je wilt van het ding dat aan productie zit. 🧰


📚 Meer in deze serie: Nextcloud van bare metal naar K3s

Sommige teksten en afbeeldingen op deze site zijn met hulp van AI gemaakt of door AI gegenereerd. Details