GitLab Runner: Darbo pradžia

Prijunkite savo Stackhero GitLab Runner prie GitLab.com, Stackhero for GitLab arba savo nuosavo GitLab serverio ir paleiskite pirmąjį pipeline vos per kelias minutes

👋 Sveiki atvykę į Stackhero dokumentaciją!

Stackhero siūlo paprastą GitLab Runner cloud sprendimą, kuris leidžia efektyviai ir be rūpesčių vykdyti jūsų GitLab CI/CD užduotis. Štai ko galite tikėtis:

• Neribotos CI/CD minutės: vykdykite savo pipelines tiek kartų, kiek reikia, be apmokestinimo už minutes ar netikėtų mokesčių.
• Keli vienu metu vykdomi darbai: spartinkite kūrimo procesą paleisdami kelias užduotis lygiagrečiai.
• Docker executor su Docker-in-Docker palaikymu: lengvai kurkite ir talpinkite konteinerių atvaizdus kaip CI/CD proceso dalį.
• Puikiai veikia tiek su GitLab.com, tiek su self-managed GitLab instancijomis.
• Privati, dedikuota infrastruktūra su greitu NVMe/SSD saugojimu užtikrina stabilų ir nuspėjamą build našumą.
• Pasiekiama 🇪🇺 Europoje ir 🇺🇸 JAV regionuose, kad atitiktų jūsų komandos poreikius.

Taupykite laiką: galite prijungti savo pirmąjį GitLab Runner ir pradėti vykdyti pipelines vos per kelias minutes!

Įžanga

GitLab Runner yra agentas, vykdantis jūsų GitLab CI/CD užduotis (jobs). Kiekvieną kartą, kai paleidžiamas pipeline, runner paima kiekvieną užduotį, ją vykdo izoliuotame Docker konteineryje ir grąžina rezultatus atgal į GitLab.

Naudodami Stackhero, jūsų runner visada veikia privačioje, dedikuotoje infrastruktūroje. Nėra jokių mokesčių už minutes ar naudojimo kvotų: jūsų CI/CD minutės yra neribotos. Priklausomai nuo pasirinkto plano, runner gali vienu metu apdoroti daug užduočių lygiagrečiai, todėl build pajėgumų didinimas yra paprastas.

Šis gidas padės jums prijungti Stackhero runner prie GitLab ir greitai paleisti pirmąjį pipeline.

1 žingsnis: Sukurkite savo GitLab Runner Stackhero platformoje

Savo Stackhero valdymo pulte galite sukurti naują GitLab Runner paslaugą ir pasirinkti jūsų darbo eigai tinkamą planą. Planas nustato jums prieinamus CPU, RAM ir lygiagrečių užduočių skaičių (atitinka GitLab Runner concurrent nustatymą: kiek užduočių runner gali vykdyti vienu metu).

Jūsų runner bus paruoštas naudoti maždaug per 2 minutes.

2 žingsnis: Sukurkite runner GitLab aplinkoje

Jūsų runner jungiasi prie GitLab naudodamas runner autentifikavimo žetoną. Šį žetoną sugeneruojate GitLab aplinkoje ir taip pat pasirenkate runner taikymo sritį:

• Projekto runner: Atidarykite savo projektą, tada eikite į Settings > CI/CD > Runners > New project runner.
• Grupės runner: Atidarykite savo grupę, tada eikite į Settings > CI/CD > Runners > New group runner.
• Instancijos runner (tik savarankiškai valdomam GitLab): Eikite į Admin area > CI/CD > Runners > New instance runner.

Kurdami runner, galite:

• Pridėti žymas (pvz., docker ar stackhero), kad galėtumėte šį runner taikyti konkrečioms užduotims.
• Leisti vykdyti užduotis be žymų, jei norite, kad runner apdorotų visas užduotis, net ir be žymų.

GitLab suteiks runner autentifikavimo žetoną, kuris prasideda glrt-. Laikykite šį žetoną saugiai, nes runner jį naudoja autentifikacijai su GitLab.

Ankstesnis registration token naudojimo būdas yra pasenęs. Naudokite runner autentifikavimo žetoną (glrt-...), kuris sukuriamas pridedant runner, kaip aprašyta aukščiau.

Daugiau informacijos rasite oficialioje GitLab runner registracijos dokumentacijoje.

3 žingsnis: Prijunkite savo runner

Grįžkite į savo Stackhero valdymo pultą, atidarykite GitLab Runner paslaugos konfigūraciją ir įveskite šią informaciją:

• GitLab URL: Naudokite https://gitlab.com jei naudojate GitLab.com, arba savo savarankiškai valdomos GitLab instancijos adresą. (Jei Stackhero platformoje naudojate GitLab, tai gali būti https://git.jusu-imone.com.)
• Runner autentifikavimo žetonas (glrt-...), kurį gavote 2 žingsnyje.
• Lygiagrečių užduočių skaičius, kurį norite leisti.

Išsaugojus konfigūraciją, jūsų runner prisijungs prie GitLab ir pasirodys kaip prisijungęs (online) toje Runners puslapyje, kur jį sukūrėte.

4 žingsnis: Paleiskite pirmąjį pipeline

Pridėkite .gitlab-ci.yml failą į savo repozitorijos šaknį, kad apibrėžtumėte 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

Padarykite commit ir išsiųskite pakeitimus (push). GitLab paleis pipeline, o jūsų Stackhero runner įvykdys užduotis. Jei runner kūrimo metu pridėjote žymas, galite jas nurodyti užduotyse taip:

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

Nuo šiol jūsų pipeline vykdomi dedikuotame runner, su neribotomis build minutėmis ir be jokių naudojimo apribojimų.

Kitas žingsnis

Jei norite pipeline metu kurti ir įkelti Docker atvaizdus, tęskite su Docker atvaizdų kūrimas.