花日

GitHub

标签

1707 字

9 分钟

蓝盾v7.1 mac intel系列芯片构建机业务构建进程异常退出

2026-01-05

蓝鲸

蓝鲸v7.1

/

蓝盾mac构建机

背景#

因为一些特殊的场景需要，找了一台老的intel macmini当作构建机。但是在执行任务时遇见了报错：构建进程执行错误.

这里的报错其实已经提示了一些重要信息

查看agent日志：devopsAgent.log#

在agent日志里找到了重要信息，这里的信息与蓝盾前端一致。

1
2025-10-14 21:14:26.848|info|build[b-a5082d1c7fc848c8a896349ea2450453] finish, delete:/Users/m100101825/bkci/build_tmp/b-a5082d1c7fc848c8a896349ea2450453_1_build_msg.log, err:%!s(<nil>)
2
2025-10-14 21:14:26.848|info|url:[https://devops.bk.diezhi.net/ms/dispatch/api/buildAgent/agent/thirdPartyAgent/workerBuildFinish]|request body: {"projectId":"client","buildId":"b-a5082d1c7fc848c8a896349ea2450453","vmSeqId":"1","workspace":"","pipelineId":"p-ccf93f681a7543cab29f16fa59569ccd","dockerBuildInfo":null,"executeCount":1,"containerHashId":"c-9228fbfd76154bef961d3fba0272f1ad","success":false,"message":"业务构建进程异常退出，可能被操作系统或其他程序杀掉，需自查并降低负载后重试，或解压 agent.zip 还原安装后重启agent再重试。","error":{"errorType":"USER","errorMessage":"构建进程执行错误","errorCode":2128040}}

我们看下这个报错：业务构建进程异常退出，可能被操作系统或其他程序杀掉，需自查并降低负载后重试，或解压 agent.zip 还原安装后重启agent再重试

agent安装流程#

当我们尝试导入一台构建机时，实际是分成了几个步骤：

step1：生成安装链接#

1
# 生成MACOS 链接
2
https://devops.bk.diezhi.net/ms/environment/api/user/environment/thirdPartyAgent/projects/client/os/MACOS/generateLink
3

4
# 生成 LINUX 链接
5
https://devops.bk.diezhi.net/ms/environment/api/user/environment/thirdPartyAgent/projects/client/os/LINUX/generateLink
6

7
# 生成Windows 链接
8
https://devops.bk.diezhi.net/ms/environment/api/user/environment/thirdPartyAgent/projects/client/os/WINDOWS/generateLink

安装链接里会包含重要的agentid，例如下面的dnprdwpe：

1
curl -H "X-DEVOPS-PROJECT-ID: client" https://devops.bk.diezhi.net/ms/environment/api/external/thirdPartyAgent/dnprdwpe/install | bash

step2：安装agent#

在构建机上执行安装命令，以macos的为例：

step2.1：判断构建机的芯片架构：#

1
function initArch() {
2
  ARCH=$(uname -m)
3
  case $ARCH in
4
    aarch64) ARCH="arm64";;
5
    arm64) ARCH="arm64";;
6
    mips64) ARCH="mips64";;
7
    *) ARCH="";;
8
  esac
9
}

关于ARCH的取值：

在 Apple Silicon Mac 上：ARCH=“arm64”
在 x86_64 机器(以及其他)上：ARCH="" # 空字符串，需要额外处理
在 MIPS64 机器上：ARCH=“mips64”

step2.2：下载agent#

1
function download_agent()
2
{
3
  echo "start download agent install package"
4
  if [[ -f "agent.zip" ]]; then
5
    echo "agent.zip already exist, skip download"
6
    return
7
  fi
8
  if exists curl; then
9
    curl -H "X-DEVOPS-PROJECT-ID: client" -o agent.zip "https://devops.bk.diezhi.net/ms/environment/api/external/thirdPartyAgent/ydmdkgpw/agent?arch=${ARCH}"
10
    if [[ $? -ne 0 ]]; then
11
      echo "fail to use curl to download the agent, use wget"
12
      wget --header="X-DEVOPS-PROJECT-ID: client" -O agent.zip "https://devops.bk.diezhi.net/ms/environment/api/external/thirdPartyAgent/ydmdkgpw/agent?arch=${ARCH}"
13
    fi
14
  elif exists wget; then
15
    wget --header="X-DEVOPS-PROJECT-ID: client" -O agent.zip "https://devops.bk.diezhi.net/ms/environment/api/external/thirdPartyAgent/ydmdkgpw/agent?arch=${ARCH}"
16
  else
17
    echo "curl & wget command don't exist, download fail"
18
    exit 1
19
  fi
20
}

