git log –since=”1 year ago”: rok apt-upgrade.me && publikacja playbooków Ansible dla Nextclouda na K3s

🌐 Także w: English · Deutsch · Français · Español · Italiano · Português · Nederlands
W każdej przygodzie z homelabem przychodzi moment, w którym patrzysz na swoją stertę
skryptów bash, ręcznie robionych plików konfiguracyjnych i karteczek z napisami w stylu
“pamiętaj zrobić chown na /data przed startem” — i decydujesz:
dość. 😅
To jest właśnie ten wpis. Dziś publikuję playbooki Ansible, których używam do wdrażania
i utrzymywania Nextclouda ☁️ i WordPressa 📝 na
jednowęzłowym klastrze K3s działającym na AlmaLinux 9.
Wszystko jest infrastructure-as-code, w pełni idempotentne,
i ma kompletny przewodnik operacyjny.
Ale najpierw krótkie słowo od naszych sponsorów — przez co rozumiem:
chwilę mimowolnej autorefleksji. 🙂
🎉 Na marginesie: chwila, ten blog ma urodziny?
Wczoraj minął dokładnie rok od momentu, gdy na tym blogu pojawił się pierwszy wpis.
Zawierał dokładnie dwa słowa: Hallo Welt.
Co po niemiecku znaczy Hello World,
co w języku programistów znaczy:
“Nadal nie mam zielonego pojęcia, co robię, ale mam domenę, VPS-a,
i na
git pushprzysięgam, że użyję obu." 🚀Szczerze mówiąc, nie spodziewałem się, że ten blog będzie jeszcze istniał rok później.
Większość moich pobocznych projektów ma bardzo przewidywalny cykl życia:
git init→ wybuch entuzjazmu → trzy commity →
git stash→ zapomniane na zawsze 💀A jednak oto jesteśmy z rokiem uptime’u, co w kategoriach prywatnych projektów
odpowiada mniej więcej firmie z listy Fortune 500 świętującej stulecie.
Metryki są odpowiednio imponujące:
- 📚 kilka wpisów
- 👀 co najmniej dwóch czytelników (z których jednym jestem ja, sprawdzający layout na telefonie)
- 📈 dashboard w Grafanie, na który nikt poza mną nigdy nie spojrzał
Osiągnięcie odblokowane. 🏆
Wracamy teraz do właściwego tematu tego wpisu.
Spis treści
🚀 Co robi to repozytorium
Kod, który dziś publikuję, to toolkit infrastrukturalny oparty na Ansible,
który przygotowuje i zarządza workloadami na
jednowęzłowym klastrze K3s działającym na AlmaLinux 9:
☁️ Nextcloud — self-hosted synchronizacja plików i współpraca,
łącznie z Collabora CODE do edycji dokumentów online
📝 WordPress — dokładnie dla takiego bloga, jaki właśnie czytasz
Obie stacki współdzielą wspólny zestaw ról Ansible obejmujący:
hardening SSH 🔐,
reguły firewalla 🛡️,
monitoring 📊,
relay poczty,
automatyczne aktualizacje bezpieczeństwa,
skanowanie rootkitów,
i logowanie audytowe.
Playbooki są zaprojektowane jako idempotentne:
możesz je wielokrotnie uruchamiać na działającym systemie, a zmieniają tylko to, co naprawdę
trzeba zmienić. ✨
Cała infrastruktura jest opisana w kodzie.
Nie ma ukrytych ręcznych kroków zakopanych gdzieś w notesie.
Jeśli serwer spłonie (w przenośni — to VPS 😄),
nowy da się postawić od zera jednym
poleceniem ansible-playbook i przywróceniem z backupu.
☸️ Architektura: Nextcloud na K3s
Kluczową decyzją projektową jest jednowęzłowy klaster Kubernetes na K3s.
Bez wysokiej dostępności. Bez setupu multi-master. Bez klastra etcd.
Po prostu jeden serwer, jeden węzeł, jeden single point of failure — celowo.
Przy takim obciążeniu prostota operacyjna jest warta dużo więcej niż udawanie,
że w homelabie działa hyperscaler. 🙂
K3s nadal daje nam wszystkie dobre funkcje Kubernetesa:
- ⚙️ deklaratywne manifesty
- 🔄 rolling deploymenty
- 🔐 cert-manager
- 🌍 ingress controllery
...bez narzutu operacyjnego.
🛡️ Bezpieczeństwo: defence in depth
Model bezpieczeństwa jest warstwowy. Żaden pojedynczy mechanizm nie cieszy się wyłącznym zaufaniem.
Zamiast tego stack łączy kilka niezależnych zabezpieczeń:
- 🔥 iptables z domyślną polityką DROP
- 🔐 utwardzona konfiguracja SSH
- 🚫 Fail2Ban przeciw brute force
- ⚡ rate limiting w nginx
- 🧩 SELinux w trybie enforcing
- 🔑 szyfrowane sekrety przez Ansible Vault
- 🕵️ monitoring auditd + rkhunter
- 📦 automatyczne aktualizacje bezpieczeństwa
Albo, ujmując to inaczej:
defence in depth, a nie
“mam nadzieję, że nikt nie przeskanuje tego VPS-a.” 😄
📊 Monitoring: Prometheus + Grafana
Monitoring jest w pełni zautomatyzowany przy użyciu:
Prometheusa 📈,
Grafany 📊,
Node Exportera,
mysqld_exportera,
i metryk PHP-FPM.
Dashboardy są automatycznie importowane i konfigurowane przez playbook,
w tym:
- 📈 Node Exporter Full
- 🗄️ MySQL Overview
- ⚡ metryki PHP-FPM
Bo skoro już przekombinowujesz homelab,
równie dobrze możesz mieć piękne wykresy pokazujące dokładnie, jak bardzo jest przekombinowany. 🙂
💾 Backup i przywracanie
Repozytorium zawiera prawdziwe skrypty backupu i przywracania —
a nie tylko optymistyczne uczucia i folder o nazwie
backup_final_v2_REAL. 😅
Backupy obejmują:
- 🗄️ zrzuty MariaDB
- 📂 pliki aplikacji Nextcloud
- ☁️ dane użytkowników
- 🔄 automatyzację przywracania
Po przywróceniu ponowne uruchomienie playbooka zapewnia, że cała konfiguracja i
ustawienia aplikacji automatycznie wracają do oczekiwanego stanu.
🚀 Pierwsze kroki
Repozytorium jest przeznaczone dla świeżej instalacji AlmaLinux 9.
Proces konfiguracji jest celowo prosty:
- ⚙️ Skonfiguruj inventory i zmienne hosta
- 🔐 Zaszyfruj vault za pomocą Ansible Vault
- 📦 Zainstaluj wymagane kolekcje Ansible
- 🚀 Uruchom playbook
Wdrożenie jest w pełni idempotentne, co oznacza, że przyszłe zmiany —
czy to aktualizacje obrazów, poprawki firewalla, czy dodatkowe aplikacje —
można po prostu wdrożyć, uruchamiając playbook ponownie.
📥 Pobieranie
Całe repozytorium jest dostępne jako archiwum ZIP.
Rozpakuj je, uzupełnij swoje host_vars,
zaszyfruj vault i możesz wdrażać:
unzip www_k3s.zip
cd www_k3s
ansible-galaxy collection install -r requirements.yml
ansible-vault encrypt inventory/host_vars/<host>/vault.yml
ansible-playbook nextcloud-k3s.yml --limit <host> --ask-vault-pass
👉
Licencja MIT, bez gwarancji – przejrzyj to sam przed użyciem.
Pytania, problemy albo sugestie? 💬
Zostaw je w komentarzach poniżej.
Mała uwaga: wciąż nie ustaliłem do końca, jak chcę porządnie publikować i utrzymywać kod przez GitLab, więc na razie aktualny stan udostępniam jako zwykłe archiwum ZIP 📦. W dłuższej perspektywie może przeniosę wszystko na GitHub albo do innego publicznego repozytorium, ale to wciąż otwarta debata infrastrukturalna między mną, moim wolnym czasem i kilkoma niedokończonymi listami TODO. 😄
