蓝盾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 取值:
- Apple Silicon Mac:
ARCH="arm64" - x86_64 机器:
ARCH=""(空字符串) - MIPS64 机器:
ARCH="mips64"
下载 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