会根据agentid、ARCH来拼接agent下载链接，因为构建机是的架构是x86_64，所以ARCH的值为空值，agentid是dnprdwpe，最终的agent下载链接：

1
https://devops.bk.diezhi.net/ms/environment/api/external/thirdPartyAgent/ydmdkgpw/agent?arch=

step2.3：解压agent资源#

先从agent.zip解压全部资源，

1
unzip -o agent.zip
2
unzip_jdk

再从解压出来的资源里，解压jdk资源

1
function unzip_jdk()
2
{
3
  echo "start unzipping the jdk package"
4
  if [[ -d "jdk" ]]; then
5
    echo "jdk already exists, skip unzip"
6
    return
7
  fi
8
  unzip -q -o jre.zip -d jdk
9
}

step2.4：验证jdk版本#

1
echo "check java version"
2
jdk/Contents/Home/bin/java -version

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

step2.5：尝试卸载agent#

这里是为了卸载已经存在的旧的agent环境。

1
function uninstallAgentService()
2
{
3
  if [[ "$user" != "root"  && -f ~/Library/LaunchAgents/$(getServiceName).plist ]]; then
4
    echo "remove run at load"
5
    rm -f ~/Library/LaunchAgents/$(getServiceName).plist
6
  fi
7

8
  cd ${workspace}
9
  chmod +x *.sh
10
  ${workspace}/stop.sh
11
}

主要是进行守护进程plist文件的清理，agent的停止等操作

step2.6：安装agent#

1
function installAgentService()
2
{
3
  if [[ "$user" != "root" ]]; then
4
    echo "add run at load with user ${user}"
5
    addRunAtLoad
6
  fi
7

8
  cd ${workspace}
9
  chmod +x *.sh
10
  ${workspace}/start.sh
11
}
12
function addRunAtLoad()
13
{
14
  mkdir -p ~/Library/LaunchAgents
15
  cat > ~/Library/LaunchAgents/$(getServiceName).plist <<EOF
16
<?xml version="1.0" encoding="UTF-8"?>
17
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
18
<plist version="1.0">
19
<dict>
20
    <key>Label</key>
21
        <string>$(getServiceName)</string>
22

23
    <key>Program</key>
24
        <string>${workspace}/devopsDaemon</string>
25

26
    <key>RunAtLoad</key>
27
        <true/>
28

29
    <key>WorkingDirectory</key>
30
        <string>${workspace}</string>
31

32
    <key>KeepAlive</key>
33
        <false/>
34
</dict>
35
</plist>
36
EOF
37
}

主要进行守护进程plist文件的创建，agent的启动等操作。

问题排查#

我们看下这个报错：业务构建进程异常退出，可能被操作系统或其他程序杀掉，需自查并降低负载后重试，或解压 agent.zip 还原安装后重启agent再重试

该问题七言曾经和蓝盾内部人员沟通过，多发与比较老的intel芯片架构的mac机器，根因是蓝盾agent打包时，目录结构存在问题。

jdk的执行路径是：jdk/Contents/Home/bin/

所以需要验证机器上是否存在该路径：

1
# 进入蓝盾agent安装目录
2
cd /Users/m100101825/bkci
3

4
# 进入jre目录，也可能是jdk目录
5
cd /jdk
6

7
# 查看目录结构
8
ls -la

经过验证确实是因为缺失了jdk/Contents/Home/bin/。

所以问题的根因就是下载了与该平台不匹配的agent资源包，所以agent找不到jdk，导致运行失败。

接下来需要确定蓝盾server端保存的agent资源包目录结构：

1
# 找到environment的pod，下面两个命令二选一
2
kubectl get pod -n blueking |grep bk-ci-bk-ci-environment
3
kubectl get pod -n blueking -l app.kubernetes.io/name=environment
4

