GitLab Runner: Pierwsze kroki

Połącz swojego Stackhero GitLab Runnera z GitLab.com lub własną instancją GitLab i uruchom swój pierwszy pipeline

👋 Witamy w dokumentacji Stackhero!

Stackhero oferuje łatwe w użyciu rozwiązanie GitLab Runner cloud, zaprojektowane do wydajnej obsługi zadań GitLab CI/CD. Oto, czego możesz się spodziewać:

• Nielimitowane minuty CI/CD: brak rozliczania za minuty, więc Twoje pipeline'y mogą działać zawsze, gdy tego potrzebujesz.
• Wiele równoczesnych zadań: uruchamiaj kilka jobów jednocześnie, aby przyspieszyć cały pipeline.
• Docker executor z obsługą Docker-in-Docker: usprawnij budowanie i wysyłanie swoich obrazów kontenerów.
• Kompatybilny zarówno z GitLab.com, jak i każdą samodzielnie zarządzaną instancją GitLab.
• Prywatna, dedykowana maszyna wirtualna (VM) oparta na szybkich dyskach NVMe/SSD, zapewniająca stabilne i niezawodne buildy.
• Dostępny w regionach 🇪🇺 Europa oraz 🇺🇸 USA.

Oszczędzaj czas: możesz podłączyć swojego pierwszego GitLab Runnera i uruchomić pipeline'y w zaledwie kilka minut!

Wprowadzenie

GitLab Runner to agent odpowiedzialny za wykonywanie zadań CI/CD w GitLab. Za każdym razem, gdy pipeline zostaje uruchomiony, runner pobiera każde zadanie, wykonuje je w czystym kontenerze Docker, a następnie przekazuje wyniki z powrotem do GitLab.

W Stackhero Twój runner działa na prywatnej, dedykowanej maszynie wirtualnej (VM). Nie ma żadnych opłat za minuty ani limitów wykorzystania – Twoje minuty CI/CD są nieograniczone. W zależności od wybranego planu, runner może obsługiwać kilkadziesiąt zadań równocześnie.

Ten przewodnik przeprowadzi Cię przez proces podłączenia Stackhero runnera do GitLab w zaledwie kilka minut.

Krok 1: Utwórz GitLab Runnera w Stackhero

Na swoim panelu Stackhero możesz utworzyć nową usługę GitLab Runner i wybrać plan odpowiadający Twoim potrzebom. Plan określa dostępne zasoby CPU, RAM oraz liczbę równoczesnych zadań (odpowiada to ustawieniu concurrent w GitLab Runner, czyli liczbie zadań wykonywanych jednocześnie).

Twój runner będzie gotowy do pracy 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 wygenerujesz w GitLab, gdzie również określisz zakres runnera:

• Project runner: Otwórz swój projekt, następnie przejdź do Settings > CI/CD > Runners > New project runner.
• Group runner: Otwórz swoją grupę, następnie przejdź do Settings > CI/CD > Runners > New group runner.
• Instance runner (tylko dla własnych instancji GitLab): Przejdź do Admin area > CI/CD > Runners > New instance runner.

Podczas tworzenia runnera możesz:

• Dodać tagi (np. docker lub stackhero), aby łatwiej kierować zadania do tego runnera.
• Zezwolić na wykonywanie zadań bez tagów, jeśli chcesz, aby runner obsługiwał każde zadanie.

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

Stary sposób rejestracji za pomocą registration token jest przestarzały. Użyj tokena uwierzytelniającego runnera (glrt-...) utworzonego razem z runnerem, jak opisano powyżej.

Krok 3: Połącz runnera

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

• URL GitLab: Użyj https://gitlab.com dla GitLab.com lub adres URL własnej instancji GitLab (na przykład, jeśli korzystasz z GitLab na Stackhero, może to być 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 automatycznie połączy się z GitLab i pojawi się jako online na stronie Runners, gdzie został utworzony.

Krok 4: Uruchom swój pierwszy pipeline

Aby rozpocząć, dodaj plik .gitlab-ci.yml do katalogu głównego swojego repozytorium:

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 Stackhero runner wykona zadania. Jeśli podczas tworzenia runnera dodałeś tagi, możesz kierować zadania do runnera za ich pomocą, np.:

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

To wszystko. Twoje pipeline'y są teraz uruchamiane na dedykowanym runnerze, z nieograniczonym limitem minut buildów.

Kolejny krok

Chcesz budować i wysyłać obrazy Docker z poziomu pipeline'ów? Przejdź do Budowanie obrazów Docker.