sentinela cli

Interface oficial de linha de comando do Sentry

Este é um cliente de linha de comando Sentry para algumas tarefas genéricas. No momento, isso é usado principalmente para fazer upload de símbolos de depuração para o Sentry se você não estiver usando as ferramentas Fastlane.

• Os downloads podem ser encontrados em Lançamentos

• A documentação pode ser encontrada aqui

Instalação

Se você estiver no OS X ou Linux, poderá usar o downloader automatizado que irá buscar a versão mais recente para você e instalá-la:

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

No entanto, encorajamos você a fixar a versão específica da CLI, para que suas compilações sejam sempre reproduzíveis. Para fazer isso, você pode usar exatamente o mesmo método, com um especificador de versão adicional:

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

Isso baixará automaticamente a versão correta do sentry-cli para o seu sistema operacional e a instalará. Se necessário, ele solicitará sua senha de administrador para sudo . Para um local de instalação diferente ou para sistemas sem sudo (como Windows), você pode export INSTALL_DIR=/custom/installation/path antes de executar este comando.

Se você estiver usando sentry-cli em ambientes Windows, o Microsoft Visual C++ Redistributable será necessário.

Para verificar se está instalado corretamente, você pode acessar a ajuda:

sentry-cli --help

pip

Novo no 2.14.3 : sentry-cli também pode ser instalado usando pip :

 pip instalar sentinela-cli

Nó

Além disso, você também pode instalar este binário via npm:

npm install @sentry/cli

Ao instalar globalmente, certifique-se de ter definido as permissões corretas no diretório node_modules global. Se isso não for possível em seu ambiente ou ainda produzir um erro EACCESS, instale como root:

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

Por padrão, este pacote irá baixar o sentry-cli do CDN gerenciado pelo Fastly. Para usar um CDN personalizado, defina a propriedade de configuração npm sentrycli_cdnurl . O downloader anexará "//sentry-cli-" .

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

Ou adicione propriedade ao seu arquivo .npmrc (https://www.npmjs.org/doc/files/npmrc.html)

sentrycli_cdnurl=https://mymirror.local/path

Existem algumas variáveis ​​de ambiente que você pode fornecer para controlar a instalação do 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

Ao usar sentry-cli via API JavaScript ou qualquer plug-in de terceiros que esteja consumindo essa API, você também pode usar SENTRY_BINARY_PATH= junto com SENTRYCLI_SKIP_DOWNLOAD=1 para controlar completamente quais binários são baixados e usados ​​durante todo o processo.

Se você estiver instalando a CLI com o NPM por trás de um proxy, o script de instalação usará o servidor proxy HTTPS configurado do NPM ou o valor da sua variável de ambiente HTTPS_PROXY .

Cerveja caseira

Uma receita de homebrew é fornecida na torneira getsentry/tools :

brew install getsentry/tools/sentry-cli

Docker

A partir da versão 1.25.0 , existe uma imagem oficial do Docker que vem com sentry-cli pré-instalado. Se preferir uma versão específica, especifique-a como tag. A versão de desenvolvimento mais recente é publicada sob a tag edge . Na produção, recomendamos que você use a tag latest . Para usá-lo, execute:

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

A partir da versão 2.8.0 , caso você veja "error: config value 'safe.directory' was not found;" mensagem, você também precisa definir corretamente o UID e o GID dos volumes montados da seguinte forma:

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

Isso é necessário devido a problemas de segurança em implementações git mais antigas. Veja aqui para mais detalhes.

Atualizar

Para atualizar o sentry-cli para a versão mais recente, execute:

 atualização sentry-cli

Compilando

Caso você queira compilar você mesmo, você precisa instalar no mínimo as seguintes dependências:

• Estável contra ferrugem e carga

• Make, CMake e um compilador C

Use cargo para compilar:

$ cargo build

Além disso, há um Dockerfile que cria uma imagem Docker baseada em Alpine com sentry-cli no PATH. Para construí-lo e usá-lo, execute:

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