5
# 登陆environment的pod：将bk-ci-bk-ci-environment-985dc6b59-hhtbn替换为实际podName即可
6
kubectl exec -it pod/bk-ci-bk-ci-environment-985dc6b59-hhtbn -n blueking -- bash
7

8
# 进入agent资源包路径
9
cd /data/workspace/agent-package/
10

11
# 进入jre目录，并查看jre(jre.zip)支持的平台，
12
cd jre && ls -l

jre支持的平台情况：

1
total 24
2
drwxr-xr-x 1 root root 4096 Sep  7  2023 linux
3
drwxr-xr-x 1 root root 4096 Sep  7  2023 linux_arm64
4
drwxr-xr-x 2 root root 4096 Sep  7  2023 linux_mips64
5
drwxr-xr-x 1 root root 4096 Sep  7  2023 macos
6
drwxr-xr-x 1 root root 4096 Sep  7  2023 macos_arm64
7
drwxr-xr-x 1 root root 4096 Sep  7  2023 windows

由于前面说的操作系统、agentid、ARCH的值情况，可以获知这台intel芯片的macos构建机使用的是macos目录下的jre.zip.

来看下目前的jre.zip的结构：

1
# 创建一个测试目录，并将现在的jre.zip解压进去
2
mkdir test && unzip jre.zip -d test
3

4
# 查看目录结构
5
cd test && ls -l

目录结果：

1
total 212
2
-r-xr-xr-x  1 root root   1522 May  9  2023 ASSEMBLY_EXCEPTION
3
drwxrwxrwx  2 root root   4096 Jul  4  2023 bin
4
drwxrwxrwx 10 root root   4096 Jul  4  2023 demo
5
drwxrwxrwx  3 root root   4096 Jul  4  2023 include
6
drwxrwxrwx  4 root root   4096 Jul  4  2023 jre
7
drwxrwxrwx  2 root root   4096 May  9  2023 lib
8
-r-xr-xr-x  1 root root  19274 May  9  2023 LICENSE
9
drwxrwxrwx  5 root root   4096 Jul  4  2023 man
10
-rwxrwxrwx  1 root root    105 May  9  2023 release
11
drwxrwxrwx 11 root root   4096 Jul  4  2023 sample
12
-r-xr-xr-x  1 root root 157063 May  9  2023 THIRD_PARTY_README

确实是缺失了/Contents/Home/bin/这个目录！！！

解决方案#

永久解决方案：#

想永久解决该问题，后续的所有intel芯片macos都可以直接一键安装，就需要重新打包正确的agent.zip资源包。

1
# 登陆跳板机(10.212.32.32)，并切换到root用户
2
kubecm switch platform-pops
3

4
# 找到environment的pod，下面两个命令二选一
5
kubectl get pod -n blueking |grep bk-ci-bk-ci-environment
6
kubectl get pod -n blueking -l app.kubernetes.io/name=environment
7

8
# 登陆environment的pod：将bk-ci-bk-ci-environment-985dc6b59-hhtbn替换为实际podName即可
9
kubectl exec -it pod/bk-ci-bk-ci-environment-985dc6b59-hhtbn -n blueking -- bash
10

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

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

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

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

构建机临时方案：#

本质上就是和在bk-ci的environment的pod里面做的事情一样，构造正确的jre目录结构

1
# 进入蓝盾agent安装目录
2
cd /Users/m100101825/bkci/jdk
3

4
# 进入jre目录，也可能是jdk目录
5
cd /jdk
6

7
# 将jre.zip 复制过来
8
cp ../jre.zip ./
9

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

13
# 将jre.zip解压到Contents/Home，然后agent就可以通过jdk/Contents/Home/bin/来找到jdk
14
unzip jre.zip -d Contents/Home
15

16
# 重新打包jre，以防下次使用本机上的agent资源包安装时，修复的jdk被覆盖
17
zip jre.zip -d Contents && mv jre.zip ../jre.zip
18

19
# 回到agent安装目录，并重新启动agent
20
cd /Users/m100101825/bkci && bash stop.sh && bash start.sh

蓝盾v7.1 mac intel系列芯片构建机业务构建进程异常退出

https://hua-ri.cn/posts/蓝盾v71mac构建机业务构建进程异常退出/

作者

花日

发布于