SuperAPI AI 工具集

package-clickstack-green

部署与运维

查看项目

更新于 10-16 02:38

技能介绍

用途:在单台虚拟机上部署 ClickStack(ClickHouse、MongoDB、HyperDX OpenTelemetry 采集器与 UI),作为单机可观测性栈运行。配置来自非机密 colors.yml,修改配置或执行生命周期操作前应先阅读 references/configuration.md。

主要能力:一个公网主机同时服务两部分,Caddy 终止 TLS,将 /v1/{logs,traces,metrics} 的 OTLP/HTTP 代理到采集器,其余路径提供 HyperDX UI。OTLP 导出器指向 https://<clickstack-host>,授权头使用服务器生成的摄取密钥。计算归属由固定的 colors-compute 库负责,包括提供方选择、远程 S3/R2 状态、部署协调、机器密钥、网络策略与单节点;本包提供单例拓扑及 SSH/HTTP 入口。

使用方式:./green build 检查适配能力,./green create --dry-run 预演,./green create 实际创建。使用 clickstack-ssh-sources 和 clickstack-http-sources 设置中立 CIDR 允许列表。凭据放在被 gitignore 的 .envrc.private 中,作为 COLORS_PAR_* 变量。不要设置 COLORS_PAR_PROFILE,也不要编辑或提交 .colors/。保留 compute-prevent-destroy: true。

限制与注意事项:需要受支持的 Ubuntu 镜像及足够内存。已有 clickstack-infrastructure.tfstate 会在计算变更前被拒绝,不可删除该文件绕过,应显式迁移所有权或先销毁旧部署。无法读取的状态与提供方不匹配会安全失败。仅 Caddy 80/443 与仅密钥 SSH 对外公开,管理员密码和摄取密钥在服务器生成且不出服务器。首次真实 create 会生成 ~/.ssh/<profile> 并在提供方注册;密钥位于检出目录之外。若提供 <provider>-ssh-keys 则选择退出,本包不触碰密钥材料。收敛会创建 clickstack-admin-email 指定的初始 HyperDX 团队,团队不存在前采集器不绑定任何 OTLP 接收器;摄取密钥写入 /etc/clickstack/ingestion.env。可通过 ssh <profile> 'cat /etc/clickstack/admin.env' 与 ssh <profile> 'cat /etc/clickstack/ingestion.env' 读取。其他细节暂未提供。