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

如果您无法使用 deb/rpm 仓库安装极狐GitLab Runner，或者您的 GNU/Linux OS 不受支持，您可以使用以下方法进行手动安装。

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

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

使用 deb/rpm 软件包

如有需要，可以通过 deb 或 rpm 软件包进行下载和安装。

下载

为您的系统下载合适的安装包：

  1. 在 https://gitlab-runner-downloads.s3.amazonaws.com/latest/index.html 中找到最新的文件名称和选项。
  2. 根据前沿极狐GitLab Runner 发布中下载其他标签发布的文档介绍，选择版本并下载二进制文件。

例如，对于 Debian 或 Ubuntu： 

# Replace ${arch} with any of the supported architectures, e.g. amd64, arm, arm64
# A full list of architectures can be found here https://gitlab-runner-downloads.s3.amazonaws.com/latest/index.html
curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/deb/gitlab-runner_${arch}.deb"

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

# Replace ${arch} with any of the supported architectures, e.g. amd64, arm, arm64
# A full list of architectures can be found here https://gitlab-runner-downloads.s3.amazonaws.com/latest/index.html
curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/rpm/gitlab-runner_${arch}.rpm"

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

# Currently only amd64 is a supported arch
# A full list of architectures can be found here https://gitlab-runner-downloads.s3.amazonaws.com/latest/index.html
curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/rpm/gitlab-runner_amd64-fips.rpm"

安装

  1. 为您的系统安装软件包。

    例如，对于 Debian 或 Ubuntu： 

    dpkg -i gitlab-runner_<arch>.deb

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

    rpm -i gitlab-runner_<arch>.rpm

  2. 注册 Runner。

升级

下载您系统对应的最新的软件包并按照以下步骤升级：

例如，对于 Debian 或 Ubuntu： 

dpkg -i gitlab-runner_<arch>.deb

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

rpm -Uvh gitlab-runner_<arch>.rpm

使用二进制文件

如有需要，可以通过二进制文件进行下载和安装。

安装

caution使用极狐GitLab Runner 10，可执行文件重命名为 gitlab-runner。 如果您想安装极狐GitLab Runner 10 之前的版本，请访问旧的文档。

  1. 为您的系统下载二进制文件： 

    # Linux x86-64
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64"

# Linux x86
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-386"

# Linux arm
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-arm"

# Linux arm64
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-arm64"

# Linux s390x
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-s390x"

# Linux ppc64le
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-ppc64le"
   
# Linux x86-64 FIPS Compliant
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64-fips"

    您可以为每个前沿-下载其他标签发布中描述的可用版本下载二进制文件。

  2. 授权执行： 

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

  3. 创建极狐GitLab CI 用户： 

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

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

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

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

  5. 注册 Runner。

note如果 gitlab-runner 已安装并作为服务（此页面中描述的内容）运行， 它将以根用户身份运行，但将以 install 指定的用户身份执行作业。 这意味着一些作业功能，如缓存和产物需要执行 /usr/local/bin/gitlab-runner 命令。 因此，运行作业的用户需要有权限访问可执行文件。

升级

  1. 停止服务（如以前一样，您需要升级的命令提示）： 

    sudo gitlab-runner stop

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

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

    您可以为每个前沿-下载其他标签发布中描述的可用版本下载二进制文件。

  3. 授权执行： 

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

  4. 启动服务： 

    sudo gitlab-runner start