极狐 GitLab

在 GUN/Linux 上手动安装极狐GitLab Runner

Tier: 基础版，专业版，旗舰版

Offering: JihuLab.com，私有化部署

你可以通过使用 deb 或 rpm 软件包或者一个二进制文件来手动安装极狐GitLab Runner。如果满足以下情况，请使用这种方法作为最后的手段：

  • 你不能使用 deb/rpm 仓库 来安装极狐GitLab Runner
  • 你的 GNU/Linux 操作系统不受支持

如果你想使用 Docker 执行器，在使用极狐GitLab Runner 之前，你必须安装 Docker。

确保你阅读了 FAQ 部分，该部分描述了一些关于极狐GitLab Runner 的常见问题。

使用 deb/rpm 软件包#

你可以通过使用 deb 或 rpm 软件包来下载和安装极狐GitLab Runner。

下载#

要为你的系统下载合适的软件包：

  1. 在 https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/index.html 找到最新的文件名和选项。
  2. 下载与你的软件包管理器或架构匹配的 runner-helper 版本。
  3. 选择一个版本并下载一个二进制文件，如文档中 下载任何其他标记的发布版本 所述，以获取极狐GitLab Runner 的前沿版本。

例如，对于 Debian 或 Ubuntu：

shell
# 用任何支持的架构替换 ${arch}，例如 amd64, arm, arm64
# 完整的架构列表可以在这里找到 https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/index.html
curl -LJO "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/deb/gitlab-runner-helper-images.deb"
curl -LJO "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/deb/gitlab-runner_${arch}.deb"

例如，对于 CentOS 或 Red Hat Enterprise Linux：

shell
# 用任何支持的架构替换 ${arch}，例如 amd64, arm, arm64
# 完整的架构列表可以在这里找到 https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/index.html
curl -LJO "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/rpm/gitlab-runner-helper-images.rpm"
curl -LJO "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/rpm/gitlab-runner_${arch}.rpm"

例如，对于 RHEL 上 符合 FIPS 的极狐GitLab Runner：

shell
# 目前只有 amd64 是支持的架构
# 符合 FIPS 的极狐GitLab Runner 版本继续在一个软件包中包含 helper 镜像。
# 完整的架构列表可以在这里找到 https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/index.html
curl -LJO "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/rpm/gitlab-runner_amd64-fips.rpm"

安装#

  1. 按如下方式为你的系统安装软件包。

    例如，对于 Debian 或 Ubuntu：

    shell
    dpkg -i gitlab-runner-helper-images.deb gitlab-runner_<arch>.deb

    例如，对于 CentOS 或 Red Hat Enterprise Linux：

    shell
    dnf install -y gitlab-runner-helper-images.rpm gitlab-runner_<arch>.rpm

  2. 注册一个 runner

升级#

下载最新的软件包，然后按如下方式升级：

例如，对于 Debian 或 Ubuntu：

shell
dpkg -i gitlab-runner_<arch>.deb

例如，对于 CentOS 或 Red Hat Enterprise Linux：

shell
dnf install -y gitlab-runner-helper-images.rpm gitlab-runner_<arch>.rpm

使用二进制文件#

你可以通过使用二进制文件下载和安装极狐GitLab Runner。

安装#

在极狐GitLab Runner 10 中，执行文件被重命名为 `gitlab-runner`。

  1. 下载适合你系统的二进制文件之一：

    shell
    1# Linux x86-64
2sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-amd64"
3
4# Linux x86
5sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-386"
6
7# Linux arm
8sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-arm"
9
10# Linux arm64
11sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-arm64"
12
13# Linux s390x
14sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-s390x"
15
16# Linux ppc64le
17sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-ppc64le"
18
19# Linux riscv64
20sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-riscv64"
21
22# Linux x86-64 符合 FIPS 标准
23sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-amd64-fips"

    你可以下载每个可用版本的二进制文件，如 前沿版本 - 下载任何其他标记的发布版本 中所述。

  2. 给予它执行权限：

    shell
    sudo chmod +x /usr/local/bin/gitlab-runner

  3. 创建一个极狐GitLab CI 用户：

    shell
    sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash

  4. 安装并作为服务运行：

    shell
    sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start

    确保你在 root 的 $PATH 中有 /usr/local/bin/，否则可能会出现 command not found 错误。或者，你可以将 gitlab-runner 安装在其他位置，比如 /usr/bin/。

  5. 注册一个 runner

如果 `gitlab-runner` 是作为服务安装和运行的，它会以 root 身份运行，但以 `install` 命令指定的用户身份执行作业。这意味着一些作业功能，比如缓存和产物，必须执行 `/usr/local/bin/gitlab-runner` 命令。因此，执行作业的用户需要有权访问可执行文件。

升级#

  1. 停止服务（你需要像之前一样使用提升权限的命令提示符）：

    shell
    sudo gitlab-runner stop

  2. 下载二进制文件以替换极狐GitLab Runner 可执行文件。例如：

    shell
    sudo curl -L --output /usr/local/bin/gitlab-runner "https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-linux-amd64"

    你可以下载每个可用版本的二进制文件，如 前沿版本 - 下载任何其他标记的发布版本 中所述。

  3. 给予它执行权限：

    shell
    sudo chmod +x /usr/local/bin/gitlab-runner

  4. 启动服务：

    shell
    sudo gitlab-runner start