GitLab Runner: 快速開始

將您的 Stackhero GitLab Runner 連接至 GitLab.com 或自架 GitLab，並執行您的第一個 pipeline

👋 歡迎來到 Stackhero 文件中心！

Stackhero 為您提供一套易於使用的 GitLab Runner cloud 解決方案，專為高效處理您的 GitLab CI/CD 任務而設計。您可以期待以下優勢：

• 無限制 CI/CD 時數：不採用按分鐘計費，您的 pipeline 可隨時執行。
• 多任務並行執行：可同時運行多個任務，加速整體 pipeline 流程。
• 支援 Docker executor 及 Docker-in-Docker：簡化容器映像檔的建置與推送流程。
• 相容於 GitLab.com 及任何 自建 GitLab 實例。
• 專屬私人虛擬機（VM），採用高速 NVMe/SSD 磁碟，確保建置過程穩定可靠。
• 提供 🇪🇺 歐洲 與 🇺🇸 美國 區域選擇。

節省您的時間：您只需幾分鐘即可連接第一個 GitLab Runner，立即開始執行 pipeline！

介紹

GitLab Runner 是負責執行 GitLab CI/CD 任務的代理程式。每當 pipeline 被觸發時，runner 會接收每個任務，在全新乾淨的 Docker 容器中執行，然後將結果回報給 GitLab。

在 Stackhero 上，您的 runner 運作於專屬的私有虛擬機（VM）。沒有按分鐘計費或使用配額，您的 CI/CD 執行分鐘數無限制。根據您的方案，runner 可以同時處理數十個並行任務。

本指南將帶您在幾分鐘內完成 Stackhero runner 與 GitLab 的連接。

步驟 1：在 Stackhero 上建立您的 GitLab Runner

從您的 Stackhero 控制台，您可以建立新的 GitLab Runner 服務，並選擇符合需求的方案。方案會決定您可用的 CPU、RAM，以及可同時執行的任務數量（對應 GitLab Runner 的 concurrent 設定，即可同時執行的任務數）。

您的 runner 約 2 分鐘內即可啟動並運作。

步驟 2：在 GitLab 中建立 runner

您的 runner 會透過runner 驗證權杖連接至 GitLab。您將在 GitLab 產生這個權杖，同時決定 runner 的作用範圍：

• Project runner：打開您的專案，前往 Settings > CI/CD > Runners > New project runner。
• Group runner：打開您的群組，前往 Settings > CI/CD > Runners > New group runner。
• Instance runner（僅限自架 GitLab）：前往 Admin area > CI/CD > Runners > New instance runner。

建立 runner 時，您可以：

• 新增標籤（如 docker 或 stackhero），方便在任務中指定此 runner。
• 若希望 runner 執行所有任務，可允許其執行未標記的任務。

GitLab 會提供一組以 glrt- 開頭的runner 驗證權杖。請妥善保管此權杖，因為 runner 會用它來進行驗證。

舊的 registration token 流程已經淘汰。請使用上述建立 runner 時產生的 runner 驗證權杖（glrt-...）。

步驟 3：連接您的 runner

回到您的 Stackhero 控制台，打開 GitLab Runner 服務設定，並輸入以下資訊：

• 您的 GitLab URL：若為 GitLab.com 請填寫 https://gitlab.com，或填寫您的自架 GitLab 實例網址（例如，若您在 Stackhero 上運行 GitLab，可能是 https://git.your-company.com）。
• 您在步驟 2 取得的 runner 驗證權杖（glrt-...）。
• 您希望允許的同時執行任務數量。

儲存設定後，runner 會自動連接至 GitLab，並在您建立 runner 的 Runners 頁面上顯示為線上狀態。

步驟 4：執行您的第一個 pipeline

首先，在您的程式庫根目錄新增 .gitlab-ci.yml 檔案：

stages:
  - build
  - test

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

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

提交並推送您的變更。GitLab 會啟動 pipeline，您的 Stackhero runner 會執行這些任務。如果您在建立 runner 時有加上標籤，也可以在任務中這樣指定：

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

就是這麼簡單。您的 pipeline 現在已在專屬 runner 上執行，且建置分鐘數無上限。

下一步

想要在 pipeline 中建置並推送 Docker 映像檔嗎？請繼續閱讀 建置 Docker 映像檔。