银河麒麟系统部署gitlab runner的四种方案：一、离线rpm安装（适配断网环境）；二、docker容器化部署（推荐arm64）；三、二进制文件直装（最小依赖）；四、麒麟软件源安装（部分v10支持）。
如果您在银河麒麟操作系统上部署CI/CD流水线，但GitLab Runner无法正常注册或执行作业，则可能是由于系统依赖缺失、架构适配不当或服务配置不匹配所致。以下是针对麒麟OS环境安装与配置GitLab Runner的多种可行方案：
一、使用离线RPM包手动安装（适用于完全断网环境）
该方法适用于中标麒麟7.4、银河麒麟V10等无外网访问能力的生产环境，通过预下载全部依赖并本地安装，规避网络限制与仓库兼容性问题。
1、在同构环境（如CentOS 7.9虚拟机）中安装yum-utils工具：
sudo yum install -y yum-utils
2、创建离线包存放目录：
mkdir -p /opt/gitlabrunner
3、下载gitlab-runner主程序及其全部运行时依赖：
yumdownloader --resolve gitlab-runner
4、单独下载rsync依赖（银河麒麟7.4默认未安装）：
yumdownloader --resolve rsync
5、将所有.rpm文件复制至目标麒麟系统/opt/gitlabrunner/目录下
6、按依赖顺序依次安装：
sudo rpm -ivh rsync-3.1.2-12.el7_9.x86_64.rpm
7、安装Perl基础组件：
sudo rpm -ivh perl-TermReadKey-2.30-20.el7.x86_64.rpm perl-Error-0.17020-2.el7.noarch.rpm
8、同步安装Git核心组件（存在循环依赖）：
sudo rpm -ivh perl-Git-1.8.3.1-25.el7_9.noarch.rpm git-1.8.3.1-25.el7_9.x86_64.rpm
9、安装gitlab-runner及helper镜像包：
sudo rpm -ivh gitlab-runner-18.3.0-1.x86_64.rpm gitlab-runner-helper-images-18.3.0-1.noarch.rpm
10、验证安装结果：
sudo gitlab-runner --version
二、基于Docker容器化部署（推荐ARM64架构场景）
该方式利用Docker隔离运行时环境，避免与麒麟系统底层库冲突，特别适配银河麒麟V10 SP2的ARM64平台，且便于版本回滚与资源管控。
1、确认Docker引擎已就绪：
sudo docker --version
2、若未安装，使用麒麟软件源安装稳定版：
sudo apt-get update && sudo apt-get install -y docker.io
3、拉取官方GitLab Runner镜像（适配ARM64）：
sudo docker pull gitlab/gitlab-runner:alpine-v18.3.0
4、创建持久化配置目录：
sudo mkdir -p /srv/gitlab-runner/config
5、启动容器并挂载配置卷：
sudo docker run -d --name gitlab-runner --restart always -v /srv/gitlab-runner/config:/etc/gitlab-runner -v /var/run/docker.sock:/var/run/docker.sock gitlab/gitlab-runner:alpine-v18.3.0
6、进入容器执行注册：
sudo docker exec -it gitlab-runner gitlab-runner register
7、注册时需提供GitLab实例URL、项目或组Runner Token及唯一描述性标签
三、直接部署二进制文件（轻量级最小依赖方案）
该方法跳过包管理器，以单体二进制形式运行，适用于对系统侵入性要求极低的嵌入式或加固型麒麟节点，仅需基础glibc与curl支持。
1、下载最新稳定版Linux ARM64二进制文件：
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/v18.3.0/releases/gitlab-runner-linux-arm64"
2、赋予可执行权限：
sudo chmod +x /usr/local/bin/gitlab-runner
3、创建专用运行用户：
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 --config=/etc/gitlab-runner/config.toml
5、启动服务：
sudo gitlab-runner start
6、执行注册流程，输入GitLab服务器地址、注册Token和执行器类型（如shell或docker）
四、通过麒麟软件源安装（仅限部分V10版本支持）
部分银河麒麟V10 SP2更新源已集成gitlab-runner软件包，适合快速验证部署，但版本可能滞后，需确认源可用性与架构匹配度。
1、刷新软件源列表：
sudo apt-get update
2、搜索可用包：
apt-cache search gitlab-runner
3、若返回结果包含gitlab-runner，则执行安装：
sudo apt-get install -y gitlab-runner
4、检查服务状态：
sudo systemctl status gitlab-runner
5、若服务未激活，启用并启动：
sudo systemctl enable gitlab-runner && sudo systemctl start gitlab-runner
6、注册前确保/etc/gitlab-runner/config.toml权限为600且属主为gitlab-runner用户
