Dwie minuty czterdzieści pięć: moja pierwsza aktualizacja aplikacji Nextcloud przez Ansible (i barierka, którą dodałem tuż przed)

Ilustracja do artykułu o aktualizowaniu Nextcloud na K3s

🌐 Także w: English · Deutsch · Français · Español · Italiano · Português · Nederlands

Czas na wyznanie: produkcyjny Nextcloud z dziennika bojowego migracji działa na K3s od tygodnia, repozytorium od miesięcy ma playbook nextcloud-update.yml, a ja nigdy go tak naprawdę nie uruchomiłem. Aplikacje aktualizowało się po staremu, klikając w panelu administracyjnym, albo wcale. Dziś to się zmieniło. Sam przebieg trwał 2 minuty i 45 sekund. Ciekawe było wszystko dookoła.

Ten sam workflow co zawsze: ja decyduję, mój współadministrator AI (Claude) sprawdza, buduje i weryfikuje. A pierwszą rzeczą, jaką znalazł, nie był błąd w logice aktualizacji, tylko naładowana strzelba wycelowana w stopę w trzeciej linijce.

Spis treści

🧭 Po co w ogóle osobny playbook do aktualizacji?

Najpierw pytanie, które naprawdę musiałem zadać: jeśli uruchomię główny playbook, to czy moje aplikacje się zaktualizują? Odpowiedź: nie, i tak jest celowo. Są dwa niezależne powody, a główny playbook świadomie nie pokrywa żadnego z nich.

Powód 1: ten sam tag, nowszy obraz

Tag obrazu taki jak nextcloud:34.0.4-fpm to tylko nazwa wskazująca na obraz. Oficjalne obrazy są przebudowywane pod tą samą nazwą za każdym razem, gdy coś pod spodem dostaje łatkę: poprawka bezpieczeństwa Debiana, point release PHP, OpenSSL. Wersja Nextcloud zostaje 34.0.4; zawartość nie.

Moje pody działają z imagePullPolicy: IfNotPresent: jeśli obraz o tej nazwie już leży w lokalnym magazynie containerd, K3s nigdy więcej nie pyta rejestru. Dopóki więc tag w inventory się nie zmienia, główny playbook nakłada identyczne manifesty, K3s nie widzi nic do zrobienia, a stary build działa w nieskończoność. Playbook aktualizacyjny wymusza porównanie przez crictl pull i potem restartuje. To samo dla Collabory.

Powód 2: aplikacji nie ma w obrazie

To ten ważniejszy. Katalog kodu Nextcloud, /var/www/html, to wolumin HostPath na serwerze (/srv/nextcloud-www), a aplikacje z app store’u instalują się właśnie tam, obok core’a. Nowy obraz przynosi nowy core i dostarczane z nim aplikacje. Nigdy nie dotyka aplikacji firm trzecich jak audioplayer, drawio czy Deck. Te ruszają się tylko przez occ app:update (albo kliknięcie w panelu administracyjnym). Główny playbook wymusza tylko układ aplikacji: te włączone, te wyłączone, zainstaluj brakujące. Jest przełącznik opt-in (nextcloud_apps_update), domyślnie false.

Trzy warstwy, trzy dźwignie

Co się zmienia?PrzykładDźwignia
Wersja Nextcloud34.0.4 → 34.0.5 albo → 35Zmień tag w inventory, uruchom nextcloud-k3s.yml
Przebudowany obraz, ten sam tagPoprawka bezpieczeństwa w PHP lub Debianienextcloud-update.yml (pull + restart)
Aplikacje z app store’uaudioplayer 3 → 4nextcloud-update.yml (occ app:update --all)

Czemu nie wrzucić wszystkiego do jednego przebiegu? Bo główny playbook ma być idempotentny i przewidywalny: zbiega do zadeklarowanego stanu, a uruchomiony dwa razy za drugim razem nic nie zmienia. Aktualizacje to przeciwieństwo: pobierają to, co nowego jest w internecie, i podmieniają działający kod. To zasługuje na własny moment, własne sprawdzenie backupu i własne spojrzenie na logi potem. Inaczej każdy mały przebieg konfiguracyjny po cichu aktualizowałby przy okazji aplikacje, a gdy potem coś by się zepsuło, nigdy byś nie wiedział, czy to twoja zmiana konfiguracji, czy cudzy release.

🔫 Strzelba w stopę: hosts: nextcloud

Play celuje w grupę inventory nextcloud. Ta grupa zawiera obecnie instancję produkcyjną, host testowy i drugą instancję, która jest w trakcie migracji: jej baza jest nadpisywana przy każdym syncu aż do dnia przełączenia, a ona sama jest przypięta dokładnie do wersji starego serwera. Zapomnij raz o --limit, a aktualizacja przetoczy się przez wszystkie trzy, restartując pody na maszynie, która ma stać idealnie nieruchomo.

Poprawka to cztery linijki i sprawia, że playbook odmawia startu bez limitu:

- 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 to magiczna zmienna, która istnieje tylko wtedy, gdy przekazano --limit. Tanio, jawnie, i zamienia „ups” w komunikat o błędzie. Pierwszy task dzisiejszego przebiegu: „All assertions passed”. 🎉

