在 Windows 上直接部署 GitLab Runner

Ted Liou 2025.08.27 開發維運
本文說明如何在 Windows 系統中,直接安裝並設定 GitLab Runner 服務。此 Runner 將以 Shell 執行器運行,適合執行與 Windows 環境相關的 CI/CD 任務,例如 PowerShell 腳本或 .NET 專案的建置。

除了在 WSL 2 中部署 Linux-based 的 Runner,有時我們也需要一個能原生運行於 Windows 環境的 GitLab Runner,以處理特定的開發任務,如 .NET Framework 應用程式的建置或 PowerShell 腳本的執行。

本文將帶你完成 GitLab Runner 服務在 Windows 上的安裝與註冊,並將其配置為一個準備好執行 Windows 任務的執行器。

準備環境:下載與放置執行檔

首先,建立一個專門用於存放 Runner 執行檔的目錄,例如 C:\GitLab-Runner

接著,前往 GitLab Runner 的官方安裝頁面,下載適用於 Windows x64 的執行檔。

GitLab Runner 安裝說明

將下載好的執行檔(gitlab-runner-windows-amd64.exe)重新命名為 gitlab-runner.exe,並將其放置在 C:\GitLab-Runner 目錄中。

安裝與啟動 Runner 服務

系統管理員身分開啟 PowerShell,並切換到 GitLab Runner 所在的目錄,然後依序執行以下指令來安裝並啟動服務。

1cd C:\GitLab-Runner
2.\gitlab-runner.exe install
3.\gitlab-runner.exe start

若指令執行後,出現類似 Runtime platform arch=amd64 os=windows pid=... 的訊息,代表服務已正常安裝與啟動。

註冊 Runner 至 GitLab

服務啟動後,你需要前往 GitLab 網站來取得註冊資訊,以便將此 Runner 與你的 GitLab 實例連結。

取得註冊資訊

  1. 登入 GitLab,進入 Admin area > CI/CD > Runners
  2. 點擊 Create an instance runner,並選擇 Windows 平台。
  3. 複製 GitLab 提供的註冊指令。

執行註冊指令

將剛剛複製的註冊指令貼到 PowerShell 中執行。在設定過程中,當系統提示你選擇執行器(executor)時,請選擇 shell

1Enter an executor: shell

提示:你可以為此 Runner 新增標籤,例如 windows, powershell,以便在 .gitlab-ci.yml 中指定特定的作業由這個 Runner 執行。

總結

現在,你的 Windows 環境已經擁有了一個功能完整的 GitLab Runner,它已準備好接收並處理所有分配給它的 CI/CD 任務。透過這種方式,你可以輕鬆實現針對 Windows 專案的自動化建置與測試流程,讓開發工作更加流暢。

相關文章

Ted Liou

我是一位遊戲開發工程師 / 軟體工程師,專精於 Unity 和 C#。我善於自學新技術,並樂於將所學轉化為淺顯易懂的教材,幫助他人學習與成長。