Self-hosted runners dla środowisk lokalnych

Witamy w świecie self-hosted runnerów! Są to zaawansowane narzędzia, które pozwalają uruchamiać workflow GitHub Actions na własnych maszynach.

Zamiast korzystać z runnerów działających w chmurze GitHub, mogą Państwo używać własnego sprzętu, systemu operacyjnego i środowiska sieciowego do wykonywania zadań CI/CD.

Choć runnery hostowane przez GitHub są wygodne, self-hosted runnery oferują wyjątkowe zalety:

• Określony sprzęt: Korzystanie z niestandardowego sprzętu, takiego jak procesory GPU lub konkretne architektury CPU.
• Dostęp do sieci: Bezpośrednie łączenie się z prywatnymi sieciami i zasobami (bazami danych, usługami wewnętrznymi).
• Bezpieczeństwo: Utrzymywanie wrażliwych środowisk kompilacji we własnej, kontrolowanej infrastrukturze.
• Optymalizacja kosztów: Potencjalne ograniczenie kosztów przy dużym obciążeniu dzięki wykorzystaniu istniejącej infrastruktury.

Aby skonfigurować runnera samodzielnie hostowanego, Państwa komputer musi spełniać kilka podstawowych wymagań:

• System operacyjny: Obsługiwane są systemy Linux, Windows i macOS.
• Dostęp do sieci: Komputer z runnerem musi mieć możliwość komunikowania się z GitHub.com (lub GitHub Enterprise Server).
• Zasoby: Należy zapewnić wystarczającą moc procesora, pamięć RAM i miejsce na dysku, aby obsługiwać zadania workflow.
• Oprogramowanie: Na runnerze muszą być zainstalowane wszystkie narzędzia lub zestawy SDK wymagane przez workflow.

Konfiguracja runnera samodzielnie hostowanego obejmuje kilka kluczowych kroków. To tak, jakby przygotowywali Państwo swój komputer do roli dedykowanego wykonawcy zadań GitHub Actions:

1. Wygenerowanie unikatowego tokenu rejestracyjnego w GitHub.
2. Pobranie i rozpakowanie aplikacji runnera na komputerze.
3. Skonfigurowanie runnera za pomocą adresu URL repozytorium lub organizacji GitHub oraz tokenu.
4. Uruchomienie aplikacji runnera, aby nasłuchiwała zadań.

Najpierw należy poinformować GitHub o konfigurowaniu nowego runnera. Wymaga to unikatowego tokenu.

Proszę przejść do ustawień repozytorium lub organizacji w GitHub.com:

• W przypadku repozytorium: Settings > Actions > Runners > New self-hosted runner
• W przypadku organizacji: Settings > Actions > Runners > New self-hosted runner

Proszę postępować zgodnie z instrukcjami, aby wygenerować token. Token ten służy wyłącznie do rejestracji.

Następnie należy pobrać aplikację runnera na wybrany komputer. Interfejs GitHub wyświetli konkretne polecenia odpowiednie dla używanego systemu operacyjnego.

Na przykład na komputerze z systemem Linux można użyć:

Po rozpakowaniu należy skonfigurować runnera. Spowoduje to połączenie go z repozytorium lub organizacją GitHub i umożliwi ustawienie etykiet.

Należy uruchomić skrypt config.sh (Linux/macOS) lub config.cmd (Windows). Trzeba podać adres URL GitHub oraz wcześniej wygenerowany token.

Po skonfigurowaniu można uruchomić aplikację runnera. Połączy się ona z GitHub i będzie oczekiwać na zadania.

Wystarczy uruchomić ./run.sh (Linux/macOS) lub run.cmd (Windows). W środowiskach produkcyjnych zaleca się zainstalowanie runnera jako usługi, aby uruchamiał się automatycznie.

Aby użyć runnera samodzielnie hostowanego, należy wskazać go w pliku YAML workflow za pomocą słowa kluczowego runs-on. Można użyć wartości self-hosted lub konkretnych etykiet przypisanych podczas konfiguracji.

Wiedzą już Państwo, czym są runnery samodzielnie hostowane! Umożliwiają one wykonywanie workflow GitHub Actions we własnej infrastrukturze, zapewniając kontrolę nad sprzętem, dostępem do sieci i bezpieczeństwem.

Omówiliśmy proces konfiguracji: generowanie tokenu, pobieranie aplikacji, konfigurowanie i uruchamianie runnera. Zobaczyli Państwo również, jak kierować zadania do własnych runnerów w plikach YAML workflow za pomocą runs-on.