Home lab / Notatki wdrożeniowe
Od pomysłu do utrzymywanej usługi.
Praktyczne notatki z budowy mojego homelabu: kolejność pracy, zależności i punkty kontrolne. To opis podejścia; konfiguracja demonstracyjna Home AI jest przygotowywana osobno.
Najpierw role i zależności.
Zaczynam od podziału odpowiedzialności: sieć zapewnia dostęp, NAS przechowuje trwałe dane i usługi, a PC dostarcza zasoby AI. Dla każdej usługi zapisuję zależności, miejsce konfiguracji, dane do zachowania i sposób sprawdzenia działania.
Sieć i dostęp przed aplikacjami.
Stałe przydziały adresów i lokalny DNS porządkują komunikację. WireGuard służy do dostępu do prywatnych usług. Działający tunel lub ping to początek sprawdzenia — potem weryfikuję odpowiedź aplikacji i właściwy punkt wejścia HTTPS.
Kontener jest wymienny, dane pozostają.
Projekty Compose mają oddzielną konfigurację i dane trwałe. Przed aktualizacją sprawdzam używany obraz, wolumeny oraz możliwość przywrócenia poprzedniego stanu. Kopia danych ma wartość dopiero wtedy, gdy wiadomo, jak ją odtworzyć.
HTTPS z zachowaniem stanu certyfikatów.
Caddy obsługuje publiczną witrynę i odnawia jej certyfikaty Let’s Encrypt. Pliki strony są niezależne od konfiguracji proxy i magazynu certyfikatów. Zmiana treści nie wymaga odtwarzania Caddy ani usuwania danych TLS.
Jeden punkt wejścia do własnych usług.
Homepage porządkuje odnośniki do usług prywatnych. Wpisy i widżety powinny odpowiadać aktualnej instalacji. Panel jest częścią środowiska domowego; publiczne portfolio pozostaje oddzielną stroną.
Widoczność przed kolejną automatyzacją.
Sprawdzam dostępność, logi i rzeczywistą funkcję usługi. Uptime Kuma, MySpeed oraz Grafana i Loki pokazują różne aspekty środowiska. Po zmianie porównuję sygnały i wykonuję odczyt potwierdzający oczekiwany efekt.
Usługi AI i sesja Windows.
Uruchamianie Home AI jest związane z logowaniem do Windows. Sprawdzam gotowość Docker Engine, serwerów modeli i usług wykonawczych. Dostępność API i możliwość sterowania pulpitem to osobne warunki; interfejs graficzny potrzebuje dostępnej sesji.
Cały przepływ, od wiedzy do wyniku.
HomeAI Knowledge dostarcza dokumentację i wyszukiwanie RAG. PC Operator obsługuje pliki, PowerShell, zadania i interfejs Windows. Test integracji powinien objąć wybór źródła, wywołanie narzędzia oraz sprawdzenie rzeczywistego wyniku.
Wydanie, sprawdzenie i powrót.
Przed zmianą zachowuję konfigurację i wymagane dane. Wdrażam ograniczony zakres, sprawdzam działanie i zostawiam możliwość powrotu. Publiczna strona otrzymuje własny katalog wydania, dzięki czemu jej aktualizacja jest oddzielona od usług agenta.
Dokumentacja publiczna ma własny zakres.
Opisuję role usług, zależności i sposób weryfikacji. Prywatne dane, klucze i konfiguracja dostępu pozostają poza witryną. Materiały do odtworzenia projektu będą publikowane z oddzielną konfiguracją demonstracyjną.