penjaga cli

Antarmuka Baris Perintah Penjaga Resmi

Ini adalah klien baris perintah Sentry untuk beberapa tugas umum. Saat ini ini terutama digunakan untuk mengunggah simbol debug ke Sentry jika Anda tidak menggunakan alat Fastlane.

• Unduhan dapat ditemukan di bawah Rilis

• Dokumentasi dapat ditemukan di sini

Instalasi

Jika Anda menggunakan OS X atau Linux, Anda dapat menggunakan pengunduh otomatis yang akan mengambil versi rilis terbaru untuk Anda dan menginstalnya:

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

Namun, kami menganjurkan Anda untuk memasang pin pada versi CLI tertentu, sehingga build Anda selalu dapat direproduksi. Untuk melakukannya, Anda dapat menggunakan metode yang sama persis, dengan penentu versi tambahan:

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

Ini secara otomatis akan mengunduh versi sentry-cli yang benar untuk sistem operasi Anda dan menginstalnya. Jika perlu, ia akan meminta kata sandi admin Anda untuk sudo . Untuk lokasi instalasi yang berbeda atau untuk sistem tanpa sudo (seperti Windows), Anda dapat export INSTALL_DIR=/custom/installation/path sebelum menjalankan perintah ini.

Jika Anda menggunakan sentry-cli di lingkungan Windows, Microsoft Visual C++ Redistributable diperlukan.

Untuk memverifikasi bahwa itu sudah terpasang dengan benar, Anda dapat memunculkan bantuan:

sentry-cli --help

pip

Baru di 2.14.3 : sentry-cli juga dapat diinstal menggunakan pip :

 pip instal penjaga-cli

simpul

Selain itu, Anda juga dapat menginstal biner ini melalui npm:

npm install @sentry/cli

Saat menginstal secara global, pastikan telah menetapkan izin yang benar pada direktori node_modules global. Jika hal ini tidak memungkinkan di lingkungan Anda atau masih menghasilkan kesalahan EACCESS, instal sebagai root:

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

Secara default, paket ini akan mengunduh sentry-cli dari CDN yang dikelola oleh Fastly. Untuk menggunakan CDN khusus, setel properti konfigurasi npm sentrycli_cdnurl . Pengunduh akan menambahkan "//sentry-cli-" .

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

Atau tambahkan properti ke file .npmrc Anda (https://www.npmjs.org/doc/files/npmrc.html)

sentrycli_cdnurl=https://mymirror.local/path

Ada beberapa variabel lingkungan yang dapat Anda berikan untuk mengontrol instalasi 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

Saat menggunakan sentry-cli melalui JavaScript API atau plugin pihak ketiga mana pun yang menggunakan API tersebut, Anda juga dapat menggunakan SENTRY_BINARY_PATH= bersama SENTRYCLI_SKIP_DOWNLOAD=1 untuk sepenuhnya mengontrol biner apa yang diunduh dan digunakan di seluruh proses.

Jika Anda memasang CLI dengan NPM dari belakang proksi, skrip pemasangan akan menggunakan server proksi HTTPS NPM yang dikonfigurasi atau nilai dari variabel lingkungan HTTPS_PROXY Anda.

minuman rumahan

Resep minuman rumahan disediakan di keran getsentry/tools :

brew install getsentry/tools/sentry-cli

Buruh pelabuhan

Pada versi 1.25.0 , ada image Docker resmi yang disertakan dengan sentry-cli yang sudah diinstal sebelumnya. Jika Anda lebih memilih versi tertentu, tentukan sebagai tag. Versi pengembangan terbaru diterbitkan di bawah tag edge . Dalam produksi, kami menyarankan Anda untuk menggunakan tag latest . Untuk menggunakannya, jalankan:

 docker pull getentry/penjaga-cli
menjalankan buruh pelabuhan --rm -v $(pwd):/work getentry/sentry-cli --help

Mulai versi 2.8.0 , jika Anda melihat "error: config value 'safe.directory' was not found;" pesan, Anda juga perlu mengatur UID dan GID volume terpasang dengan benar seperti:

 menjalankan buruh pelabuhan --rm -u "$(id -u):$(id -g)" -v $(pwd):/work getentry/sentry-cli --help

Ini diperlukan karena masalah keamanan pada implementasi git lama. Lihat di sini untuk lebih jelasnya.

Memperbarui

Untuk memperbarui sentry-cli ke versi terbaru, jalankan:

 pembaruan penjaga-cli

Kompilasi

Jika Anda ingin mengkompilasinya sendiri, Anda perlu menginstal minimal dependensi berikut:

• Stabil karat dan Kargo

• Make, CMake dan kompiler C

Gunakan kargo untuk mengkompilasi:

$ cargo build

Selain itu, ada Dockerfile yang membuat image Docker berbasis Alpine dengan sentry-cli di PATH. Untuk membangun dan menggunakannya, jalankan:

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