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 管道等。