[!NOTE] 我们正在构建一个 新的 Sentry CLI,具备 AI 驱动的工作流、内置 AI 技能,并为一等公民级别的 Agent 使用提供支持。它已经涵盖了多个
sentry-cli功能(包括 source maps),并计划成为下一个主要版本——API 高度对齐,因此届时迁移将非常平滑。如果您目前已在 CI/CD 流水线中使用
sentry-cli,您来对地方了——目前没有任何变更。 如果您需要 AI 能力或 Agent 集成,请尝试 新 CLI。
Sentry CLI
这是 Sentry CLI 的仓库,Sentry CLI 是 Sentry 的官方命令行界面。
Sentry CLI 可用于许多任务,包括将调试符号和 source maps 上传到 Sentry、管理发布版本,以及查看 Sentry 数据(如 issues 和 logs)。
安装与使用
请参阅 Sentry CLI 的文档页面。
兼容性
Sentry CLI 官方支持 Sentry SaaS 和 Sentry Self-Hosted 的 24.11.1 及以上版本。
自托管 Sentry
对于自托管安装,仅支持在相应自托管版本发布时 Sentry CLI 中可用的功能,因为新功能可能需要服务器端支持。此外,某些功能(如 sentry-cli build 命令)仅限于 Sentry SaaS。
建议使用 Sentry Self-Hosted 24.11.1 之前版本的用户,在使用 3.0.0 及更高版本的 Sentry CLI 之前,先升级其 Sentry Self-Hosted 安装。对于无法升级的用户,请使用下表中标明的版本。
| Sentry Self-Hosted 版本 | 最新兼容的 Sentry CLI 版本 |
|---|---|
| ≥ 24.11.1 | latest |
| < 24.11.1 | 2.58.6 |
请注意,我们仅能为官方支持的 Sentry Self-Hosted 版本提供支持。即使旧版 Sentry CLI 可能与您的自托管版本兼容,我们也不会为旧版 Sentry CLI 提供修复回移。
版本控制
Sentry CLI 遵循语义化版本控制,依据 此版本控制策略。
编译
如果您想自行编译,至少需要安装以下依赖项:
- Rust stable 和 Cargo
- Make、CMake 以及 C 编译器
使用 cargo 进行编译:
$ cargo build
此外,还有一个 Dockerfile,用于构建一个基于 Alpine 的 Docker 镜像,其中 PATH 包含 sentry-cli。要构建并使用它,请运行:
docker build -t sentry-cli .
docker run --rm -v $(pwd):/work sentry-cli --help