gitlab-runner 的安装

在 Windows 系统上安装和配置 GitLab Runner 涉及几个关键步骤，包括下载可执行文件、注册 Runner、配置服务以及设置 CI/CD 脚本。 ### 下载和安装 GitLab Runner 1. 首先，从 [GitLab Runner 的官方 GitHub 页面](https://gitlab-runner-downloads.s3.amazonaws.com/latest/index.html)下载适用于 Windows 的 `gitlab-runner.exe` 文件。 2. 将下载的 `gitlab-runner.exe` 文件放置在你希望运行 GitLab Runner 的目录中，例如 `C:\GitLab-Runner`。 3. 打开命令提示符（CMD）并导航到该目录，然后执行以下命令来安装和启动 GitLab Runner 服务： ```bash gitlab-runner.exe install gitlab-runner.exe start ``` ### 注册 GitLab Runner 1. 在 GitLab 项目中获取 Runner 注册令牌。可以在项目的 **Settings > CI/CD > Runners** 页面中找到。 2. 在命令提示符中执行以下命令以注册 Runner： ```bash gitlab-runner.exe register ``` 系统将提示输入以下信息： - **GitLab instance URL**：输入你的 GitLab 实例的 URL，例如 `https://gitlab.com`。 - **Registration token**：输入从 GitLab 获取的注册令牌。 - **Description**：输入 Runner 的描述，例如 `My Windows Runner`。 - **Tags**：输入 Runner 的标签（可选）。 - **Executor**：选择执行器类型，例如 `shell` 或 `docker`。对于 Windows 环境，推荐使用 `cmd` 或 `powershell`。 3. 完成注册后，Runner 将出现在项目的 **Runners** 页面中。 ### 配置 GitLab Runner 1. GitLab Runner 的配置文件通常位于 `C:\GitLab-Runner\config.toml`。可以编辑此文件以调整 Runner 的配置，例如指定特定的构建目录或设置环境变量。 2. 如果使用 `powershell` 或 `cmd` 作为执行器，可以在 `.gitlab-ci.yml` 文件中编写 PowerShell 或 CMD 命令来执行构建任务。 ### 示例 `.gitlab-ci.yml` 文件 以下是一个简单的 `.gitlab-ci.yml` 文件示例，用于在 Windows 上执行构建任务： ```yaml stages: - build build: stage: build script: - echo "Building the project..." - 'dir' # 列出当前目录内容 - 'cd C:\path\to\your\project' - 'mvn clean package' # 使用 Maven 打包项目 ``` ### 启动和停止 GitLab Runner 服务 - 启动服务： ```bash gitlab-runner.exe start ``` - 停止服务： ```bash gitlab-runner.exe stop ``` - 重启服务： ```bash gitlab-runner.exe restart ``` 通过上述步骤，可以在 Windows 系统上成功安装和配置 GitLab Runner，并用于执行 CI/CD 任务[^2]。