GitLab Runner: 快速開始

將您的 Stackhero GitLab Runner 連接至 GitLab.com、Stackhero for GitLab 或您自己的 GitLab 伺服器，幾分鐘內即可執行您的第一個 pipeline

👋 歡迎來到 Stackhero 文件中心！

Stackhero 提供簡單易用的 GitLab Runner 雲端 解決方案，讓您高效且無煩惱地執行 GitLab CI/CD 任務。您可以期待以下功能：

• 無限 CI/CD 時數：隨時運行您的 pipeline，無需擔心按分鐘計費或額外費用。
• 多個任務同時執行：可同時平行運行多個任務，加速您的開發流程。
• 支援 Docker executor 及 Docker-in-Docker：輕鬆在 CI/CD 流程中建置並推送容器映像檔。
• 完美支援 GitLab.com 及 自建 GitLab 實例。
• 專屬私有基礎架構，搭配高速 NVMe/SSD 儲存，確保建置效能穩定且可預期。
• 提供 🇪🇺 歐洲 與 🇺🇸 美國 區域，滿足您團隊的需求。

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

介紹

GitLab Runner 是執行 GitLab CI/CD 任務的代理程式。每當 pipeline 執行時，runner 會接收每個任務，並在隔離的 Docker 容器中執行，然後將結果回報給 GitLab。

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

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

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

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

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

步驟 2：在 GitLab 中建立 runner

您的 runner 會透過runner 驗證權杖連接至 GitLab。您需要在 GitLab 產生這個權杖，並選擇 runner 的作用範圍：

• 專案 runner：開啟您的專案，前往 Settings > CI/CD > Runners > New project runner。
• 群組 runner：開啟您的群組，前往 Settings > CI/CD > Runners > New group runner。
• 實例 runner（僅限自管 GitLab）：前往 Admin area > CI/CD > Runners > New instance runner。

建立 runner 時，您可以：

• 新增標籤（如 docker 或 stackhero），以便在任務中指定此 runner。
• 若希望 runner 處理所有任務（包含未加標籤者），可允許其執行未標籤任務。

GitLab 會提供一組以 glrt- 開頭的runner 驗證權杖。請妥善保管此權杖，runner 會用它與 GitLab 驗證身份。

先前的 registration token 註冊方式已淘汰。請依上述說明，使用新增 runner 時產生的 runner 驗證權杖（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 驗證權杖（glrt-...）。
• 您希望允許的並行任務數量。

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

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

在您的程式庫根目錄新增 .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 會執行這些任務。如果您在建立 runner 時有加上標籤，可以在任務中這樣指定：

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

您的 pipeline 現在會在專屬 runner 上執行，享有無限建置分鐘數，無需擔心使用限制。

下一步

如果您希望在 pipeline 中建置並推送 Docker 映像檔，請繼續閱讀 建置 Docker 映像檔。