用途:在 Kubernetes 集群中设置并安装 Ark 平台,基于 ark-cli 操作。支持两种模式:默认模式将 Ark 部署到现有集群;隔离 e2e 模式创建专用 Kind 集群用于测试,不影响现有集群。
主要能力:检查现有集群状态、创建 Kind 集群、从源码构建 ark-cli、安装 Ark、验证安装,以及 e2e 测试后的清理。也用于排查安装问题。
使用方式:先检查集群状态(kubectl cluster-info、kubectl get pods -n default、kind get clusters)。若已有集群,不要擅自销毁,需选择复用、新建隔离集群或替换。默认模式执行 kind create cluster --name ark-cluster;隔离模式执行 kind create cluster --name ark-e2e-test 并切换上下文。构建 ark-cli:npm install、cd tools/ark-cli、npm install、npm run build。安装:node tools/ark-cli/dist/index.js install --yes --wait-for-ready 5m;若 chart 版本未发布,可用 helm install 单独安装 ark-controller、ark-tenant、ark-api、ark-dashboard。验证:kubectl get pods -n default、kubectl get services -n default。清理:kind delete cluster --name ark-e2e-test。
前置条件:Docker、kubectl、Helm、Node.js、Kind。
限制与注意:不要使用 scripts/quickstart.sh(已弃用),不要用 npm install -g @agents-at-scale/ark,需从源码构建以匹配测试分支。CI 使用 K3s(仅 Linux),本地 Mac 测试使用 Kind,二者大体兼容但可能有细微差异。Mac 上 Docker Desktop 的默认 kubeconfig 无需替换 IP;在 Docker/DinD 内运行需配置 kubeconfig。
适用场景:安装或部署 Ark、为 e2e 测试构建隔离集群、部署到本地集群、排查安装问题。