Ręczna instalacja GitLab Runnera na Raspberry Pi (Linux ARM64)

Ten przewodnik zawiera instrukcje krok po kroku dotyczące ręcznej instalacji GitLab Runnera na urządzeniu Raspberry Pi z systemem Linux ARM64. Metoda ta jest szczególnie przydatna w przypadkach, gdy potrzebna jest niestandardowa instalacja lub gdy automatyczne instalatory nie są odpowiednie dla danego środowiska.

Wymagania wstępne

  • Urządzenie Raspberry Pi z zainstalowanym systemem Linux ARM64.
  • Dostęp do terminala na Raspberry Pi.
  • Połączenie z internetem na Raspberry Pi.
  • Uprawnienia sudo na Raspberry Pi.

Krok 1: Pobranie GitLab Runnera

Najpierw pobierz binarkę GitLab Runnera dla Linux ARM64. Użyj poniższego polecenia, aby pobrać ją bezpośrednio do odpowiedniego katalogu:

sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-arm64"

Krok 2: Nadanie uprawnień do wykonania

Po pobraniu należy nadać plikowi GitLab Runner prawa do wykonania:

sudo chmod +x /usr/local/bin/gitlab-runner

Krok 3: Utworzenie użytkownika GitLab Runner

Ze względów bezpieczeństwa zaleca się uruchamianie GitLab Runnera jako osobny użytkownik. Możesz utworzyć nowego użytkownika specjalnie dla tej usługi:

sudo useradd –comment ‘GitLab Runner’ –create-home gitlab-runner –shell /bin/bash

Krok 4: Instalacja i uruchomienie jako usługa

Aby GitLab Runner uruchamiał się automatycznie przy starcie systemu i działał w tle, zainstaluj go jako usługę systemową:

sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start

Krok 5: Rejestracja Runnera

Po zainstalowaniu GitLab Runnera należy go zarejestrować w instancji GitLab. Będziesz potrzebować tokena rejestracyjnego z projektu GitLab (Ustawienia > CI/CD > Runnerzy):

sudo gitlab-runner register --url https://gitlab.com/ --registration-token YOUR_REGISTRATION_TOKEN

W trakcie rejestracji postępuj zgodnie z instrukcjami, konfigurując Runnera, w tym określając typ wykonawcy (np. Docker, Shell).

Krok 6: Weryfikacja instalacji

Po rejestracji sprawdź, czy GitLab Runner działa poprawnie:

sudo gitlab-runner status

Test automatycznego uruchamiania po restarcie

Aby upewnić się, że GitLab Runner uruchamia się automatycznie po restarcie, zrestartuj Raspberry Pi i ponownie sprawdź status:

sudo reboot
# Po restarcie
sudo gitlab-runner status

Podsumowanie

Udało Ci się ręcznie zainstalować GitLab Runnera na Raspberry Pi (Linux ARM64). Dzięki temu możesz wykorzystać swoje Raspberry Pi do operacji CI/CD, automatyzując procesy w swoim cyklu tworzenia oprogramowania.

Po więcej informacji i wskazówki dotyczące rozwiązywania problemów, zajrzyj do oficjalnej dokumentacji: GitLab Runner documentation.