сторожевой клик

Официальный интерфейс командной строки Sentry

Это клиент командной строки Sentry для некоторых общих задач. Сейчас это в основном используется для загрузки символов отладки в Sentry, если вы не используете инструменты Fastlane.

• Загрузки можно найти в разделе «Релизы».

• Документацию можно найти здесь

Установка

Если вы используете 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 перед запуском этой команды.

Если вы используете sentry-cli в среде Windows, требуется распространяемый пакет Microsoft Visual C++.

Чтобы убедиться, что он установлен правильно, вы можете вызвать справку:

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

По умолчанию этот пакет загрузит sendry-cli из CDN, управляемой Fastly. Чтобы использовать собственный 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

При использовании sentry-cli через JavaScript API или любой сторонний плагин, использующий указанный API, вы также можете использовать SENTRY_BINARY_PATH= вместе с SENTRYCLI_SKIP_DOWNLOAD=1 , чтобы полностью контролировать, какие двоичные файлы загружаются и используются на протяжении всего процесса.

Если вы устанавливаете CLI с помощью NPM из-за прокси-сервера, сценарий установки будет использовать либо настроенный NPM прокси-сервер HTTPS, либо значение из вашей переменной среды HTTPS_PROXY .

Домашнее пиво

Рецепт домашнего пивоварения доступен в разделе getsentry/tools :

brew install getsentry/tools/sentry-cli

Докер

Начиная с версии 1.25.0 существует официальный образ Docker с предустановленным sentry-cli . Если вы предпочитаете конкретную версию, укажите ее в качестве тега. Последняя разрабатываемая версия публикуется под тегом edge . В производстве мы рекомендуем использовать latest тег. Чтобы использовать его, запустите:

 docker pull getentry/sentry-cli
docker run --rm -v $(pwd):/work getentry/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 getentry/sentry-cli --help

Это необходимо из-за проблем с безопасностью в старых реализациях git . Подробнее см. здесь.

Обновлять

Чтобы обновить sendry-cli до последней версии, выполните:

 обновление Sentry-Cli

Компиляция

Если вы хотите скомпилировать это самостоятельно, вам необходимо установить как минимум следующие зависимости:

• Ржавая конюшня и грузовой

• Make, CMake и компилятор C

Используйте груз для составления:

$ cargo build

Кроме того, существует файл Dockerfile, который создает образ Docker на базе Alpine с помощью sentry-cli в PATH. Чтобы создать и использовать его, запустите:

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