哨兵命令列介面

官方哨兵命令列介面

這是用於某些通用任務的 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