centinela cli

Interfaz de línea de comando oficial de Sentry

Este es un cliente de línea de comandos Sentry para algunas tareas genéricas. En este momento, esto se usa principalmente para cargar símbolos de depuración en Sentry si no está utilizando las herramientas Fastlane.

• Las descargas se pueden encontrar en Lanzamientos

• La documentación se puede encontrar aquí.

Instalación

Si está en OS X o Linux, puede utilizar el descargador automático que buscará la última versión y la instalará:

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

Sin embargo, le recomendamos que fije la versión específica de la CLI para que sus compilaciones sean siempre reproducibles. Para hacer eso, puedes usar exactamente el mismo método, con un especificador de versión adicional:

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

Esto descargará automáticamente la versión correcta de sentry-cli para su sistema operativo y la instalará. Si es necesario, le solicitará su contraseña de administrador para sudo . Para una ubicación de instalación diferente o para sistemas sin sudo (como Windows), puede export INSTALL_DIR=/custom/installation/path antes de ejecutar este comando.

Si está utilizando sentry-cli en entornos Windows, se requiere Microsoft Visual C++ Redistributable.

Para verificar que esté instalado correctamente, puede abrir la ayuda:

sentry-cli --help

pepita

Nuevo en 2.14.3 : sentry-cli también se puede instalar usando pip :

 instalación de pip sentry-cli

Nodo

Además, también puedes instalar este binario a través de npm:

npm install @sentry/cli

Al realizar la instalación global, asegúrese de haber configurado los permisos correctos en el directorio global node_modules. Si esto no es posible en su entorno o aún produce un error de EACCESS, instálelo como root:

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

De forma predeterminada, este paquete descargará sentry-cli desde la CDN administrada por Fastly. Para usar una CDN personalizada, configure la propiedad de configuración de npm sentrycli_cdnurl . El descargador agregará "//sentry-cli-" .

 instalación npm @sentry/cli --sentrycli_cdnurl=https://mymirror.local/path

O agregue una propiedad a su archivo .npmrc (https://www.npmjs.org/doc/files/npmrc.html)

sentrycli_cdnurl=https://mymirror.local/path

Hay algunas variables de entorno que puede proporcionar para controlar la instalación 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

Cuando utilice sentry-cli a través de la API de JavaScript o cualquier complemento de terceros que consuma dicha API, también puede usar SENTRY_BINARY_PATH= junto con SENTRYCLI_SKIP_DOWNLOAD=1 para controlar completamente qué archivos binarios se descargan y utilizan durante todo el proceso.

Si está instalando la CLI con NPM desde detrás de un proxy, el script de instalación utilizará el servidor proxy HTTPS configurado de NPM o el valor de su variable de entorno HTTPS_PROXY .

cerveza casera

Se proporciona una receta casera en el grifo getsentry/tools :

brew install getsentry/tools/sentry-cli

Estibador

A partir de la versión 1.25.0 , hay una imagen oficial de Docker que viene con sentry-cli preinstalado. Si prefiere una versión específica, especifíquela como etiqueta. La última versión de desarrollo se publica bajo la etiqueta edge . En producción, le recomendamos que utilice la etiqueta latest . Para usarlo, ejecute:

 docker pull getsentry/sentry-cli
ventana acoplable ejecutar --rm -v $(contraseña):/work getsentry/sentry-cli --help

A partir de la versión 2.8.0 , en caso de que vea "error: config value 'safe.directory' was not found;" mensaje, también debe configurar correctamente el UID y el GID de los volúmenes montados, así:

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

Esto es necesario debido a problemas de seguridad en implementaciones git anteriores. Consulte aquí para obtener más detalles.

Actualizar

Para actualizar sentry-cli a la última versión, ejecute:

 actualización centinela-cli

Compilando

En caso de que desee compilarlo usted mismo, deberá instalar como mínimo las siguientes dependencias:

• Estable al óxido y carga.

• Make, CMake y un compilador de C

Utilice carga para compilar:

$ cargo build

Además, hay un Dockerfile que crea una imagen de Docker basada en Alpine con sentry-cli en la RUTA. Para compilarlo y usarlo, ejecute:

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