统信UOS系统安装配置GitLab Runner持续集成工具详细教程

要在统信UOS系统中顺利接入CI/CD流水线，第一步就是部署GitLab Runner。不过别急着直接敲命令——很多人都在这一步卡住：当执行gitlab-runner register时，系统直接提示“command not found”。说白了，既没有正确安装，也没有完成注册，Runner根本不知道自己该绑定到哪里。正确的操作流程应该是：先选对版本并安装，再配置好系统服务，最后完成安全注册。这三步走完，Runner才算真正与GitLab实例建立绑定关系。

好，咱们就从第一步开始讲起。

先搞清楚你的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：两种方法安装Runner

如果是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。这样做是为了实现权限隔离——如果Runner以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列表里应该已经能看到它的身影了。

信创环境专属：切换为Custom Executor

如果目标环境禁用了容器、要求使用国密算法、或者需要对接国产调度总线，那就得把Executor换成custom。步骤并不复杂，但细节很多：

① 先停止服务：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依赖，所有作业生命周期都由你控制的脚本接管——这正是信创环境所需要的“可控感”。