Jak samodzielnie hostować Superlog dla logów AI
Instrukcja wdrożenia Superlog na własnym VPS. Dowiedz się, jak skonfigurować Postgres, ClickHouse i kolektor OTLP, aby automatycznie grupować logi w incydenty przy użyciu AI.
Co faktycznie instaluje samodzielnie hostowany Superlog
Aby samodzielnie hostować Superlog, należy sklonować repozytorium, uruchomić Postgres, ClickHouse oraz kolektor OpenTelemetry za pomocą Docker Compose, wykonać jedną migrację bazy danych, a następnie uruchomić cztery usługi Node z kodu źródłowego. Aplikacje wysyłają ślady (traces), logi i metryki OTLP (OpenTelemetry protocol) na port wejściowy, Superlog tworzy ich odciski palców (fingerprints), grupuje powtarzające się zdarzenia w pojedynczy incydent, a domyślny agent społecznościowy zapisuje lokalne podsumowanie incydentu. Instalacja zajmuje jedno popołudnie. Przed rozpoczęciem warto zapoznać się z wymaganiami dotyczącymi zasobów oraz rzeczywistymi ograniczeniami.
Superlog jest udostępniany na licencji Apache 2.0 i znajduje się pod adresem github.com/superloglabs/superlog. Według stanu na 13 października 2026 posiada około 1.5k gwiazdek, około 490 commitów w main i brak jakichkolwiek tagów wydań. Należy samodzielnie przypiąć konkretny commit zamiast uruchamiać wersję, która akurat znajdowała się w main w dniu klonowania repozytorium.
Na jakie pytania odpowiada Superlog, na które nie odpowiadają Uptime Kuma i Langfuse
Narzędzia do monitoringu typu self-hosted z zewnątrz wydają się zamienne. Tak nie jest, a uruchomienie niewłaściwego narzędzia powoduje niepotrzebne obciążenie serwera bez żadnych korzyści.
- Uptime Kuma sonduje punkty końcowe z zewnątrz i odpowiada na jedno pytanie: czy usługa działa.
- Zabbix monitoruje hosty i usługi na Ubuntu 24.04, sprawdzając użycie procesora, pamięci, dysku oraz stan usług względem zdefiniowanych progów.
- Langfuse śledzi wywołania LLM, rejestrując prompt, model, tokeny, opóźnienie oraz koszt każdego z nich.
- Superlog pobiera telemetrię, którą standardowe usługi już emitują, i przekształca powtarzające się awarie w incydenty.
Superlog odpowiada na inne pytanie: coś przestało działać, co dokładnie i dlaczego. Narzędzie to nie analizuje wywołań LLM i nie sonduje usług z zewnątrz. Pobiera dane OTLP bezpośrednio z kodu aplikacji i umieszcza agenta na etapie wstępnej analizy (triage), czyli wykonuje pierwszą czynność, którą i tak musiałby wykonać inżynier dyżurny.
Kluczową różnicą z punktu widzenia budżetu VPS jest sposób przechowywania danych. Superlog wykorzystuje bazę kolumnową, ponieważ telemetria jest zapisywana jednokrotnie, a następnie odpytywana w określonych przedziałach czasowych dla milionów wierszy. Do tego służy ClickHouse, a nie Postgres. Postgres pozostaje w stosie technologicznym, przechowując niewielkie dane relacyjne: projekty, użytkowników, incydenty oraz klucze ingestii.
Co faktycznie uruchamia polecenie docker compose up -d?
Trzy kontenery, z których żaden nie jest Superlog. Jest to zaskakujące dla osób oczekujących instalacji za pomocą jednego polecenia.
postgres:16, opublikowany na porcie hosta 5434clickhouse/clickhouse-server:26.1, na porcie 8123 dla HTTP oraz 9000 dla protokołu natywnegootel/opentelemetry-collector-contrib:0.150.1, na porcie 4317 dla gRPC oraz 4318 dla OTLP przez HTTP
Aplikacje Superlog działają na hoście, uruchamiane ze źródeł przez pnpm dev. Na dzień 13 października 2026 w repozytorium nie ma produkcyjnego pliku compose, więc długotrwała instalacja wymaga własnych jednostek systemd lub plików Dockerfile dla poszczególnych aplikacji zawartych w drzewie plików. Aplikacje api, worker oraz proxy posiadają skrypt start, który może zostać opakowany w jednostkę systemd. Aplikacja web nie posiada takiego skryptu: jest to aplikacja Vite, więc należy ją zbudować za pomocą skryptu build i serwować wynik jako pliki statyczne przez nginx lub Caddy, albo uruchomić jej skrypt preview, który jest vite preview.
Należy zapamiętać ścieżkę, którą pokonuje sygnał, ponieważ każda awaria opisana poniżej stanowi przerwanie jednego z jej etapów. Aplikacja wysyła dane OTLP do proxy wejściowego Superlog. Proxy uwierzytelnia żądanie za pomocą klucza ingest, dodaje identyfikator projektu i przekazuje je do kolektora. Kolektor usuwa wszelkie atrybuty superlog.*, które klient próbował ustawić, dodaje superlog.project_id z nagłówka dostarczonego przez proxy, grupuje dane i zapisuje je w ClickHouse. Następnie aplikacja web oraz API odczytują dane telemetryczne z ClickHouse, a pozostałe informacje z Postgres.
Usuwanie atrybutów to realna kontrola wielodostępności (multi-tenancy), a nie tylko dekoracja. Bez tego mechanizmu każdy posiadacz ważnego klucza ingest mógłby samodzielnie ustawić superlog.project_id i zapisywać dane wewnątrz projektu należącego do innego użytkownika.
Jak duże zasoby VPS są wymagane?
Należy zaplanować 4 vCPU, 8 GB pamięci RAM oraz 40 GB przestrzeni SSD dla instalacji jednowęzłowej przy niskim wolumenie danych wejściowych. Jest to minimalna konfiguracja początkowa, a nie docelowy pomiar, dlatego należy traktować ją jako punkt wyjścia i zweryfikować pod kątem rzeczywistego ruchu.
Pamięć RAM jest wykorzystywana w czterech obszarach. ClickHouse jest zaprojektowany dla maszyn z dużą ilością pamięci, a jego ustawienia domyślne opierają się na tym założeniu. Postgres 16 ma skromniejsze wymagania, ponieważ przechowuje metadane, a nie telemetrię. Kolektor również nie jest zasobożerny. Cztery procesy Node obejmują serwer programistyczny Vite oraz trzy procesy tsx watch; należy zmierzyć ich zużycie pamięci na własnej infrastrukturze.
Dysk stanowi mniej oczywisty problem. pnpm install w tym monorepo pobiera AWS SDK, klienta ClickHouse, OpenTelemetry SDK oraz łańcuch narzędzi React, zanim jeszcze zostanie przetworzony jakikolwiek span. Następnie ClickHouse rozrasta się wraz z ruchem. Należy monitorować oba parametry:
df -h /
free -m
docker stats --no-stream
docker compose exec clickhouse clickhouse-client --database superlog --query "SELECT table, formatReadableSize(sum(bytes_on_disk)) AS size FROM system.parts WHERE active AND database = 'superlog' GROUP BY table ORDER BY sum(bytes_on_disk) DESC"Największym obciążeniem są nagłe skoki ruchu: nieudane wdrożenie generujące tysiące identycznych błędów na minutę. Mechanizm fingerprintingu scala je w jeden incydent dla użytkownika, jednak ClickHouse nadal zapisuje każdy wiersz w bazie.
Okres retencji danych zależy od konfiguracji użytkownika. Eksporter ClickHouse w kolektorze tworzy tabele otel_traces, otel_logs oraz po jednej tabeli dla każdego typu metryki. Mechanizm czasu życia (TTL) jest stosowany tylko wtedy, gdy konfiguracja w infra/collector/config.yaml go definiuje. Dane nie są usuwane automatycznie, więc przy dużym natężeniu ruchu dysk zapełni się, jeśli nie zostanie zaplanowana odpowiednia polityka retencji.
Instalacja z przypiętego commita
git clone https://github.com/superloglabs/superlog.git
cd superlog
git tag -l
git log -1 --format='%H %cs %s'git tag -l brak danych wyjściowych jest oczekiwanym rezultatem na dzień 13 października 2026. Należy wybrać przetestowany commit i pozostać przy nim:
git checkout 0d3a6c8bb63eda3493e6ba0003e7c2a70750bc1eNastępnie łańcuch narzędzi:
node -v
corepack enable
corepack prepare pnpm@9.12.0 --activate
pnpm -vpackage.json deklaruje engines.node jako >=20.0.0 oraz packageManager jako pnpm@9.12.0. Niekompatybilna wersja Node nie przerywa automatycznie instalacji: wymuszanie silnika zależy od konfiguracji, a pnpm 9.12.0 posiada ścieżkę ostrzegawczą, gdy engineStrict jest wyłączone. Pakiet nodejs w archiwum Ubuntu 24.04 jest starszy niż 20, dlatego należy zainstalować Node 20 lub nowszy z NodeSource albo za pomocą nvm. Repozytorium dostarcza .nvmrc, więc nvm use wybiera zamierzoną wersję, jeśli używany jest nvm.
pnpm install
docker compose up -d
docker compose psNależy poczekać na zakończenie testów stanu (health checks), zamiast zakładać, że up -d oznacza gotowość. Zarówno Postgres, jak i ClickHouse deklarują je w pliku compose:
curl -sS http://127.0.0.1:8123/ping
pg_isready -h 127.0.0.1 -p 5434 -U postgresClickHouse odpowiada Ok., a pg_isready odpowiada accepting connections. Błąd connection refused na porcie 8123 oznacza, że kontener nadal się uruchamia lub uległ awarii. docker compose logs clickhouse wskazuje przyczynę, a docker inspect $(docker compose ps -q clickhouse) | grep -i oomkilled raportuje true, gdy jądro systemu przerwało proces z powodu braku pamięci, co sugeruje zbyt małe zasoby serwera, a nie błąd konfiguracji.
Następnie migracja i aplikacje:
pnpm --filter @superlog/db db:migrate
pnpm devNależy zwrócić uwagę na port: 5434, a nie 5432. Plik compose publikuje Postgres na porcie 5434, aby uniknąć konfliktu z instancją Postgres zainstalowaną na hoście, a pliki .env.example aplikacji są zgodne z DATABASE_URL=postgres://postgres:postgres@localhost:5434/superlog. Skierowanie migracji na port 5432 na serwerze, na którym już działa Postgres, spowoduje odmowę połączenia lub, co gorsza, wykonanie migracji na niewłaściwej bazie danych.
pnpm dev uruchamia turbo run dev, co inicjuje skrypt dev każdej aplikacji przez Turborepo, w tym api, web, worker oraz proxy, z wyjściem połączonym w jednym terminalu. Plik Procfile repozytorium wymienia te same cztery procesy i przekierowuje wyjście każdego z nich do tmp/logs/. Należy uruchomić go za pomocą narzędzia typu Procfile runner, takiego jak overmind lub foreman, zamiast pnpm dev, jeśli tail -f tmp/logs/proxy.log ma służyć do monitorowania ingestu. README umieszcza aplikację web na http://localhost:5173, API na http://localhost:4100, a przyjmowanie danych OTLP na http://localhost:4101.
Należy potwierdzić, co faktycznie zostało powiązane przed skierowaniem ruchu:
ss -lntp | grep -E '4000|4100|4101|5173'
curl -sS http://127.0.0.1:4101/healthJest to istotne w dalszej części. Proxy odczytuje własny port ze zmiennej środowiskowej PORT i przyjmuje wartość domyślną 4000, gdy PORT nie jest ustawione, a ładowany przez nie apps/proxy/.env.example również ustawia PORT=4000, mimo że README wymienia port 4101 dla przyjmowania danych (stan na 13 października 2026). Należy użyć portu wskazanego przez ss. Poniższe przykłady używają 4101, więc należy zamienić go na 4000, jeśli to ten port został powiązany. Własna jednostka systemd nie ustawia niczego, chyba że zawiera PORT, więc eksporter skierowany na 4101 przeciwko proxy nasłuchującemu na 4000 zakończy się błędem connection refused bez dodatkowych informacji.
Wysłanie śladu, wygenerowanie błędu, zaobserwowanie incydentu
Utwórz projekt w aplikacji webowej i skopiuj jego klucz ingest. Punkt wejściowy (intake) uwierzytelnia każde żądanie za pomocą tego klucza, więc telemetria wysłana bez niego nigdy nie dotrze do ClickHouse.
Skieruj dowolny OpenTelemetry SDK na punkt wejściowy, używając standardowych zmiennych środowiskowych:
export OTEL_SERVICE_NAME=checkout-api
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4101
export OTEL_EXPORTER_OTLP_HEADERS='x-api-key=YOUR_INGEST_KEY'Punkt wejściowy odczytuje klucz z nagłówka x-api-key, akceptuje również authorization: bearer YOUR_INGEST_KEY, jeśli konfiguracja eksportera jest w ten sposób łatwiejsza. Obsługuje trzy standardowe ścieżki OTLP: /v1/traces, /v1/logs oraz /v1/metrics, a także /health.
Warto zwrócić uwagę na jedną pułapkę. OTEL_EXPORTER_OTLP_ENDPOINT jest bazowym adresem URL, do którego SDK automatycznie dołącza ścieżkę sygnału. Zmienne specyficzne dla sygnału, takie jak OTEL_EXPORTER_OTLP_TRACES_ENDPOINT, są używane dokładnie w podanej formie, bez dołączania ścieżki. Ustawienie zmiennej specyficznej dla sygnału na http://127.0.0.1:4101 spowoduje, że każdy eksport trafi do /, co nie jest poprawną trasą. W rezultacie dane nie dotrą do celu, a SDK zaloguje błąd eksportu, podczas gdy aplikacja będzie wyglądać na działającą poprawnie.
W przypadku usługi Node wystarczy ścieżka bezkodowa (zero code), aby zweryfikować potok:
npm install @opentelemetry/api @opentelemetry/auto-instrumentations-node
node --require @opentelemetry/auto-instrumentations-node/register server.jsTeraz celowo wywołaj błąd. Wystarczy dowolna trasa, która zgłasza wyjątek:
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3000/boomSprawdź kolejne etapy przesyłu, ponieważ pierwsza luka wskaże miejsce awarii:
tail -n 50 tmp/logs/proxy.log
docker compose exec clickhouse clickhouse-client --database superlog --query 'SELECT count() FROM otel_traces'Rosnąca liczba w otel_traces przy pustej aplikacji webowej oznacza niedopasowanie projektu, więc sprawdź, do którego projektu przypisany jest klucz ingest. Stała liczba przy widocznej aktywności w logach proxy wskazuje na problem z kolektorem lub zapisem do ClickHouse, więc przejrzyj docker compose logs collector. Brak aktywności w logach proxy oznacza, że eksporter nigdy nie dotarł do punktu wejściowego: przyczyną może być błędny port, błędna ścieżka lub odrzucony klucz.
W aplikacji webowej powtarzające się awarie trafiają jako jeden incydent, zamiast tworzyć osobny wiersz dla każdego żądania. Superlog tworzy odciski palców przychodzących sygnałów i grupuje pasujące do siebie, co stanowi różnicę między skrzynką odbiorczą zawierającą 4000 identycznych błędów a stroną wyświetlającą jeden incydent. Domyślny agent społecznościowy rejestruje następnie lokalne podsumowanie incydentu dla danej grupy.
Badanie oparte na modelu wymaga dostawcy modelu oraz skonfigurowanego kompatybilnego agenta; domyślny agent społecznościowy rejestruje lokalne podsumowanie. Nazwy zmiennych należy pobierać z pliku .env.example znajdującego się wewnątrz każdego katalogu aplikacji w przypiętym commicie, a nie z zewnętrznych opisów, ponieważ zmieniają się one wraz z main. To samo dotyczy integracji z GitHub i Sentry, które posiadają własną dokumentację konfiguracji pod adresami docs/github-app-setup.md oraz docs/sentry-app-setup.md, a ładunki webhooków są opisane w docs/webhooks.md.
Ograniczenie dostępu do danych wejściowych i tryb tylko do odczytu dla agenta
Docker domyślnie publikuje porty kontenerów na adresie 0.0.0.0, a te opublikowane porty omijają ufw. Docker kieruje ruch kontenerów w tablicy nat, więc pakiet skierowany na opublikowany port jest przekierowywany, zanim dotrze do łańcuchów INPUT i OUTPUT, w których znajdują się reguły ufw, przez co ufw nie ma wpływu na ten ruch. Na serwerze VPS z publicznym adresem IP, dostarczony plik compose udostępnia interfejs HTTP ClickHouse na porcie 8123 oraz Postgres na 5434, co czyni je dostępnymi z Internetu. Poświadczenia w tym pliku to domyślne ustawienia programistyczne: użytkownik ClickHouse default z pustym hasłem oraz Postgres z postgres jako użytkownik i hasło.
Powiąż te usługi z interfejsem zwrotnym (loopback). Każdy opublikowany port w pliku compose pobiera swoją stronę hosta ze zmiennej środowiskowej, więc plik .env w katalogu głównym repozytorium jest wystarczający:
POSTGRES_HOST_PORT=127.0.0.1:5434
CLICKHOUSE_HTTP_HOST_PORT=127.0.0.1:8123
CLICKHOUSE_TCP_HOST_PORT=127.0.0.1:9000
COLLECTOR_GRPC_HOST_PORT=127.0.0.1:4317
COLLECTOR_HTTP_HOST_PORT=127.0.0.1:4318Zweryfikuj wynik przed zaufaniem mu, a następnie odtwórz kontenery:
docker compose config
docker compose up -d
ss -lntp | grep -E '5434|8123|9000|4317|4318'docker compose config wyświetla przetworzony plik, dzięki czemu można odczytać 127.0.0.1:5434:5432 zamiast zgadywać. ss powinno wtedy pokazywać 127.0.0.1:5434, a nigdy 0.0.0.0:5434. Ponowna deklaracja ports w pliku nadpisującym Compose zachowuje oba powiązania, gdy adres IP hosta jest inny; Compose w wersji 2.24.4 i nowszych obsługuje ports: !override w celu zastąpienia listy.
Dane wejściowe wymagają takiej samej ochrony. Klucz ingest jest przesyłany w nagłówku, więc wymaga TLS (transport layer security) przed nim: zakończ TLS w nginx lub Caddy przed proxy albo utrzymuj ingest wewnątrz sieci prywatnej lub tunelu WireGuard. Aplikacja webowa na porcie 5173 to serwer deweloperski Vite i nie powinna być w ogóle wystawiona na dostęp z Internetu.
Następnie sam agent. Założeniem Superlog jest to, że agent analizuje i proponuje poprawkę, a słowo „proponuje” jest kluczowe. Utrzymuj dostęp tylko do odczytu w środowisku produkcyjnym, dopóki nie zaobserwujesz jego działania podczas kilku rzeczywistych incydentów. Aplikacja GitHub App z uprawnieniami tylko do odczytu nie może wypchnąć gałęzi z poprawką ani otwierać pull requests: przewodnik konfiguracji wymaga uprawnień zapisu Contents i Pull requests dla tego przepływu pracy, a także uprawnień zapisu Issues dla komentarzy. Agent, który odczytuje telemetrię i zapisuje poprawkę, jest użyteczny. Agent, który może restartować usługi, stanowi inny poziom ryzyka i powinna to być świadoma decyzja, a nie domyślne ustawienie. Koszty wymagają takiej samej uwagi podczas konfigurowania uruchomieniowego opartego na modelu: budżet na wydatki agenta na VPS przed skierowaniem go na obciążony system produkcyjny, oraz prowadź rejestr działań wykonanych przez agenta, aby zaskakujący pull request posiadał ścieżkę audytu.
Błędy, które wystąpią, oraz ciągi znaków je identyfikujące
ERR_PNPM_UNSUPPORTED_ENGINEpodczaspnpm installoznacza niezgodność wymagań silnika. pnpm 9.12.0 sprawdza wymagania zarówno dla Node, jak i pnpm; należy odczytać wymagane i bieżące wersje w komunikacie błędu, a następnie sprawdzićnode -vorazpnpm -v.ECONNREFUSED 127.0.0.1:5434podczas migracji oznacza, że stos compose nie jest uruchomiony lubDATABASE_URLwskazuje błędny port.- Należy sprawdzić restarty ClickHouse za pomocą
docker compose logs clickhouse, a następnie zweryfikować, czy w kontenerzeOOMKilledma wartośćtrue. - Eksporter zgłaszający sukces, podczas gdy aplikacja webowa pozostaje pusta, zazwyczaj oznacza, że dane trafiły bezpośrednio do kolektora na port 4318, co pomija stemplowanie projektu wykonywane przez proxy.
- Błąd Connection refused na porcie 4101 zazwyczaj oznacza, że proxy nasłuchuje na porcie 4000, czyli porcie domyślnym, do którego wraca kod, i który jest ustawiony w
.env.example. Należy jawnie ustawićPORTw pliku jednostki lub w.envaplikacji. docker compose pswyświetlające0.0.0.0:8123oznacza, że powiązania z interfejsem loopback nie są aktywne. Należy uruchomićdocker compose configi odczytać rozpoznane porty.
Flawless, HyperProbe oraz rola Superlog
Ta kategoria jest nowa, a narzędzia różnią się zakresem uprawnień przyznawanych agentowi. Repozytorium Flawless udostępnia obecnie CISRE, platformę AI SRE (site reliability engineering) dla Kubernetes i infrastruktury chmurowej, na licencji PolyForm Noncommercial. HyperProbe umieszcza sondy wewnątrz uruchomionego procesu w celu przechwycenia stanu zmiennych i udostępnia ten stan asystentowi za pośrednictwem protokołu MCP (model context protocol); dokumentuje również samodzielne hostowanie przy użyciu Docker Compose oraz klucza licencyjnego.
Superlog znajduje się pomiędzy tymi dwoma rozwiązaniami. Zarządza potokiem danych od początku do końca, od przyjmowania danych OTLP aż po przechowywanie w ClickHouse, a agenta umieszcza na etapie segregacji (triage), a nie na etapie naprawy. Taka konstrukcja sprawia, że samodzielne hostowanie tego narzędzia jest decyzją infrastrukturalną, a nie tylko uruchomieniem kontenera, o którym można zapnąć. Po uruchomieniu Superlog użytkownik zarządza kolumnową bazą danych, która wymaga takiej samej uwagi, jak każda inna posiadana baza danych.
FAQ
Ile pamięci RAM wymaga samodzielnie hostowany Superlog?
Należy zaplanować 8 GB pamięci RAM, 4 vCPU oraz 40 GB miejsca na dysku dla pojedynczego węzła przy niskim wolumenie danych wejściowych. Stos technologiczny obejmuje Postgres, ClickHouse, OpenTelemetry collector oraz cztery procesy Node, a ClickHouse wymaga zapasu pamięci. Wartości należy zmierzyć samodzielnie za pomocą docker stats --no-stream oraz free -m, zamiast polegać na jakichkolwiek opublikowanych danych, w tym tych zawartych w niniejszym dokumencie.
Na który port skierować eksporter OTLP?
Na proxy wejściowe Superlog, które zgodnie z plikiem README znajduje się na http://localhost:4101. Obsługuje ono /v1/traces, /v1/logs oraz /v1/metrics i uwierzytelnia się za pomocą klucza ingest projektu pobranego z nagłówka x-api-key lub nagłówka authorization: bearer. Port 4318 obsługuje znajdujący się poniżej OpenTelemetry collector, a bezpośrednie eksportowanie danych w to miejsce pomija proxy, czyli komponent przypisujący identyfikator projektu do danych. Proxy wraca do portu 4000, gdy PORT nie jest ustawione, a jego .env.example również ustawia 4000, dlatego należy uruchomić ss -lntp i potwierdzić powiązanie portu przed założeniem, że jest to 4101.
Czy Superlog zastępuje Uptime Kuma lub Zabbix?
Nie. Uptime Kuma odpowiada na pytanie, czy punkt końcowy odpowiada spoza sieci, a Zabbix monitoruje metryki hosta i usług względem zdefiniowanych progów. Superlog przetwarza ślady (traces), logi i metryki emitowane przez aplikacje oraz grupuje powtarzające się awarie w incydenty. Należy zachować zewnętrzną sondę uptime, ponieważ sonda działająca w innej lokalizacji zgłosi awarię, gdy serwer obsługujący potok telemetryczny przestanie działać.
Czy agent Superlog może zmieniać systemy produkcyjne?
Tylko w zakresie przyznanych uprawnień. Domyślny runner społecznościowy rejestruje lokalne podsumowanie incydentu; inne środowiska uruchomieniowe do analizy zależą od skonfigurowanego runnera. Uprawnienia produkcyjne należy ograniczyć do odczytu; otwieranie pull requests wymaga osobnych uprawnień zapisu w GitHub dla gałęzi i pull requests. Dostęp do zapisu na produkcji należy traktować jako osobną, świadomą decyzję, ponieważ agent z możliwością restartowania usług stanowi znacznie większe ryzyko niż agent, który jedynie odczytuje telemetrię i przygotowuje poprawkę do przeglądu.
Czy przypiąć konkretny commit, czy śledzić gałąź main?
Należy przypiąć commit. Na dzień 13 października 2026 w repozytorium nie było tagów wersji. Należy zapisać przetestowany SHA, wdrożyć tę wersję i zapoznać się z różnicami (diff) przed aktualizacją. git log --oneline <old-sha>..main służy do przeglądu, a pliki .env.example dla poszczególnych aplikacji są pierwszym miejscem, w którym należy szukać nowo wymaganych zmiennych po każdej aktualizacji.