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

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

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

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

使用 deb/rpm 软件包

如有需要,可以通过 debrpm 软件包进行下载和安装。

下载

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

  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.gitlab.cn/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.gitlab.cn/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.gitlab.cn/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
  1. 为您的系统下载二进制文件:

    # Linux x86-64
    sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.gitlab.cn/latest/binaries/gitlab-runner-linux-amd64"
    
    # Linux x86
    sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.gitlab.cn/latest/binaries/gitlab-runner-linux-386"
    
    # Linux arm
    sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.gitlab.cn/latest/binaries/gitlab-runner-linux-arm"
    
    # Linux arm64
    sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.gitlab.cn/latest/binaries/gitlab-runner-linux-arm64"
    
    # Linux s390x
    sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.gitlab.cn/latest/binaries/gitlab-runner-linux-s390x"
    
    # Linux ppc64le
    sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.gitlab.cn/latest/binaries/gitlab-runner-linux-ppc64le"
       
    # Linux x86-64 FIPS Compliant
    sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.gitlab.cn/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.gitlab.cn/latest/binaries/gitlab-runner-linux-amd64"
    

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

  3. 授权执行:

    sudo chmod +x /usr/local/bin/gitlab-runner
    
  4. 启动服务:

    sudo gitlab-runner start