用途:在单一 VPC 内的六台 AWS 或 Vultr 机器上自托管 Langfuse v4.27.0,统一收敛部署 Neon 存储层(storage broker、pageserver、一个 safekeeper、compute_ctl 下的 Postgres 17、数据与 WAL 存于 R2)、Redis 7.2、三个各带 Keeper voter 的 ClickHouse 副本,以及运行 langfuse-web、langfuse-worker 和 Cloudflare 后 Caddy 的应用主机。
安装与用法:
npx skills add getcolors/langfuse cp .agents/skills/package-langfuse-blue/blue ./blue chmod +x blue
根目录 blue 是载荷副本而非符号链接,执行 npx skills update -p 后需重新复制。命令包括:./blue build(仅渲染 .colors/<profile>/,无凭据调用)、./blue create --dry-run、./blue create、./blue rehearse、./blue describe、./blue delete(删除不触及 R2)。build 与 --dry-run 可在空环境运行;退出码 2 表示校验失败并列出全部问题。
凭据:非机密期望状态在 colors.yml;凭据均为 COLORS_PAR_* 环境变量,如 VULTR_API_KEY、CLOUDFLARE_API_TOKEN、R2 访问密钥、LANGFUSE_ENCRYPTION_KEY(64 位十六进制)、LANGFUSE_SALT(≥32 字符)、LANGFUSE_INIT_USER_PASSWORD(≥12 字符),建议放入被 git 忽略的 .envrc.private。ENCRYPTION_KEY、SALT、初始密码需操作者自行保管。
收敛保证:每次收敛运行门禁,包括 TCP 连通、UTC 时间、副本可见性、Keeper 仲裁、写入并读回 trace/generation/score 与 R2 原始事件、媒体 sha256 回读、错误凭据拒绝、200 条 trace 可查、内存低于 85% 等。rehearse 演练从备份恢复两个存储并验证 .colors-recovery-verified。
限制:Redis 主机故障无自动恢复,队列作业丢失;Neon 主机恢复 RPO 约 6 小时;整个 ClickHouse 集群恢复 RPO 约 24 小时。浏览器渲染媒体需在存储桶配置 CORS 规则,需 Admin R2 令牌。AWS 托管部署需指定 provider-compute: aws、provider-backend: s3 等配置。其他细节暂未提供。