统信UOS安装配置GitLab Runner教程

作者:技术拾光

时间:2026-06-20

浏览:612

在统信UOS上部署开源持续集成工具GitLabRunner,需要首先明确系统系列(D系列基于Debian使用APT,A系列基于CentOS使用DNF),然后再安装对应版本,然后注册并配置服务及设置开机自启。信创环境可改用CustomExecutor并自定义脚本,以此绕过容器依赖。

文章目录

在统信UOS中接入CI/CD流水线,部署GitLab Runner是首要步骤。但在执行gitlab-runner register时,系统可能直接提示“command not found”,导致流程中断。这通常是因为未正确安装或注册Runner。标准的流程应为:选择匹配的版本、配置系统服务、完成安全注册。完成这三步后,Runner才能与GitLab实例绑定。

以下从第一步开始说明。

统信UOS安装配置GitLab Runner教程

确定UOS的系列类型

统信UOS包含D系列(基于Debian,如专业版23、个人版2024)和A系列(基于CentOS Stream/RHEL,如服务器版A23)。两个系列的包管理器不同——在D系列上使用dnf、在A系列上使用apt,都会报错。因此需先确认系统版本。

打开终端,运行cat /etc/os-release | grep -E "(VERSION_CODENAME|ID_LIKE)"。若输出包含ID_LIKE=debian,则为D系列;若包含ID_LIKE="centos rhel fedora",则为A系列。确认系统类型后,后续安装才有依据。

D系列UOS:两种安装方式

D系列推荐使用APT源安装,适合日常开发和快速验证。执行以下命令:

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

官方脚本会自动获取最新稳定版。

生产环境中,建议采用精确版本锁定方式。先查询可用版本:apt-cache madison gitlab-runner,选择稳定版本(如16.11.0),执行sudo apt install gitlab-runner=16.11.0-1。安装后用sudo apt-mark hold gitlab-runner锁定版本,防止自动升级引发CI脚本兼容性问题。

A系列UOS:同样两种方式

A系列使用DNF。官方源安装方式:

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

安装路径为/usr/bin/gitlab-runner。

在离线环境或严格管控系统中,可手动下载RPM包安装。从GitLab Runner Releases页面选择对应架构的包(如gitlab-runner-16.11.0-1.el8.x86_64.rpm),执行sudo rpm -ivh gitlab-runner-16.11.0-1.el8.x86_64.rpm。若提示依赖缺失,运行sudo dnf install systemd解决。

配置服务:用户创建、注册、开机自启

安装完成后需配置服务。

第一步,创建专用运行用户。执行sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash,实现权限隔离,避免以root身份运行作业。

第二步,注册Runner到GitLab实例。执行sudo gitlab-runner register,按提示输入:GitLab实例URL(如https://gitlab.example.com)、Registration Token(从GitLab项目或群组的Settings → CI/CD → Runners页面获取)、描述(如uos-d23-arm64-runner)、Tags(用英文逗号分隔,如build,python,arm64),以及Executor。初始阶段选择shell最简便,后续可根据需要切换为custom。

第三步,启动服务并设置开机自启:sudo gitlab-runner start → sudo gitlab-runner status确认状态为running → sudo systemctl enable gitlab-runner。完成后在GitLab Web界面的Active Runners列表中可看到该Runner。

信创环境适配:更换为Custom Executor

若目标环境禁用容器、需要国密算法或对接国产调度总线,可将Executor切换为custom。步骤如下:

① 暂停Runner:sudo gitlab-runner stop

② 在/opt/gitlab-runner/custom/目录下准备三个脚本,并赋予可执行权限。各脚本功能:prepare校验CI_PROJECT_URL、调用国产Git客户端clone、加载BabaSSL库路径;run流式读取.gitlab-ci.yml中的script字段,注入GCMODE=sm2等环境变量;cleanup强制卸载临时挂载点,用SM3计算workspace哈希并写入审计日志。

③ 修改/etc/gitlab-runner/config.toml,将executor = "shell"改为executor = "custom",并在[runners.custom]段落下指定三个脚本路径。

④ 重启服务:sudo gitlab-runner start

切换后,Runner完全绕过Docker依赖,所有作业生命周期由自定义脚本接管,满足信创环境对可控性的要求。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›