GitLab Windows 安裝指南

一、安裝前準備

1、操作系統要求：GitLab Community Edition 支持 Windows Server 2008 或更高版本的操作系統，建議使用 Windows Server 2012 或更高版本的操作系統。

2、確保系統上已經安裝了以下軟件：

IIS：Internet Information Services
.Net Framework 4.6.2 或更高版本
Visual C++ 2015 或更高版本（安裝 GitLab Runner 時需要）
OpenSSH （v7.5p1 或以上）.

3、關閉防火牆（可選）。如果您的防火牆開啟了某些端口，則需要開放以下端口：

HTTP(S)：80, 443
SSH：22
GitLab Runner：8093.

二、GitLab 安裝

1、下載安裝包。您可以從 GitLab 官網 下載到最新的 GitLab 社區版安裝包。

2、解壓安裝包。解壓到您需要安裝的目錄中。

3、運行安裝腳本。繼續之前，請確保您已關閉所有的 GitLab 進程。

cd C:\GitLab
.\bin\updatePowershellExecutionPolicy.ps1
.\deploy.ps1

4、安裝 GitLab Runner。在 GitLab 安裝完成後，您需要安裝 GitLab Runner 以便在 Windows 上運行 CI/CD pipelines。

cd C:\GitLab-Runner
.\gitlab-runner.exe install --user ENTER_USERNAME --password ENTER_PASSWORD

將 “ENTER_USERNAME” 和 “ENTER_PASSWORD” 替換為您登錄 GitLab 的用戶名和密碼。如果您沒有後台服務，您可以使用 –run-untagged 參數運行 Runner。

三、IIS 配置

1、創建網站。打開 IIS 管理器，創建一個新的網站。填寫網站名稱、說明、IP 地址、端口和主機名。如果您只想在本機上運行，請將 IP 地址設置為“所有未分配的”，將端口設置為 80 或 443。

2、設置特定端口。在 IIS 管理器中單擊“前端部分”，選擇“網站名稱”，右鍵單擊“編輯綁定”，更改特定端口的屬性。

3、綁定網站。在“前端部分”，選擇“網站名稱”，右鍵單擊“添加應用程序”，將應用程序文件夾設置為包含 GitLab 安裝的目錄。“應用程序池”應設置成“.NET CLR 版本 4.0 的集成”。

四、GitLab 配置

1、配置運行器。在 GitLab 網站中，在群組或項目中打開項目設置，轉到 CI/CD 選項卡。在“Runner Automatic Setup” 下拉菜單中，選擇您的操作系統。將下拉菜單中的運行器配置腳本複製到 PowerShell 終端中，然後運行它。通過 Web 界面或 GitLab API 驗證 Runner 服務器是否正確地註冊。

2、配置 GitLab。在 GitLab 網站中，打開管理員區域，轉到 GitLab 管理面板。選擇“集成”選項卡，在“Jenkins 集成”中啟用。您可以使用默認的 Jenkins 報告 REST 端點 URL，它應指向本地服務器。

3、配置 GitLab Runner。在 Runner 安裝目錄下，編輯 config.toml 文件：

concurrent = 1
check_interval = 0

[[runners]]
  name = "My Runner"
  url = "http://gitlab.example.com/"
  token = "PROJECT_TOKEN"
  executor = "shell"
  [runners.custom_build_dir]
  [runners.cache]

將 “My Runner” 替換為您的運行器名稱，”gitlab.example.com” 替換為您的 GitLab 網站 URL，”PROJECT_TOKEN” 替換為您的項目訪問令牌。

五、開始使用

現在，您可以在您的 Windows 服務器上使用 GitLab 進行 CI/CD。您可以在 GitLab 網站上創建項目並啟用 CI/CD pipelines。GitLab Runner 將通過 shell 腳本或 PowerShell 腳本執行您的操作。您可以在 GitLab 網站上查看和管理構建，例如查看構建日誌、手動觸發 CI/CD 管道等。