GitLab Runner: Pierwsze kroki

Połącz swojego Stackhero GitLab Runnera z GitLab.com, Stackhero for GitLab lub własnym serwerem GitLab i uruchom swój pierwszy pipeline w kilka minut

👋 Witamy w dokumentacji Stackhero!

Stackhero oferuje prostą usługę GitLab Runner cloud, która umożliwia wydajne i bezproblemowe uruchamianie zadań GitLab CI/CD. Oto, czego możesz się spodziewać:

• Nielimitowane minuty CI/CD: uruchamiaj swoje pipeline'y tak często, jak potrzebujesz, bez rozliczania za minuty i nieprzewidzianych kosztów.
• Wiele równoczesnych zadań: przyspiesz rozwój, uruchamiając kilka zadań jednocześnie.
• Docker executor z obsługą Docker-in-Docker: łatwo buduj i wysyłaj obrazy kontenerów w ramach procesu CI/CD.
• Działa bezproblemowo zarówno z GitLab.com, jak i z instancjami self-managed GitLab.
• Prywatna, dedykowana infrastruktura z szybkim dyskiem NVMe/SSD zapewnia stabilną i przewidywalną wydajność budowania.
• Dostępne w regionach 🇪🇺 Europa oraz 🇺🇸 USA, aby dopasować się do potrzeb Twojego zespołu.

Oszczędzaj czas: możesz podłączyć swojego pierwszego GitLab Runner i rozpocząć uruchamianie pipeline'ów w zaledwie kilka minut!

Wprowadzenie

GitLab Runner to agent, który wykonuje zadania GitLab CI/CD. Za każdym razem, gdy uruchamiany jest pipeline, runner pobiera każde zadanie, uruchamia je w odizolowanym kontenerze Docker i przekazuje wyniki z powrotem do GitLab.

Dzięki Stackhero Twój runner zawsze działa na prywatnej, dedykowanej infrastrukturze. Nie ma żadnych opłat za minuty ani limitów użycia: Twoje minuty CI/CD są nielimitowane. W zależności od wybranego planu, runner może przetwarzać wiele zadań równocześnie, co pozwala łatwo skalować przepustowość buildów.

Ten przewodnik pomoże Ci połączyć runnera Stackhero z GitLab i szybko uruchomić pierwszy pipeline.

Krok 1: Utwórz GitLab Runnera na Stackhero

Na swoim dashboardzie Stackhero możesz utworzyć nową usługę GitLab Runner i wybrać plan dopasowany do Twojego workflow. Plan określa dostępne zasoby CPU, RAM oraz liczbę równoczesnych zadań (odpowiada ustawieniu concurrent w GitLab Runner: ile zadań runner może przetwarzać jednocześnie).

Twój runner będzie gotowy do użycia w około 2 minuty.

Krok 2: Utwórz runnera w GitLab

Twój runner łączy się z GitLab za pomocą tokena uwierzytelniającego runnera. Token ten generujesz w GitLab i wybierasz również zakres runnera:

• Runner projektowy: Otwórz swój projekt, następnie przejdź do Settings > CI/CD > Runners > New project runner.
• Runner grupowy: Otwórz swoją grupę, następnie przejdź do Settings > CI/CD > Runners > New group runner.
• Runner instancyjny (tylko dla samodzielnie hostowanego GitLab): Przejdź do Admin area > CI/CD > Runners > New instance runner.

Podczas tworzenia runnera możesz:

• Dodać tagi (np. docker lub stackhero), aby kierować do niego zadania.
• Zezwolić na uruchamianie zadań bez tagów, jeśli chcesz, aby runner obsługiwał wszystkie zadania, także te bez tagów.

GitLab wygeneruje token uwierzytelniający runnera zaczynający się od glrt-. Zachowaj ten token w bezpiecznym miejscu, ponieważ runner używa go do uwierzytelniania w GitLab.

Poprzedni sposób rejestracji z użyciem registration token jest przestarzały. Użyj tokena uwierzytelniającego runnera (glrt-...) utworzonego podczas dodawania runnera, jak opisano powyżej.

Więcej szczegółów znajdziesz w oficjalnej dokumentacji rejestracji runnerów GitLab.

Krok 3: Połącz runnera

Wróć do swojego dashboardu Stackhero, otwórz konfigurację usługi GitLab Runner i wprowadź następujące dane:

• GitLab URL: Użyj https://gitlab.com dla GitLab.com lub adresu swojej instancji GitLab. (Jeśli korzystasz z GitLab na Stackhero, może to być np. https://git.twoja-firma.com.)
• Token uwierzytelniający runnera (glrt-...) uzyskany w Kroku 2.
• Liczba równoczesnych zadań, które chcesz dopuścić.

Po zapisaniu konfiguracji runner połączy się z GitLab i pojawi się jako online na stronie Runners, gdzie został skonfigurowany.

Krok 4: Uruchom pierwszy pipeline

Dodaj plik .gitlab-ci.yml w katalogu głównym repozytorium, aby zdefiniować pipeline:

stages:
  - build
  - test

build:
  stage: build
  image: node:22
  script:
    - npm ci
    - npm run build

test:
  stage: test
  image: node:22
  script:
    - npm test

Zacommituj i wypchnij zmiany. GitLab uruchomi pipeline, a Twój runner Stackhero wykona zadania. Jeśli podczas tworzenia runnera dodałeś tagi, możesz kierować do nich zadania w ten sposób:

build:
  stage: build
  tags:
    - stackhero
  image: node:22
  script:
    - npm ci
    - npm run build

Twoje pipeline'y będą teraz uruchamiane na dedykowanym runnerze, z nielimitowanymi minutami buildów i bez ograniczeń użycia.

Następny krok

Jeśli chcesz budować i wysyłać obrazy Docker z pipeline'ów, przejdź do Budowanie obrazów Docker.