用途:在单台 VM 上部署并运维面向生产环境的单节点 Rybbit 分析服务,组件包括 PostgreSQL、ClickHouse、Redis 和 Caddy。配置来自非机密的 colors.yml,修改配置或执行生命周期操作前应先阅读 references/configuration.md。
主要能力:计算资源归属由固定的 colors-compute 库负责,涵盖提供商选择、远程 S3/R2 状态、部署协调、机器密钥、网络策略与单节点;本包提供单例拓扑及 SSH/HTTP 入口,并使用返回的地址、登录用户和 SSH 身份执行应用步骤。应用需要受支持的 Ubuntu 镜像及足够内存。
使用方式:先构建以检查适配器能力,再试运行,最后创建。命令为 ./green build、./green create --dry-run、./green create。真实创建以验收结束:HTTPS 健康检查并验证证书、从 ClickHouse 读回合成事件、以及由 R2 中新对象确认的备份演练。
网络与安全:Rybbit 需要 TCP 22(SSH)、TCP 80/443(HTTP)和 UDP 443(HTTP/3);HTTP 来源为空会同时关闭 HTTP 与 HTTP/3 入口。仅 Caddy 的 80/443 对外公开,PostgreSQL、ClickHouse、Redis 及 Rybbit 后端和客户端端口保留在私有 Compose 网络。凭据应放在被 gitignore 的 .envrc.private 中作为 COLORS_PAR_* 变量;不要设置 COLORS_PAR_PROFILE 或编辑/提交 .colors/;保持 compute-prevent-destroy: true。
限制:已存在的 <profile>/rybbit-infrastructure.tfstate 会在计算变更前被拒绝,不可删除以绕过,需显式迁移归属或先通过原版本销毁旧部署;不可读状态与提供商不匹配会失败关闭。默认计算提供商为 vultr。rybbit-disable-signup 为期望状态,因 Rybbit 无首次运行引导,须在注册首个账户前保持 false,之后设为 true 关闭公开注册。其他细节暂未提供。