Tracer-Cloud/opensre
运维与部署开源自托管 CI/CD 可靠性 CLI 代理,自动调查失败流水线、追踪根因并给出待审阅的修复。
项目介绍
OpenSRE 是一个面向 CI/CD 可靠性的命令行代理。流水线失败时,它会读取失败的检查项和 CI 日志,获取近期提交与部署,关联日志、指标和链路追踪,并在已连接的系统之间推理,把 CI 自身导致的失败和代码导致的失败区分开。随后给出带证据链接的回答,可以把修复推送到 PR 分支供人工审阅,也能把摘要发到 Slack、PagerDuty 或 Telegram。它面向需要更快定位根因的工程师和平台团队,默认不把原始日志批量外传。
代理可以在你自己的基础设施上运行,并自行选择模型提供方;调用外部 LLM 前可选择对敏感标识做掩码。网关既有可自托管的容器和 AWS AMI 部署方式,也有通过 OpenSRE Cloud 提供的托管网关。项目处于公开 alpha 阶段,API 和集成可能变化。
快速使用
开始前,在代码项目目录中打开终端;建议准备一个 Git 仓库以走完整流程。
macOS 或 Linux 下运行安装脚本并启动 CLI:
curl -fsSL https://install.opensre.com | bash -s -- -gh
opensre
Windows 使用 PowerShell 安装,具体步骤见 Windows 安装说明。安装器从 main 拉取最新构建,不需要 sudo;如果找不到 opensre,按安装器打印的 PATH 指引操作或新开终端。首次启动会要求登录并激活托管模型。
不带子命令运行时,opensre 会打开交互式 REPL(需要 TTY),用自然语言描述故障即可,并用 /help、/status、/cost、/integrations list、/integrations verify 等斜杠命令控制会话和检查集成,完整命令见交互式 shell 命令。若要在脚本或 CI 任务中只跑一轮,可用:
opensre ask "why is checkout-api slow?"
无头模式支持 stdin 提示、JSON 输出和工具审批,详见无头 CLI 指南。Python 用户可以从源码检出后通过 start_embedded_session 在进程内驱动代理,示例见 Python API。
部署与集成
自托管时可以构建仓库的 Dockerfile,选择 MODE,并设置 LLM_PROVIDER 及其 API 密钥;仅当网关需要共享的 Postgres 状态时才设置 DATABASE_URL。AWS 路线会构建网关镜像并用 systemd 部署,目前只支持 Telegram 网关。完整前置条件见 DEPLOYMENT.md。
集成范围较广:LLM 提供方包括 Anthropic、OpenAI、Ollama、Gemini、Bedrock 等;可观测性平台包括 Grafana、Datadog、Sentry、CloudWatch 等;此外还有 Kubernetes、AWS、Azure、ArgoCD、Helm、数据库、数据平台、代码托管和工单系统。README 中 Linear、Notion、Teams、Confluence 属于路线图条目,并非已可用集成 集成列表。
使用约束
交互式 shell 需要有效账户才能打开;可以退出并保持未登录,但 shell 只对已登录账户开放。嵌入式 Python API 需要从源码检出使用。遥测(一方产品分析和 Sentry 错误上报)默认开启,可用 export OPENSRE_NO_TELEMETRY=1 关闭 遥测说明。默认在本地处理会话记录,不会静默批量导出原始日志,安全模型见 SECURITY.md。项目以 Apache-2.0 许可发布,并标注为公开 alpha,核心工作流尚不稳定 许可证。
HotRepo 点评
在 2026-11-19 的 GitHub 全语言日榜上,OpenSRE 排到第 12 名,当日新增 25 star,总计 12,889 star、1,891 fork。对一个 2026 年 1 月创建、仍标注公开 alpha 的项目来说,这是很强的单日信号。目前只有一条榜单记录,因此它只能说明当天的名次,不能据此判断趋势。已发布的 CLI、有文档的 Python 嵌入方式、自托管部署路径和较广的集成表,使其成为一个可以实际评估的故障排查工具,但生产使用仍需考虑 alpha 阶段的限制。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。