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

===== DOCUMENTATION =====
System overview  /srv/docs/system.md
Firewall         /etc/nftables.conf

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

Pełny raport można uruchomić poleceniem krowa-admin. Po instalacji z paczki w interaktywnych sesjach logowania automatycznie wyświetlany jest krótszy raport krowa-admin --summary, zawierający podsumowanie i szczegóły wykrytych problemów.

„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,
  • skrócony raport do wyświetlania podczas logowania,
  • opcjonalne odnośniki do istniejącej lokalnej dokumentacji administracyjnej,
  • 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.

📚 Lokalna dokumentacja

Krowa-Admin może wyświetlać ścieżki do dokumentacji znajdującej się już na serwerze, na przykład opisu systemu albo konfiguracji firewalla. Wpisy konfiguruje się osobno w pliku /etc/krowa-admin/docs.conf:

# Lokalna dokumentacja administracyjna
System overview | /srv/docs/system.md
Firewall | /etc/nftables.conf

Każdy wpis ma postać Nazwa | /bezwzględna/ścieżka. Program pokazuje tylko istniejące pliki i nie odczytuje ich zawartości. Puste wiersze, komentarze oraz niepoprawne lub nieistniejące ścieżki są pomijane. Jeśli nie pozostanie żaden prawidłowy wpis, sekcja DOCUMENTATION nie pojawi się w raporcie. Lokalny docs.conf jest zachowywany podczas aktualizacji paczki.

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

Wydanie zawiera również plik SHA256SUMS, którym można zweryfikować pobrane paczki przed instalacją.

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