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

🌐 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ład | Dźwignia |
|---|---|---|
| Wersja Nextcloud | 34.0.4 → 34.0.5 albo → 35 | Zmień tag w inventory, uruchom nextcloud-k3s.yml |
| Przebudowany obraz, ten sam tag | Poprawka bezpieczeństwa w PHP lub Debianie | nextcloud-update.yml (pull + restart) |
| Aplikacje z app store’u | audioplayer 3 → 4 | nextcloud-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 --showonlyto 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
| Krok | Czas | Po co tu jest |
|---|---|---|
crictl pull Nextcloud + Collabora | 51 s | Pody 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 Nextcloud | 42 s | Podejmuje ś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 Collabory | 20 s | Ten sam pomysł dla serwera Office. |
occ upgrade | 2 s | Entrypoint kontenera już to uruchamia przy starcie; to siatka bezpieczeństwa. |
occ app:update --all | 2 s | audioplayer → 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 raz | 43 s | Ten 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
