Sentry-Cli

Offizielle Sentry-Befehlszeilenschnittstelle

Dies ist ein Sentry-Befehlszeilenclient für einige allgemeine Aufgaben. Derzeit wird dies hauptsächlich zum Hochladen von Debug-Symbolen auf Sentry verwendet, wenn Sie die Fastlane-Tools nicht verwenden.

• Downloads finden Sie unter Veröffentlichungen

• Die Dokumentation finden Sie hier

Installation

Wenn Sie OS X oder Linux verwenden, können Sie den automatischen Downloader verwenden, der die neueste Release-Version für Sie abruft und installiert:

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

Wir empfehlen Ihnen jedoch, die spezifische Version der CLI anzupinnen, damit Ihre Builds immer reproduzierbar sind. Dazu können Sie genau dieselbe Methode verwenden, mit einem zusätzlichen Versionsspezifizierer:

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

Dadurch wird automatisch die richtige Version von sentry-cli für Ihr Betriebssystem heruntergeladen und installiert. Bei Bedarf werden Sie zur Eingabe Ihres Administratorkennworts für sudo aufgefordert. Für einen anderen Installationsort oder für Systeme ohne sudo (wie Windows) können Sie export INSTALL_DIR=/custom/installation/path bevor Sie diesen Befehl ausführen.

Wenn Sie sentry-cli in Windows-Umgebungen verwenden, ist Microsoft Visual C++ Redistributable erforderlich.

Um zu überprüfen, ob die Installation korrekt ist, können Sie die Hilfe aufrufen:

sentry-cli --help

Pip

Neu in 2.14.3 : sentry-cli kann auch mit pip installiert werden:

 pip install sentry-cli

Knoten

Darüber hinaus können Sie diese Binärdatei auch über npm installieren:

npm install @sentry/cli

Stellen Sie bei der globalen Installation sicher, dass Sie die richtigen Berechtigungen für das globale Verzeichnis „node_modules“ festgelegt haben. Wenn dies in Ihrer Umgebung nicht möglich ist oder immer noch ein EACCESS-Fehler auftritt, installieren Sie als Root:

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

Standardmäßig lädt dieses Paket sentry-cli vom von Fastly verwalteten CDN herunter. Um ein benutzerdefiniertes CDN zu verwenden, legen Sie die npm-Konfigurationseigenschaft sentrycli_cdnurl fest. Der Downloader hängt "//sentry-cli-" .

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

Oder fügen Sie eine Eigenschaft zu Ihrer .npmrc Datei hinzu (https://www.npmjs.org/doc/files/npmrc.html).

sentrycli_cdnurl=https://mymirror.local/path

Es gibt einige Umgebungsvariablen, die Sie zur Steuerung der npm-Installation bereitstellen können:

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

Wenn Sie sentry-cli über die JavaScript-API oder ein Drittanbieter-Plugin verwenden, das diese API nutzt, können Sie neben SENTRYCLI_SKIP_DOWNLOAD=1 auch SENTRY_BINARY_PATH= verwenden, um vollständig zu steuern, welche Binärdateien während des gesamten Prozesses heruntergeladen und verwendet werden.

Wenn Sie die CLI mit NPM hinter einem Proxy installieren, verwendet das Installationsskript entweder den konfigurierten HTTPS-Proxyserver von NPM oder den Wert aus Ihrer HTTPS_PROXY Umgebungsvariablen.

Homebrew

Ein Homebrew-Rezept finden Sie im getsentry/tools -Tap:

brew install getsentry/tools/sentry-cli

Docker

Ab Version 1.25.0 gibt es ein offizielles Docker-Image, auf dem sentry-cli vorinstalliert ist. Wenn Sie eine bestimmte Version bevorzugen, geben Sie diese als Tag an. Die neueste Entwicklungsversion wird unter dem edge -Tag veröffentlicht. In der Produktion empfehlen wir Ihnen, das latest Tag zu verwenden. Um es zu verwenden, führen Sie Folgendes aus:

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

Wenn Sie ab Version 2.8.0 Folgendes sehen "error: config value 'safe.directory' was not found;" Meldung müssen Sie auch UID und GID der gemounteten Volumes korrekt festlegen, etwa so:

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

Dies ist aufgrund von Sicherheitsproblemen in älteren git Implementierungen erforderlich. Weitere Einzelheiten finden Sie hier.

Aktualisieren

Um sentry-cli auf die neueste Version zu aktualisieren, führen Sie Folgendes aus:

 Sentry-Cli-Update

Kompilieren

Falls Sie dies selbst kompilieren möchten, müssen Sie mindestens die folgenden Abhängigkeiten installieren:

• Roststabil und tragbar

• Make, CMake und ein C-Compiler

Verwenden Sie Fracht zum Kompilieren:

$ cargo build

Außerdem gibt es eine Docker-Datei, die mit sentry-cli im PATH ein Alpine-basiertes Docker-Image erstellt. Um es zu erstellen und zu verwenden, führen Sie Folgendes aus:

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