哨兵命令行界面

官方哨兵命令行界面

这是用于某些通用任务的 Sentry 命令行客户端。目前，如果您不使用 Fastlane 工具，这主要用于将调试符号上传到 Sentry。

• 下载可以在发布下找到

• 文档可以在这里找到

安装

如果您使用的是 OS X 或 Linux，您可以使用自动下载程序，它将为您获取最新版本并安装它：

curl -sL https://sentry.io/get-cli/ | bash

但是，我们确实鼓励您固定 CLI 的特定版本，以便您的构建始终可重现。为此，您可以使用完全相同的方法，并附加一个版本说明符：

curl -sL https://sentry.io/get-cli/ | SENTRY_CLI_VERSION=2.33.1 bash

这将自动下载适合您操作系统的正确版本的sentry-cli并安装它。如有必要，它会提示您输入sudo的管理员密码。对于不同的安装位置或没有sudo的系统（如 Windows），您可以在运行此命令之前export INSTALL_DIR=/custom/installation/path 。

如果您在 Windows 环境中使用sentry-cli ，则需要 Microsoft Visual C++ Redistributable。

要验证它是否正确安装，您可以调出帮助：

sentry-cli --help

点

2.14.3 中的新增功能： sentry-cli也可以使用pip安装：

 pip 安装哨兵-cli

节点

此外，您还可以通过 npm 安装此二进制文件：

npm install @sentry/cli

全局安装时，请确保对全局 node_modules 目录设置正确的权限。如果这在您的环境中不可行或者仍然产生 EACCESS 错误，请以 root 身份安装：

sudo npm install -g @sentry/cli --unsafe-perm

默认情况下，此包将从 Fastly 管理的 CDN 下载sentry-cli。要使用自定义 CDN，请设置 npm 配置属性sentrycli_cdnurl 。下载器将附加"//sentry-cli-" 。

 npm install @sentry/cli --sentrycli_cdnurl=https://mymirror.local/path

或者将属性添加到.npmrc文件中 (https://www.npmjs.org/doc/files/npmrc.html)

sentrycli_cdnurl=https://mymirror.local/path

您可以提供一些环境变量来控制 npm 安装：

SENTRYCLI_CDNURL= # Use alternative cdn url for downloading binary
SENTRYCLI_USE_LOCAL=1 # Use local instance of sentry-cli binary (looked up via $PATH environment)
SENTRYCLI_SKIP_DOWNLOAD=1 # Skip downloading binary entirely
SENTRYCLI_NO_PROGRESS_BAR=1 # Do not print the progress bar when downloading binary (default for non-TTY environments like CI)
SENTRYCLI_LOG_STREAM= # Changes where to redirect install script output

当通过 JavaScript API 或任何使用所述 API 的第三方插件使用sentry-cli时，您还可以使用SENTRY_BINARY_PATH=和SENTRYCLI_SKIP_DOWNLOAD=1来完全控制在整个过程中下载和使用哪些二进制文件。

如果您从代理后面使用 NPM 安装 CLI，则安装脚本将使用 NPM 的已配置 HTTPS 代理服务器或HTTPS_PROXY环境变量中的值。

自制

getsentry/tools Tap 中提供了自制配方：

brew install getsentry/tools/sentry-cli

码头工人

从版本1.25.0开始，有一个预装了sentry-cli的官方 Docker 镜像。如果您喜欢特定版本，请将其指定为标签。最新的开发版本发布在edge标签下。在生产中，我们建议您使用latest标签。要使用它，请运行：

 docker pull getsentry/sentry-cli
docker run --rm -v $(pwd):/work getsentry/sentry-cli --help

从版本2.8.0开始，如果您看到"error: config value 'safe.directory' was not found;"消息，您还需要正确设置已安装卷的 UID 和 GID，如下所示：

 docker run --rm -u "$(id -u):$(id -g)" -v $(pwd):/work getsentry/sentry-cli --help

这是由于旧版git实现中的安全问题所必需的。请参阅此处了解更多详细信息。

更新

要将sentry-cli更新到最新版本，请运行：

哨兵-cli 更新

编译

如果您想自己编译它，则至少需要安装以下依赖项：

• Rust 稳定和 Cargo

• Make、CMake 和 C 编译器

使用cargo编译：

$ cargo build

此外，还有一个 Dockerfile，它使用 PATH 中的sentry-cli构建基于 Alpine 的 Docker 镜像。要构建和使用它，请运行：

 docker build -t Sentry-cli .docker run --rm -v $(pwd):/work Sentry-cli --help