sentinelle cli

Interface officielle de ligne de commande Sentry

Il s'agit d'un client de ligne de commande Sentry pour certaines tâches génériques. À l'heure actuelle, cela est principalement utilisé pour télécharger des symboles de débogage sur Sentry si vous n'utilisez pas les outils Fastlane.

• Les téléchargements peuvent être trouvés sous Versions

• La documentation peut être trouvée ici

Installation

Si vous utilisez OS X ou Linux, vous pouvez utiliser le téléchargeur automatisé qui récupérera la dernière version pour vous et l'installera :

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

Nous vous encourageons cependant à épingler la version spécifique de la CLI, afin que vos builds soient toujours reproductibles. Pour ce faire, vous pouvez utiliser exactement la même méthode, avec un spécificateur de version supplémentaire :

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

Cela téléchargera automatiquement la version correcte de sentry-cli pour votre système d'exploitation et l'installera. Si nécessaire, il vous demandera votre mot de passe administrateur pour sudo . Pour un emplacement d'installation différent ou pour les systèmes sans sudo (comme Windows), vous pouvez export INSTALL_DIR=/custom/installation/path avant d'exécuter cette commande.

Si vous utilisez sentry-cli dans des environnements Windows, Microsoft Visual C++ Redistributable est requis.

Pour vérifier qu'il est correctement installé, vous pouvez afficher l'aide :

sentry-cli --help

pépin

Nouveau dans 2.14.3 : sentry-cli peut également être installé en utilisant pip :

 pip installer sentinelle-cli

Nœud

De plus, vous pouvez également installer ce binaire via npm :

npm install @sentry/cli

Lors de l'installation globale, assurez-vous d'avoir défini les autorisations correctes sur le répertoire global node_modules. Si cela n'est pas possible dans votre environnement ou génère toujours une erreur EACCESS, installez en tant que root :

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

Par défaut, ce package téléchargera sentry-cli depuis le CDN géré par Fastly. Pour utiliser un CDN personnalisé, définissez la propriété de configuration npm sentrycli_cdnurl . Le téléchargeur ajoutera "//sentry-cli-" .

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

Ou ajoutez une propriété dans votre fichier .npmrc (https://www.npmjs.org/doc/files/npmrc.html)

sentrycli_cdnurl=https://mymirror.local/path

Vous pouvez fournir quelques variables d'environnement pour contrôler l'installation de 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

Lorsque vous utilisez sentry-cli via l'API JavaScript ou tout plugin tiers qui consomme ladite API, vous pouvez également utiliser SENTRY_BINARY_PATH= aux côtés de SENTRYCLI_SKIP_DOWNLOAD=1 pour contrôler complètement quels binaires sont téléchargés et utilisés tout au long du processus.

Si vous installez la CLI avec NPM derrière un proxy, le script d'installation utilisera soit le serveur proxy HTTPS configuré par NPM, soit la valeur de votre variable d'environnement HTTPS_PROXY .

Homebrew

Une recette homebrew est fournie dans le robinet getsentry/tools :

brew install getsentry/tools/sentry-cli

Docker

Depuis la version 1.25.0 , il existe une image Docker officielle fournie avec sentry-cli préinstallé. Si vous préférez une version spécifique, spécifiez-la comme balise. La dernière version de développement est publiée sous la balise edge . En production, nous vous recommandons d’utiliser la latest balise. Pour l'utiliser, exécutez :

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

À partir de la version 2.8.0 , si vous voyez "error: config value 'safe.directory' was not found;" message, vous devez également définir correctement l'UID et le GID des volumes montés comme ceci :

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

Ceci est requis en raison d'un problème de sécurité dans les anciennes implémentations git . Voir ici pour plus de détails.

Mise à jour

Pour mettre à jour sentry-cli vers la dernière version, exécutez :

 mise à jour sentinelle-cli

Compilation

Si vous souhaitez le compiler vous-même, vous devez installer au minimum les dépendances suivantes :

• Résistant à la rouille et Cargo

• Make, CMake et un compilateur C

Utilisez cargo pour compiler :

$ cargo build

En outre, il existe un Dockerfile qui crée une image Docker basée sur Alpine avec sentry-cli dans le PATH. Pour le construire et l'utiliser, exécutez :

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