GitLab Runner: 入門指南

將您的 Stackhero GitLab Runner 連接至 GitLab.com、Stackhero for GitLab 或您自設的 GitLab 伺服器，並於數分鐘內運行您的第一個 pipeline

👋 歡迎瀏覽 Stackhero 文件！

Stackhero 提供簡單易用的 GitLab Runner cloud 方案，讓您高效且輕鬆地執行 GitLab CI/CD 任務。您可以享有以下優勢：

• 無限 CI/CD 分鐘數：隨時隨地運行 pipeline，無需按分鐘計費，亦無額外收費。
• 多個並行任務：可同時運行多個 job，加快開發流程。
• 支援 Docker executor 及 Docker-in-Docker：輕鬆於 CI/CD 流程中建構及推送 container image。
• 完美兼容 GitLab.com 及 自建 GitLab 實例。
• 專屬私人基礎設施，配備高速 NVMe/SSD 儲存，確保建構效能穩定且可預測。
• 服務覆蓋 🇪🇺 歐洲 及 🇺🇸 美國 地區，靈活配合您的團隊需求。

節省時間：您只需數分鐘即可連接首個 GitLab Runner，立即開始運行 pipeline！

簡介

GitLab Runner 是執行您 GitLab CI/CD 工作的代理程式。每當 pipeline 執行時，runner 會接收每個 job，並於獨立的 Docker container 內執行，然後將結果回報至 GitLab。

使用 Stackhero，您的 runner 永遠運行於專屬、私有基礎設施上。沒有按分鐘收費或使用配額限制：您的 CI/CD 執行分鐘數無上限。根據您的方案，runner 可同時處理多個並行工作，讓您輕鬆擴展建構效能。

本指南將協助您將 Stackhero runner 連接至 GitLab，並快速運行您的第一個 pipeline。

步驟 1：於 Stackhero 建立您的 GitLab Runner

在您的 Stackhero 控制台，您可以建立新的 GitLab Runner 服務，並選擇最適合您工作流程的方案。方案會決定您可用的 CPU、RAM 及並行工作數量（對應 GitLab Runner 的 concurrent 設定：runner 可同時處理多少個 job）。

您的 runner 約 2 分鐘內即可使用。

步驟 2：於 GitLab 建立 runner

您的 runner 會透過runner 認證 token連接至 GitLab。您需於 GitLab 產生此 token，並選擇 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），以便於 job 中指定此 runner。
• 允許其執行未加標籤的 job，如您希望 runner 處理所有 job（包括沒有標籤的）。

GitLab 會提供一個以 glrt- 開頭的runner 認證 token。請妥善保管此 token，因為 runner 會用它與 GitLab 認證。

舊有的 registration token 流程已被棄用。請依上述說明，使用新增 runner 時產生的runner 認證 token（glrt-...）。

更多詳情可參閱 官方 GitLab runner 註冊文件。

步驟 3：連接您的 runner

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

• GitLab URL：如使用 GitLab.com，請填寫 https://gitlab.com；如為自設 GitLab，請填寫您的實例網址。（若您於 Stackhero 上運行 GitLab，網址可能為 https://git.your-company.com。）
• 於步驟 2 取得的runner 認證 token（glrt-...）。
• 您希望允許的並行工作數量。

儲存設定後，您的 runner 會連接至 GitLab，並於您設定的 Runners 頁面顯示為在線。

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

於您的 repository 根目錄新增 .gitlab-ci.yml 檔案，定義您的 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

提交並推送您的更改。GitLab 會觸發 pipeline，您的 Stackhero runner 會執行這些 job。如您於建立 runner 時有加入標籤，可於 job 中這樣指定：

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

您的 pipeline 現已於專屬 runner 上運行，無需擔心 build 分鐘數或使用限制。

下一步

如您希望於 pipeline 內建構及推送 Docker image，請繼續參閱 建構 Docker image。