armactl — narzędzie do zarządzania serwerami i operatorami w Python/Linux
Linux i Unix
armactl — to narzędzie Python/Linux do instalacji, zarządzania, naprawy, monitorowania i administracji Arma Reforger Dedicated Server. Projekt rozpoczął się jako narzędzie CLI/TUI do zarządzania serwerem, ale rozwinął się w znacznie szerszy system narzędzi operatorskich z interfejsem webowym, konfiguracjami workflow, analizą telemetryczną/stanu, procesami naprawczymi, zarządzaniem usługami i kontrolowanymi działaniami administracyjnymi.
Główną wartością projektu jest nie tylko uruchomienie serwera, ale stabilne zarządzanie jego cyklem życia: instalacja od podstaw, wykrywanie istniejącej instalacji, sprawdzanie stanu, edytowanie konfiguracji, zarządzanie usługami systemd, praca z modami, integracja z Telegram/admin, diagnozowanie problemów i przywracanie po nieprawidłowych stanach.
Szczególnie skomplikowaną częścią stała się gałąź webowa: przekształca armactl w wygodny panel operatorski dla środowiska serwerowego. Ważne są nie tylko UI i trasy, ale także prawidłowe granice między warstwą webową, logiką rdzenia, workflow, audytem/sprawdzaniem bezpieczeństwa i rzeczywistymi operacjami systemowymi. Dla takich działań krytycznie ważne jest, aby nie mieszać logiki biznesowej z UI, nie wykonywać niebezpiecznych operacji bez sprawdzeń i zachować zrozumiały źródło prawdy dla konfiguracji i stanu runtime.
W projekcie wdrożono podejście skoncentrowane na użyciu podobnym do produkcyjnego: sprawdzenia przed działaniami, logika naprawy/odzyskiwania, strukturalne logi, testowanie, ręczna walidacja, audyty, dokumentacja, notatki o wydaniach i kontrolowane zmiany zamiast przypadkowych szybkich poprawek.
Kluczowe obszary pracy:
Rozwój Python CLI/TUI
Automatyzacja serwerów Linux
Zarządzanie Arma Reforger Dedicated Server
Zarządzanie usługami systemd
Procesy instalacji i naprawy
Odkrywanie istniejących serwerów
Zarządzanie konfiguracją
Zarządzanie modami
Analiza telemetryczna i stanu
Integracja z Telegram/admin
Rozwój webowego panelu operatorskiego
Workflow z uwzględnieniem audytu/bezpieczeństwa
Strukturalne logowanie i walidacja
Testy, ręczne kontrole i pakowanie wydań
Technologie: Python, Linux, systemd, CLI, TUI, interfejs webowy, zarządzanie usługami, workflow konfiguracji, Telegram Bot API, pytest, ruff, strukturalne logowanie
Główną wartością projektu jest nie tylko uruchomienie serwera, ale stabilne zarządzanie jego cyklem życia: instalacja od podstaw, wykrywanie istniejącej instalacji, sprawdzanie stanu, edytowanie konfiguracji, zarządzanie usługami systemd, praca z modami, integracja z Telegram/admin, diagnozowanie problemów i przywracanie po nieprawidłowych stanach.
Szczególnie skomplikowaną częścią stała się gałąź webowa: przekształca armactl w wygodny panel operatorski dla środowiska serwerowego. Ważne są nie tylko UI i trasy, ale także prawidłowe granice między warstwą webową, logiką rdzenia, workflow, audytem/sprawdzaniem bezpieczeństwa i rzeczywistymi operacjami systemowymi. Dla takich działań krytycznie ważne jest, aby nie mieszać logiki biznesowej z UI, nie wykonywać niebezpiecznych operacji bez sprawdzeń i zachować zrozumiały źródło prawdy dla konfiguracji i stanu runtime.
W projekcie wdrożono podejście skoncentrowane na użyciu podobnym do produkcyjnego: sprawdzenia przed działaniami, logika naprawy/odzyskiwania, strukturalne logi, testowanie, ręczna walidacja, audyty, dokumentacja, notatki o wydaniach i kontrolowane zmiany zamiast przypadkowych szybkich poprawek.
Kluczowe obszary pracy:
Rozwój Python CLI/TUI
Automatyzacja serwerów Linux
Zarządzanie Arma Reforger Dedicated Server
Zarządzanie usługami systemd
Procesy instalacji i naprawy
Odkrywanie istniejących serwerów
Zarządzanie konfiguracją
Zarządzanie modami
Analiza telemetryczna i stanu
Integracja z Telegram/admin
Rozwój webowego panelu operatorskiego
Workflow z uwzględnieniem audytu/bezpieczeństwa
Strukturalne logowanie i walidacja
Testy, ręczne kontrole i pakowanie wydań
Technologie: Python, Linux, systemd, CLI, TUI, interfejs webowy, zarządzanie usługami, workflow konfiguracji, Telegram Bot API, pytest, ruff, strukturalne logowanie