手动在 GNU/Linux 上安装极狐GitLab Runner
如果您无法使用 deb/rpm 仓库安装极狐GitLab Runner,或者您的 GNU/Linux OS 不受支持,您可以使用以下方法进行手动安装。
如果想使用 Docker 执行器,您必须在使用极狐GitLab Runner 之前安装 Docker。
请阅读 FAQ,它介绍了您在使用极狐GitLab Runner 时最可能遇到的问题。
使用 deb/rpm 软件包
如有需要,可以通过 deb
或 rpm
软件包进行下载和安装。
下载
为您的系统下载合适的安装包:
- 在 https://gitlab-runner-downloads.s3.amazonaws.com/latest/index.html 中找到最新的文件名称和选项。
- 根据前沿极狐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"
安装
-
为您的系统安装软件包。
例如,对于 Debian 或 Ubuntu:
dpkg -i gitlab-runner_<arch>.deb
例如,对于 CentOS 或 Red Hat Enterprise Linux:
rpm -i gitlab-runner_<arch>.rpm
升级
下载您系统对应的最新的软件包并按照以下步骤升级:
例如,对于 Debian 或 Ubuntu:
dpkg -i gitlab-runner_<arch>.deb
例如,对于 CentOS 或 Red Hat Enterprise Linux:
rpm -Uvh gitlab-runner_<arch>.rpm
使用二进制文件
如有需要,可以通过二进制文件进行下载和安装。
安装
gitlab-runner
。-
为您的系统下载二进制文件:
# 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"
您可以为每个前沿-下载其他标签发布中描述的可用版本下载二进制文件。
-
授权执行:
sudo chmod +x /usr/local/bin/gitlab-runner
-
创建极狐GitLab CI 用户:
sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash
-
安装并作为服务运行:
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/
。
gitlab-runner
已安装并作为服务(此页面中描述的内容)运行,
它将以根用户身份运行,但将以 install
指定的用户身份执行作业。
这意味着一些作业功能,如缓存和产物需要执行 /usr/local/bin/gitlab-runner
命令。
因此,运行作业的用户需要有权限访问可执行文件。升级
-
停止服务(如以前一样,您需要升级的命令提示):
sudo gitlab-runner stop
-
下载二进制文件,替换极狐GitLab Runner 可执行文件。例如:
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64"
您可以为每个前沿-下载其他标签发布中描述的可用版本下载二进制文件。
-
授权执行:
sudo chmod +x /usr/local/bin/gitlab-runner
-
启动服务:
sudo gitlab-runner start