CircleCI本地执行报错：构建代理连接临时网络失败（无效名称/ID）

错误现象 #

执行circleci local execute --job test时，本机所有项目都会触发以下错误（其他机器可正常运行）：

$  circleci local execute --job test
Fetching latest build environment...
Docker image digest: sha256:0d6c17bb09da8707eabad913d61a68b28028906d48c176d6bd60ebd36cce222e
====>> Spin up environment
Build-agent version  ()
System information:
 Server Version: 20.10.20
 Storage Driver: overlay2
  Backing Filesystem: extfs
 Cgroup Driver: systemd
 Cgroup Version: 2
 Kernel Version: 5.15.74-1-lts
 Operating System: Arch Linux
 OSType: linux
 Architecture: x86_64

Error:
Unexpected environment preparation error: error connecting build-agent to ephemeral network: error connecting build-agent container to ephemeral network: Error response from daemon: invalid name or ID supplied: ""

Step failed
Task failed
Error: Unhandled prepare executor error: error connecting build-agent to ephemeral network: error connecting build-agent container to ephemeral network: Error response from daemon: invalid name or ID supplied: ""

日志更新 #

查看Docker systemctl日志后，定位到错误来源：

Oct 27 13:36:46 myhost dockerd[1238]: time="2022-10-27T13:36:46.455536188-05:00" level=error msg="Handler for POST /v1.41/networks/a878ce01450ef752f4610bca358d4bf6b590385f1300ddac605b475ed8536985/disconnect returned error: invalid name: "
Oct 27 13:36:46 myhost dockerd[1238]: time="2022-10-27T13:36:46.763284410-05:00" level=info msg="ignoring event" container=5276cac204527a25344183be31abef0592a91ce6c36c2160e16d4d5d59bde7c3 module=libcontainerd namespace=moby topic=/tasks/delete type="*events.TaskDelete"

问题解析 #

错误提示中的**“无效名称或ID”**，指的是Docker daemon在执行网络断开操作时，收到的容器名称/ID为空字符串。结合日志来看，是CircleCI CLI在创建临时网络后，尝试将build-agent容器从该网络解绑，但没有传递有效的容器标识，导致报错。

解决方向 #

• 版本兼容性检查：CircleCI CLI对Docker版本有适配要求，当前Docker 20.10.20可能与CLI版本不匹配，尝试升级或降级Docker至官方推荐版本
• 清理Docker残留：执行命令清理无效网络、僵尸容器，重置环境：

  docker network prune
  docker container prune
  

• 更新CircleCI CLI：升级到最新版本，修复旧版本可能存在的网络逻辑bug
• 调整Cgroup配置：当前系统使用Cgroup v2，部分旧版CircleCI CLI对其支持不完善，可尝试切换到Cgroup v1（Arch Linux可通过修改内核参数实现）

内容的提问来源于stack exchange，提问作者cheezsteak