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

Ilustracja: mężczyzna świętujący pierwszą rocznicę z fajerwerkami i logotypami technologii

🌐 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 push przysię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:

  1. ⚙️ Skonfiguruj inventory i zmienne hosta
  2. 🔐 Zaszyfruj vault za pomocą Ansible Vault
  3. 📦 Zainstaluj wymagane kolekcje Ansible
  4. 🚀 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

👉

Pobierz www_k3s.zip

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

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