用途:安装并验证 Goldsky CLI(含 Compose、Turbo),完成账号认证与项目配置,供后续构建数据流水线、部署子图使用。
主要能力:通过捆绑安装脚本 bash scripts/install.sh 安装工具,可传 cli、compose 或 turbo 参数选择组件;用 goldsky project list 检查登录状态并列出项目;用 goldsky login 在浏览器完成登录(不接收也不传递 --token);用 goldsky project create --name "my-new-project" 创建项目;用 goldsky project users invite --emails user@example.com --role Editor 邀请成员,角色有 Owner、Admin、Editor、Viewer。
使用方式:每次新 shell 调用需恢复 PATH:export PATH="$HOME/.local/bin:$HOME/.goldsky/bin:$PATH",再执行 goldsky --version 等版本检查。登录后必须用 goldsky project list 验证,失败则重新登录。切换账号用 goldsky logout 后重新登录并再次验证。
适用场景:需要为 Goldsky 流水线或子图准备认证与项目环境时;完成后可继续使用 /secrets 配置 PostgreSQL、ClickHouse、Kafka 等接收端凭据,或创建流水线、部署子图。
限制:Goldsky 与 Compose 提供 macOS Intel/Apple Silicon 及 Linux x64/ARM64 二进制;Linux Turbo 需 x64 与 glibc 2.39+,Mac Turbo 仅支持 Apple Silicon,不满足时须报告安装不完整。Windows 需在 x64 Ubuntu 24.04+ 的 WSL 中运行全部工具,安装 WSL 本身可能需要管理员权限与重启。环境需具备 Bash、curl、CA 证书、标准 Unix 工具、网络与可写主目录。不要在对话中处理 API token。