• 先决条件
• 安装极狐GitLab Runner
  • APT Pinning
  • 极狐GitLab 镜像站点
• 升级极狐GitLab Runner
• 包安装的GPG 签名
  • 仓库元数据签名
  • 包签名
    • 基于 RPM 的发行版
    • 基于 DEB 的发行版
    • 当前 GPG 公钥
    • 以前的 GPG 公钥
• 手动下载包
• 禁用 skel

使用官方极狐GitLab 仓库安装极狐GitLab Runner

我们使用 packagecloud 为以下受支持的 Linux 发行版提供软件包。 根据您的设置，也可能支持其他基于 deb 或 rpm 的发行版。您也可以在其他 Linux 发行版上将极狐GitLab Runner 安装为二进制文件。

先决条件

如果您想使用Docker 执行器，请在使用极狐GitLab Runner 前安装 Docker。 详情请参见如何为您的发行版安装 Docker。

安装极狐GitLab Runner

安装极狐GitLab Runner：

1. 添加官方极狐GitLab 仓库：

   对于 Debian/Ubuntu/Mint：

   curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash
   

   对于 RHEL/CentOS/Fedora：

   curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh" | sudo bash
   

   Debian 用户应该使用 APT Pinning。为了方便用户安装使用极狐GitLab Runner，我们在中国国内设置了极狐GitLab 镜像站点。

2. 安装最新版本的极狐GitLab Runner，或跳到下一步，安装特定版本。

   从 14.0 开始，默认禁用 skel 目录使用，以避免 No such file or directory 作业错误。

   对于 Debian/Ubuntu/Mint：

   sudo apt-get install gitlab-runner
   

   对于 RHEL/CentOS/Fedora：

   sudo yum install gitlab-runner
   

1. 安装特定版本的极狐GitLab Runner：

   对于基于 DEB 的系统：

   apt-cache madison gitlab-runner
   sudo apt-get install gitlab-runner=10.0.0
   

   对于基于 RPM 的系统：

   yum list gitlab-runner --showduplicates | sort -r
   sudo yum install gitlab-runner-10.0.0-1
   

2. 注册 Runner。

完成上述步骤后，应启动 Runner 准备使用。

确保您阅读了 FAQ ，它介绍了您在使用极狐GitLab Runner 时最可能遇到的问题。

APT Pinning

一个名为 gitlab-ci-multi-runner 的本地包在 Debian Stretch 中可用。默认情况下，安装 gitlab-runner 时，官方仓库的安装包将具有更高的优先级。

如果您想使用我们的安装包，您应该手动设置安装包源。最好的方法是添加固定配置文件。

通过这种方式，极狐GitLab Runner 包的下一次升级，无论是手动还是自动，都会使用同一来源完成：

cat <<EOF | sudo tee /etc/apt/preferences.d/pin-gitlab-runner.pref
Explanation: Prefer GitLab provided packages over the Debian native ones
Package: gitlab-runner
Pin: origin packages.gitlab.com
Pin-Priority: 1001
EOF

极狐GitLab 镜像站点

中国国内用户可以使用极狐GitLab 镜像站点安装极狐GitLab Runner。目前镜像站点已经支持主流的 Linux 发行版，包括：

• Ubuntu 22.04（jammy）
• Ubuntu 20.04（focal）
• Ubuntu 18.04（bionic）
• Ubuntu 16.04（xenial）
• Debian 11（bullseye）
• Debian 10（buster）
• Debian 9（stretch）
• RHEL/CentOS Stream 8
• RHEL/CentOS 7

如果要使用极狐GitLab 镜像站点，对于 Debian/Ubuntu：

curl -L "https://packages.gitlab.cn/repository/raw/scripts/runner.deb.sh" | sudo bash

对于 RHEL/CentOS：

curl -L "https://packages.gitlab.cn/repository/raw/scripts/runner.rpm.sh" | sudo bash

升级极狐GitLab Runner

执行以下命令，安装最新版本：

对于 Debian/Ubuntu/Mint：

sudo apt-get update
sudo apt-get install gitlab-runner

对于 RHEL/CentOS/Fedora：

sudo yum update
sudo yum install gitlab-runner

包安装的GPG 签名

为了增加用户对已安装软件的信心，极狐GitLab Runner 项目为安装方法提供两种 GPG 签名：仓库元数据签名和包签名。

