用途:该包通过 colors-compute 在一台 VM 上部署单节点 SigNoz 可观测性栈,组件包括 ClickHouse、ClickHouse Keeper、Postgres metastore、迁移器、SigNoz、ingester 与 Caddy,并通过 Cloudflare 代理 A 记录对外提供 HTTPS UI。
主要能力:管理计算节点与网络策略、注册托管密钥、写入 ~/.ssh/config、创建 Cloudflare DNS 记录,并执行 Ansible 部署;验收测试检查 HTTPS 公共 UI 与拒绝未认证写入的 OTLP 端点。
使用方式:安装启动器: npx skills add getcolors/signoz cp .agents/skills/package-signoz-red/red ./red chmod +x red 可用动词:./red build、./red create --dry-run、./red create、./red delete。build 与 --dry-run 是检查 colors.yml 修改的安全方式,退出码 2 表示校验或用法失败并一次性列出所有问题。启动器会从工作目录向上查找 colors.yml。
配置与凭据:只编辑 colors.yml,键名用 kebab-case,只放非机密值;凭据放在被 git 忽略的 .envrc.private 的 COLORS_PAR_* 环境变量中,不得导出 COLORS_PAR_PROFILE。.colors/ 为生成输出,不可编辑或提交。删除受 compute-prevent-destroy: true 保护,仅可在单次运行时以 COLORS_PAR_COMPUTE_PREVENT_DESTROY=false 解除。
限制:需要受支持的 Ubuntu 镜像与足够内存运行全部组件。默认适配器为 vultr。SigNoz 请求 TCP 22、80、443,4317 与 4318 保持关闭;仅发布 OTLP/HTTP,gRPC 停留在回环。社区版无 ingestion keys,Caddy 以服务器生成 bearer token 仅允许 /v1/{logs,traces,metrics},用 ssh <profile> cat /etc/signoz/ingestion.env 读取并以 Authorization: Bearer <token> 发送。存在旧 signoz-infrastructure.tfstate 时会在计算变更前拒绝,不可删除该状态绕过。其余配置细节见 references/configuration.md。