ITADN
getsentry/sentry-cli
README.md
以下内容由 AI 翻译,如有问题请点此提交 issue 反馈

Sentry

[!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 SaaSSentry 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.1latest
< 24.11.12.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

内部文档

快照:截至 2026-01-29 的 Sentry CLI 发行版