SuperAPI AI 工具集

package-github-dwh-blue

数据与分析

查看项目

更新于 10-16 02:38

技能介绍

用途:该技能包用于在单台主机上开通并运行一个 GitHub 组织级数据仓库,组合使用 ClickHouse、dlt、dbt、PocketBase、systemd、Vultr 和 Cloudflare。期望状态写在 colors.yml,生成产物位于 .colors/,凭据通过被忽略的 .envrc.private 中的 COLORS_PAR_* 变量提供。

主要能力与用法:使用内置 blue 启动器。先运行安全校验命令:./blue build、./blue create --dry-run、./blue run --dry-run。在获得明确授权后,./blue create 用于开通并收敛主机,./blue run 执行真实的 GitHub 加载与 dbt 构建,./blue delete 受保护且具破坏性。

所需凭据包括 COLORS_PAR_VULTR_API_KEY、COLORS_PAR_CLOUDFLARE_API_TOKEN、COLORS_PAR_GITHUB_TOKEN、COLORS_PAR_CLICKHOUSE_PASSWORD、COLORS_PAR_POCKETBASE_SUPERUSER_PASSWORD,以及多项 Lightdash 相关密码与密钥;当 provider-backend 为 r2 时还需 COLORS_PAR_R2_ACCESS_KEY_ID 和 COLORS_PAR_R2_SECRET_ACCESS_KEY。

限制与约束:切勿设置 COLORS_PAR_PROFILE、提交凭据、编辑 .colors/ 或削弱 compute-prevent-destroy。PocketBase 仅存储整次运行的控制面记录,不应加入任务 DAG、步骤队列、传感器或重试策略。计算资源开通与 SSH 密钥归属委托给 colors-compute,受管密钥使用 ~/.ssh/<profile>。R2 与 S3 为远程状态后端,S3 使用环境 AWS 凭据链。每日 3 点备份与禁用 IPv6 是明确要求,目前由库的 Vultr 适配器支持。旧的合并式 <profile>/tofu.tfstate 部署需经审查迁移后才能收敛,不得通过删除状态绕过归属检查。