用途:为 Ark 项目的多分支并行开发搭建隔离环境。集群数量与用户提供的分支数量一致,2 个分支即 2 个集群,依此类推。
主要能力:按分支创建 ark-cluster-N;分支 1 若与当前检出匹配则直接使用 $ARK_REPO,其余分支在 /tmp/ark-worktree-<branch-slug> 创建 worktree(分支名中的 / 替换为 -);自动清理 devspace/端口转发进程与已有 minikube profile;绑定各 worktree 的 devspace 上下文;写入 /tmp/ark-cluster-state.conf 供后续脚本使用;支持从 cluster-1 导出镜像并加载到其余集群以跳过重复构建。
端口规则:Dashboard = 3273+N,API = 8079+N,Gateway = 8089+N。
使用方式:先检查 minikube、kubectl、helm、devspace、docker 环境,设置 export ARK_REPO=~/agents-at-scale-ark。Docker Desktop 内存需求约为 0.7 GB 基础值加 N×2.2 GB,3 个集群至少约 7 GB。随后执行 bash .claude/skills/multi-branch-cluster-setup/scripts/setup-clusters.sh <branch1> <branch2> [branchN...],再在 cluster-1 执行 DOCKER_BUILDKIT=0 devspace deploy --kube-context ark-cluster-1 --namespace default --skip-push-local-kube,之后运行 transfer-images.sh 与 deploy-helm.sh,最后用 port-forward.sh start 启动转发。
适用场景:需要同时运行多个 Ark 分支进行对比、调试或并行开发时。
限制:首次构建约需 30–45 分钟;每个集群约占用 2.2 GB 内存,内存不足时 Pod 可能被 OOMKilled;ark-broker 或 ark-dashboard 出现 context canceled 通常由 BuildKit 引起,需设置 DOCKER_BUILDKIT=0 或改用手动 helm 部署;集群删除重建后需重新执行 devspace use context。