✅ Pre-flight: cztery sprawdzenia, dwie minuty

  • Świeży backup? Codzienny pull z maszyny backupowej skończył się o 12:30, z dumpem bazy i danymi. Aktualizacja bez świeżego punktu przywracania to hazard, nie konserwacja.
  • Co faktycznie się zmieni? occ app:update --all --showonly to dry run. Wynik: dokładnie jedna aplikacja, audioplayer, skacząca do 4.0.0.
  • Zdrowy stan wyjściowy? occ status: brak trybu konserwacji, brak oczekującej aktualizacji bazy, wszystkie pody działają, 190 GB wolne. Rzeczy, które chcesz wiedzieć przed, żeby potem móc powiedzieć, czy to ty coś zepsułeś, czy było już zepsute.
  • Kto jest online? Pięciu użytkowników aktywnych w ostatnich 15 minutach. Dwa restarty Nextcloud i jeden restart Collabory oznaczają, że otwarte dokumenty Office zostaną rozłączone. Odnotowane, zaakceptowane, to spokojna wtorkowa pora obiadowa.

⚙️ Anatomia przebiegu

KrokCzasPo co tu jest
crictl pull Nextcloud + Collabora51 sPody używają imagePullPolicy: IfNotPresent, więc K3s nigdy sam z siebie nie pobiera tagu ponownie. Tu tag jest przypięty do dokładnego patch release’u, więc głównie potwierdziło to, że przypięty obraz to wciąż przypięty obraz.
Restart Nextcloud42 sPodejmuje świeży obraz, jeśli jest. Deployment używa strategii Recreate: tylko jeden pod może dotykać woluminów HostPath, więc jest krótka przerwa zamiast płynnego przekazania.
Restart Collabory20 sTen sam pomysł dla serwera Office.
occ upgrade2 sEntrypoint kontenera już to uruchamia przy starcie; to siatka bezpieczeństwa.
occ app:update --all2 saudioplayer → 4.0.0. App store oferuje tylko wydania zgodne z działającą wersją major, więc to nie może wciągnąć niczego, co zepsuje Nextcloud 34.
Restart Nextcloud jeszcze raz43 sTen ciekawy, patrz niżej.

🧠 Dlaczego dwa restarty? OPcache i ustawienie, które nie wybacza

Konfiguracja PHP działa z opcache.validate_timestamps=0. To ustawienie wydajnościowe: PHP kompiluje każdy plik raz i przez cały czas życia procesu nigdy więcej nie sprawdza pliku na dysku. Świetne dla szybkości, ale ma paskudną konsekwencję dla aktualizacji.

Pierwszy restart następuje, zanim occ cokolwiek zapisze; jest po to, żeby podjąć obrazy. Potem app:update nadpisuje pliki PHP aplikacji na trwałym woluminie, ale działający PHP-FPM dalej serwuje stary bajtkod ze swojego cache’u. Aktualizacja wygląda na zrobioną, app:list pokazuje nowy numer wersji, a stary kod działa aż do następnego, zupełnie niezwiązanego restartu. Przy poprawce bezpieczeństwa to najgorszy rodzaj „gotowe”. Stąd drugi restart, i to tylko wtedy, gdy coś faktycznie się zmieniło.

Zabawny szczegół: to gryzie tylko zaktualizowane aplikacje. Świeżo zainstalowanej aplikacji nigdy nie było w cache’u, więc kompiluje się od nowa. To właśnie aktualizacje po cichu nie wchodzą w życie.

🐛 Bug nr 2: task, który zawsze mówił „changed”

Task occ upgrade zgłaszał changed, choć nie było czego aktualizować. Jego changed_when szukał braku frazy „already at the latest version”, a Nextcloud 34 już tej frazy nie wypisuje. Przy przebiegu bez zmian wypisuje teraz tylko notkę odsyłającą do dokumentacji aktualizacji. Brak napisu, który już nie istnieje, jest zawsze prawdą, więc task zawsze twierdził, że coś zmienił.

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

Dziś nieszkodliwe, bo aktualizacja aplikacji i tak wywołała drugi restart. Ale playbook, który kłamie o zmianach, uczy cię ignorować jego wyjście, a pewnego dnia to wyjście będzie miało znaczenie. Lekcja: dopasowuj pozytywny sygnał, a nie brak starego.

🔍 Post-flight: ufaj, ale sprawdzaj

  • audioplayer 4.0.0 włączony; lista wyłączonych aplikacji bez zmian, więc nic nie zostało włączone ani wyłączone za moimi plecami.
  • nextcloud.log od przebiegu: zero ostrzeżeń, zero błędów. Żadnych błędów PHP w kontenerze.
  • Collabora: discovery odpowiada, strona połączenia po stronie Nextcloud jest nienaruszona.
  • Autotest notify_push: wszystkie trzy sprawdzenia zielone. Serwer push sam połączył się ponownie po restartach.
  • 5xx na ingressie: pięć żądań, wszystkie z telefonów i klientów synchronizacji w tych sekundach, gdy pod się restartował. Spodziewane przy Recreate; klienci automatycznie ponawiają.

🎯 Wnioski

Sama aktualizacja była najmniej ekscytującą częścią: jedna aplikacja, poniżej trzech minut, czyste logi. Wartość była na krawędziach. Barierka, która uniemożliwia niebezpieczne ustawienie domyślne, restart, który istnieje z powodu jednego ustawienia cache’u, i sprawdzenie statusu, które po cichu kłamało od ostatniej wersji major. Infrastructure as code nie sprawia, że aktualizacje są magiczne. Sprawia, że są nudne, a nuda to dokładnie to, czego chcesz od rzeczy, która dotyka produkcji. 🧰


📚 Więcej z tej serii: Nextcloud z bare metal na K3s

Część tekstów i obrazów na tej stronie powstała z pomocą AI lub została wygenerowana przez AI. Szczegóły