حارس كلي

واجهة سطر أوامر الحراسة الرسمية

هذا هو عميل سطر أوامر 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++ Redistributable مطلوب.

للتحقق من تثبيته بشكل صحيح يمكنك إظهار المساعدة:

sentry-cli --help

نقطة

الجديد في 2.14.3 : يمكن أيضًا تثبيت sentry-cli باستخدام pip :

 نقطة تثبيت الحراسة-cli

العقدة

بالإضافة إلى ذلك، يمكنك أيضًا تثبيت هذا الثنائي عبر npm:

npm install @sentry/cli

عند التثبيت على مستوى العالم، تأكد من تعيين الأذونات الصحيحة على دليل Node_modules العام. إذا لم يكن ذلك ممكنًا في بيئتك أو استمر ظهور خطأ EACCESS، فقم بالتثبيت كجذر:

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

افتراضيًا، ستقوم هذه الحزمة بتنزيل Sentry-cli من CDN المُدار بواسطة Fastly. لاستخدام CDN مخصص، قم بتعيين خاصية التكوين npm sentrycli_cdnurl . سيقوم برنامج التنزيل بإلحاق "//sentry-cli-" .

 تثبيت npm @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 أو أي مكون إضافي تابع لجهة خارجية يستهلك واجهة برمجة التطبيقات المذكورة، يمكنك أيضًا استخدام SENTRY_BINARY_PATH= جنبًا إلى جنب مع SENTRYCLI_SKIP_DOWNLOAD=1 للتحكم بشكل كامل في الثنائيات التي يتم تنزيلها واستخدامها طوال العملية بأكملها.

إذا كنت تقوم بتثبيت واجهة سطر الأوامر (CLI) باستخدام NPM من خلف وكيل، فسيستخدم البرنامج النصي للتثبيت إما خادم وكيل HTTPS الذي تم تكوينه في NPM أو القيمة من متغير البيئة HTTPS_PROXY .

البيرة المنزلية

يتم توفير وصفة البيرة المنزلية في صنبور getsentry/tools :

brew install getsentry/tools/sentry-cli

عامل ميناء

اعتبارًا من الإصدار 1.25.0 ، هناك صورة Docker رسمية تأتي مع sentry-cli مثبتة مسبقًا. إذا كنت تفضل إصدارًا محددًا، فحدده كعلامة. يتم نشر أحدث إصدار تطويري تحت علامة edge . في مرحلة الإنتاج، ننصحك باستخدام latest علامة. لاستخدامه، قم بتشغيل:

 عامل ميناء سحب getsentry/sentry-cli
تشغيل عامل الميناء --rm -v $(pwd):/work getsentry/sentry-cli --help

بدءاً من الإصدار 2.8.0 ، في حالة ظهور "error: config value 'safe.directory' was not found;" رسالة، تحتاج أيضًا إلى ضبط UID وGID للوحدات المحملة بشكل صحيح كما يلي:

 تشغيل عامل الميناء --rm -u "$(id -u):$(id -g)" -v $(pwd):/work getsentry/sentry-cli --help

هذا مطلوب بسبب مشكلة أمنية في تطبيقات git الأقدم. انظر هنا لمزيد من التفاصيل.

تحديث

لتحديث Sentry-cli إلى الإصدار الأحدث، قم بتشغيل:

 تحديث الحارس-cli

تجميع

في حالة رغبتك في تجميع هذا بنفسك، فأنت بحاجة إلى تثبيت التبعيات التالية على الأقل:

• الصدأ مستقر والبضائع

• Make وCMake ومترجم لغة C

استخدم البضائع لتجميع:

$ cargo build

يوجد أيضًا ملف Dockerfile الذي يبني صورة Docker المستندة إلى جبال الألب باستخدام sentry-cli في PATH. لبنائه واستخدامه، قم بتشغيل:

 بناء عامل الميناء -t Sentry-cli .docker run --rm -v $(pwd):/work Sentry-cli --help