蓝盾v7.1-Mac构建机业务构建进程异常退出

背景

因为一些特殊的场景需要,找了一台老的 Intel Mac Mini 当作构建机。但是在执行任务时遇见了报错:构建进程执行错误。

查看 Agent 日志:devopsAgent.log

在 agent 日志里找到了重要信息,与蓝盾前端一致:

2025-10-14 21:14:26.848|info|build[b-a5082d1c7fc848c8a896349ea2450453] finish
...
"message":"业务构建进程异常退出,可能被操作系统或其他程序杀掉,需自查并降低负载后重试,或解压 agent.zip 还原安装后重启agent再重试。"
"error":{"errorType":"USER","errorMessage":"构建进程执行错误","errorCode":2128040}

Agent 安装流程

当我们尝试导入一台构建机时,实际分成几个步骤:

step1:生成安装链接

# 生成 MACOS 链接
https://devops.bk.example.com/ms/environment/api/user/environment/thirdPartyAgent/projects/client/os/MACOS/generateLink

安装链接里会包含重要的 agentid,例如:

curl -H "X-DEVOPS-PROJECT-ID: client" https://devops.bk.example.com/ms/environment/api/external/thirdPartyAgent/<agentid>/install | bash

step2:安装 Agent

判断构建机芯片架构:

function initArch() {
  ARCH=$(uname -m)
  case $ARCH in
    aarch64) ARCH="arm64";;
    arm64) ARCH="arm64";;
    mips64) ARCH="mips64";;
    *) ARCH="";;
  esac
}

ARCH 取值:

下载 Agent:

根据 agentid 和 ARCH 拼接下载链接。x86_64 架构的 ARCH 为空,最终链接:

https://devops.bk.example.com/ms/environment/api/external/thirdPartyAgent/<agentid>/agent?arch=

解压 Agent 资源:

unzip -o agent.zip
# 解压 JDK
unzip -q -o jre.zip -d jdk

验证 JDK 版本:

jdk/Contents/Home/bin/java -version

此处的验证 JDK 执行路径是 jdk/Contents/Home/bin/,这里的路径就是本次出现问题的原因。

问题排查

该问题曾与蓝盾内部人员沟通过,多发于比较老的 Intel 芯片架构的 Mac 机器,根因是蓝盾 Agent 打包时目录结构存在问题。

JDK 的执行路径是 jdk/Contents/Home/bin/,但验证发现构建机上缺失了该路径。

确认蓝盾 Server 端保存的 Agent 资源包目录结构:

# 找到 environment pod
kubectl get pod -n blueking -l app.kubernetes.io/name=environment

# 登陆 pod
kubectl exec -it pod/<pod-name> -n blueking -- bash

# 查看 jre 支持的平台
cd /data/workspace/agent-package/jre && ls -l

jre 支持的平台:

drwxr-xr-x 1 root root 4096 Sep  7  2023 linux
drwxr-xr-x 1 root root 4096 Sep  7  2023 linux_arm64
drwxr-xr-x 2 root root 4096 Sep  7  2023 linux_mips64
drwxr-xr-x 1 root root 4096 Sep  7  2023 macos
drwxr-xr-x 1 root root 4096 Sep  7  2023 macos_arm64
drwxr-xr-x 1 root root 4096 Sep  7  2023 windows

Intel 芯片的 macOS 使用的是 macos 目录下的 jre.zip,解压后的目录结构:

total 212
-r-xr-xr-x  1 root root   1522 May  9  2023 ASSEMBLY_EXCEPTION
drwxrwxrwx  2 root root   4096 Jul  4  2023 bin
drwxrwxrwx  4 root root   4096 Jul  4  2023 jre
drwxrwxrwx  2 root root   4096 May  9  2023 lib
...

确实缺失了 /Contents/Home/bin/ 这个目录。问题根因:下载了与该平台不匹配的 Agent 资源包,Agent 找不到 JDK,导致运行失败。

解决方案

永久解决方案

重新打包正确的 jre.zip 资源包,后续所有 Intel 芯片 macOS 都可以直接一键安装:

# 登陆 environment pod
kubectl exec -it pod/<pod-name> -n blueking -- bash

# 进入 agent 资源包路径
cd /data/workspace/agent-package/jre/macos

# 手动创建缺失的目录
mkdir -p Contents/Home

# 将 jre.zip 解压进去
unzip jre.zip -d Contents/Home

# 重新打包 jre.zip
zip -r jre.zip Contents

构建机临时方案

在构建机上手动构造正确的 JRE 目录结构:

# 进入蓝盾 agent 安装目录的 jdk 目录
cd /Users/<username>/bkci/jdk

# 将 jre.zip 复制过来
cp ../jre.zip ./

# 创建缺失的 Contents/Home 目录
mkdir -p Contents/Home

# 解压到 Contents/Home
unzip jre.zip -d Contents/Home

# 重新打包 jre,防止下次安装时修复被覆盖
zip jre.zip -d Contents && mv jre.zip ../jre.zip

# 回到 agent 安装目录,重新启动 agent
cd /Users/<username>/bkci && bash stop.sh && bash start.sh