用途:这是一套在单台 Vultr 实例上运行 WaveHouse 分析演示的部署方案,组件包括 ClickHouse、WaveHouse 网关和实时 GitHub 统计仪表板。Dashboard 展示所配置 GitHub 仓库的统计信息,创建时通过 GitHub API 回填历史数据,并由 60 秒轮询持续通过 SSE 推送实时数据。
使用方式:修改配置或执行生命周期操作前,先阅读 references/configuration.md。常用命令: ./green build ./green create --dry-run ./green create 先构建并试运行,再执行真实创建;真实创建结束时会进行公开 HTTPS 健康检查、仪表板检查以及回填数据验收检查。
安全限制:凭据保存在被 gitignore 的 .envrc.private 中,以 COLORS_PAR_* 变量形式存放;不要设置 COLORS_PAR_PROFILE,也不要编辑或提交 .colors/。保留 compute-prevent-destroy: true,删除需要单独明确授权并进行一次性的环境覆盖。对外仅开放 Caddy 的 80/443 端口与仅密钥 SSH;网关操作密钥在服务器生成且不离开服务器。
其他说明:计算与 SSH 归属委托给 colors-compute;未提供的 SSH 设置使用 ~/.ssh/<profile>,已提供的账户密钥引用保持外部。该包用带锁的更新器维护 profile SSH 别名并拒绝外部条目。R2/S3 计算状态位于 <profile>/compute/ 下;若已存在 <profile>/wavehouse-infrastructure.tfstate,需先经审查迁移再执行常规生命周期命令。