Krowa-Admin

===== SYSTEM =====
Uptime: up 12 days, 4 hours, 18 minutes
Load average: 0.42 / 0.36 / 0.31
Load per CPU (1 min): 0.11 (4 CPUs)
Memory: 2.8 GiB / 7.8 GiB (36% used)
Available: 4.7 GiB
Disk /: 18.4 GiB / 58.2 GiB (32% used)
Available: 36.8 GiB

===== SERVICES =====
docker: ✔ running
ssh: ✔ running
k3s: ✔ running

===== DOCKER CONTAINER STATUS =====
example-frontend: ✔ running
example-backend: ✔ running

===== K3S CLUSTER STATUS =====
Nodes:
raspberrypi   Ready   control-plane,master   235d   v1.31.5+k3s1
Running Pods: 24

✔ K3s token exists and matches backup

🐮 Czym jest Krowa-Admin?

Krowa-Admin to lekki, konfigurowalny raport stanu serwera dla systemów Linux. Pokazuje wykorzystanie zasobów systemowych, sprawdza usługi systemd, oczekiwane kontenery Docker oraz — opcjonalnie — wybrane zasoby klastra K3s. Każdy host może włączyć tylko potrzebne kontrole we własnym pliku YAML, dzięki czemu ta sama instalacja sprawdza się na Raspberry Pi, VPS-ach i innych serwerach.

Raport można uruchomić poleceniem krowa-admin. Po instalacji z paczki jest on również automatycznie wyświetlany w interaktywnych sesjach logowania.

„Nie kolejny kombajn DevOps — tylko konkretna krowa do konkretnej roboty.” 😄

🚀 Najważniejsze cechy

  • konfigurowalne kontrole usług systemd,
  • opcjonalne raporty uptime, load average, pamięci, aktywnego swapu i użycia dysków,
  • wykrywanie brakujących, zatrzymanych i niezdrowych kontenerów Docker,
  • opcjonalne raporty o węzłach, podach i przestrzeniach nazw K3s,
  • opcjonalna weryfikacja tokenu K3s względem lokalnej kopii zapasowej,
  • czytelny, kolorowy raport w terminalu,
  • konfiguracja hosta w /etc/krowa-admin/config.yaml, zachowywana podczas aktualizacji,
  • natywne paczki DEB i RPM.

W przykładowej konfiguracji wszystkie kontrole są domyślnie wyłączone. Administrator świadomie włącza tylko te, których potrzebuje dany host.

📦 Instalacja

Pobierz odpowiednią paczkę z najnowszego wydania na GitHubie.

Debian, Raspberry Pi OS i systemy pochodne:

sudo apt-get install ./krowa-admin_*_all.deb

Fedora i inne systemy korzystające z RPM:

sudo dnf install ./krowa-admin-*.noarch.rpm

Docker i kubectl są opcjonalne — są potrzebne tylko po włączeniu odpowiadających im kontroli.

🔗 Projekt

Kod źródłowy, pełna instrukcja konfiguracji i opis budowania paczek znajdują się w repozytorium github.com/shiver25/krowa-admin. Projekt jest udostępniany na licencji MIT.