用途:这是一个 Green 包,用于在 DigitalOcean Kubernetes(DOKS)上部署、收敛、检查或删除 NetBird Agent Network 演示。它配置一个 NetBird 网关和一个双 Pod 应用,适用于无密钥 LLM 网关,或运行在托管集群上的隔离 AI 智能体。
主要能力:NetBird 客户端以 netstack/SOCKS5 模式运行,不使用 TUN 或额外 capabilities。隔离的智能体运行 Claude Code,其 NetworkPolicy 仅允许 SOCKS5 监听端口,不提供 DNS 和 ServiceAccount token。验收测试将出站流量和连接导向 SOCKS5,并验证隧道身份、模型限制、预算上限和访问日志归属。
使用方式:非机密的期望状态统一写在 colors.yml 中。主机名及其通配符必须在 Cloudflare 区域内可用。应用设置和凭据通过配置读取,禁止导出 COLORS_PAR_PROFILE。常用命令为:./green build、./green create --dry-run、./green create、./green delete、./green status、./green kubectl -- get pods -A。build 在无凭据、无提供方调用下渲染;create --dry-run 跳过副作用;退出码 2 表示校验或用法失败;启动器会从当前目录向上查找 colors.yml。
计算依赖与状态:color-compute 库负责托管计算、提供方校验、版本预检、远程状态、kubeconfig 处理和提供方清理检查。托管控制平面使用其提供方 API,不需要 SSH 密钥或 VM 分发。计算状态存于 <profile>/compute/managed-kubernetes.tfstate,归属信息存于 <profile>/compute/coordination.json;包注册表状态存于 <profile>/agent-network-doks-registry.tfstate,可使用 R2 或 S3。已有的合并状态 agent-network-doks-infrastructure.tfstate 必须显式拆分并审查后才能用于新生命周期,否则执行会被拒绝。
限制:没有备份。删除后再创建会重新生成对端身份和端点主机名。支持使用故意伪造的 COLORS_PAR_ANTHROPIC_API_KEY;删除需先确认清理完成。其他收费、价格、平台细节资料未提供。