仓库元数据签名

包管理器使用仓库元数据签名验证从远端仓库下载的包信息是否可信。

当您使用类似 apt-get update 的命令时会验证签名，进而在下载和安装任何软件包之前更新相关可用软件包的信息。验证失败也会导致包管理器拒绝元数据。这意味着在找到并解决导致签名不匹配的问题之前，您无法从仓库下载和安装任何软件包。

在按照上述指南安装完成以后，会自动安装用于包元数据签名验证的 GPG 公钥。 对于未来的关键升级，现有用户需要手动下载并安装新密钥。

包签名

使用包签名，每个包在构建时都会被签名。所以在您信任构建环境和所使用的 GPG 密钥的保密性之前，包上的有效签名都会证明其来源经过验证并且其完整性没有受到损坏。

默认情况下，仅在某些基于 DEB/RPM 的发行版中启用包签名验证，所以想要进行这种验证的用户可能需要调整配置。

基于 RPM 的发行版

RPM 格式包含 GPG 签名功能的完整实现，因此与基于该格式的包管理系统进行了完全集成。

您可以在 Omnibus GitLab 文档中找到为基于 RPM 的发行版配置包签名验证的技术说明。 极狐GitLab Runner 的区别是：

• 应安装的公钥包的名称是 gpg-pubkey-35dfa027-60ba0235。

• 基于 RPM 的发行版的仓库文件将命名为 /etc/yum.repos.d/runner_gitlab-runner.repo （稳定版本）或 /etc/yum.repos.d/runner_unstable.repo（不稳定版本）。

基于 DEB 的发行版

DEB 格式没有正式包含用于签名包的默认和包含方法。 极狐GitLab Runner 项目使用 dpkg-sig 工具进行签名并验证包上的签名。这个方法仅支持手动验证包。

1. 安装 dpkg-sig。

    apt-get update && apt-get install dpkg-sig
   

2. 下载并导入包签名公钥。

    curl -JLO "https://packages.gitlab.com/runner/gitlab-runner/gpgkey/runner-gitlab-runner-4C80FB51394521E9.pub.gpg"
    gpg --import runner-gitlab-runner-4C80FB51394521E9.pub.gpg
   

3. 使用 dpkg-sig 验证下载的包。

    dpkg-sig --verify gitlab-runner_amd64.deb
    Processing gitlab-runner_amd64.deb...
    GOODSIG _gpgbuilder 09E57083F34CCA94D541BC58A674BF8135DFA027 1623755049
   

   验证具有无效签名或使用无效密钥（例如撤销的密钥）签名的包将输出类似以下的内容：

    dpkg-sig --verify gitlab-runner_amd64.deb
    Processing gitlab-runner_amd64.deb...
    BADSIG _gpgbuilder
   

   如果用户的密钥环中没有密钥，则输出将类似于：

    dpkg-sig --verify gitlab-runner_amd64.v13.1.0.deb
    Processing gitlab-runner_amd64.v13.1.0.deb...
    UNKNOWNSIG _gpgbuilder 880721D4
   

当前 GPG 公钥

以前的 GPG 公钥

过去使用的密钥可以在下表中找到。

对于已撤销的密钥，我们强烈建议您将其从包签名验证配置中移除。

不应再信任由这些密钥生成的签名。

手动下载包

如有必要，您可以手动下载并安装包。

禁用 skel

• 引入于极狐GitLab Runner 12.10。

• 默认设置为 true 于极狐GitLab Runner 14.0。

在极狐GitLab Runner 12.10 中，我们添加了对特殊变量 GITLAB_RUNNER_DISABLE_SKEL 的支持，当其设置为 true 时，在创建新创建用户的 $HOME 目录时会避免使用 skel。

从极狐GitLab Runner 14.0 开始，GITLAB_RUNNER_DISABLE_SKEL 默认设置为 true。

如果出于任何原因需要使用 skel 目录来填充新建的 $HOME 目录，GITLAB_RUNNER_DISABLE_SKEL变量在安装软件包之前应被明确设置为 false。例如：

对于 Debian/Ubuntu/Mint：

export GITLAB_RUNNER_DISABLE_SKEL=false; sudo -E apt-get install gitlab-runner

对于 RHEL/CentOS/Fedora：

export GITLAB_RUNNER_DISABLE_SKEL=false; sudo -E yum install gitlab-runner