بدء استخدام Checks CLI

يضيف واجهة سطر الأوامر "Checks CLI" وظائف عمليات Checks إلى سير عمل التطوير. يمكنك تشغيل واجهة سطر الأوامر محليًا، أو في مسار CI/CD، أو من خلال أنواع أخرى من النصوص البرمجية والتشغيل الآلي.

يتطلب إعداد واجهة Checks CLI واستخدامها الخطوات التالية:

1. تثبيت واجهة سطر الأوامر "Checks CLI"
2. مصادقة جهازك
3. يمكنك دمج واجهة Checks CLI واستخدامها من خلال تنفيذ الأوامر من سطر الأوامر أو دمج Checks CLI في بيئة CI/CD.

إعداد Checks CLI

يمكنك تثبيت واجهة سطر الأوامر "Checks CLI" أو تحديثها باستخدام الملفات التنفيذية المستقلة في الجداول التي تعمل بنظام التشغيل Linux أو نظام التشغيل macOS.

بعد تثبيت Checks CLI، عليك المصادقة. بعد ذلك يمكنك البدء في اختبار الثغرات وإصلاحها، مع البدء باختبار عملية التثبيت.

ملاحظة: تقترح ميزة "عمليات التحقّق" دائمًا تحديث تثبيت واجهة سطر الأوامر (CLI) إلى آخر إصدار. يمكنك التحقّق من إصدار Checks CLI الذي ثبَّته من خلال تشغيل checks --version.

التثبيت باستخدام ملفات تنفيذية مستقلة

توفر Checks روابط تنزيل مستقلة قابلة للتنفيذ لأحدث إصدار وإصدارات محددة. الروابط التالية، على سبيل المثال، مخصصة لنظامي التشغيل macOS وLinux:

• https://dl.google.com/checks/cli/latest/checks-macos
• https://dl.google.com/checks/cli/v0.1.0/checks-linux

على سبيل المثال، لتنزيل أحدث إصدار من Checks CLI وتشغيله على macOS، شغِّل:

curl --compressed https://dl.google.com/checks/cli/latest/checks-macos -o checks
chmod +x ./checks
mv ./checks /usr/local/bin/

1. تأكد من تثبيت مدير الحزم وأي أدوات مطلوبة من جهات خارجية.
2. نزِّل برنامج Checks CLI الثنائي ومنصتك:

Linux

النظام الأساسي	الحزمة	حجم الملف	المجموع الاختباري لخوارزمية SHA256
Linux	checks-linux	23.6 ميغابايت	81f75ffb52ca1a1184badadfc5ef35f55888e75652e8dab6cd02d237ecd36c1c

اجعل البرنامج الثنائي قابلاً للتنفيذ من خلال تشغيل chmod +x ./checks. (اختياري) انقل البرنامج الثنائي إلى موقع يمكنك تنفيذه بشكل عام: mv ./checks /usr/local/bin/

macOS

النظام الأساسي	الحزمة	حجم الملف	المجموع الاختباري لخوارزمية SHA256
macOS	checks-macos	18.9 ميغابايت	10b8b16799c172b38a95fba8236b82d55e82c955a0627fc747354c7587ccda96

اجعل البرنامج الثنائي قابلاً للتنفيذ من خلال تشغيل chmod +x ./checks (اختياري) انقل البرنامج الثنائي إلى موقع يمكنك تنفيذه بشكل عام: mv ./checks /usr/local/bin/

أجهزة Windows

النظام الأساسي	الحزمة	حجم الملف	المجموع الاختباري لخوارزمية SHA256
Windows 8.1 والإصدارات الأحدث وWindows Server 2012 والإصدارات الأحدث	checks-win.exe	18.8 ميغابايت	eb201c9f82aa1dc0ed597d76bfc7480ecedea249ef1fbcca7a5b73bcdcbfdad9

(اختياري) أعِد تسمية الملف إلى checks.exe كي تتمكّن من تنفيذ أوامر التحقق كما هي موثَّقة، على سبيل المثال، checks help.

تثبيت أحدث إصدار من واجهة سطر الأوامر

للتأكّد من حصولك على أحدث الميزات وإصلاحات الأخطاء، ننصحك بالتحقق بانتظام من تحديثات واجهة سطر الأوامر.

يمكنك تنزيل الإصدار الجديد من الجداول السابقة، ثم استبدال الإصدار السابق على نظامك.

اختبار التثبيت

بعد المصادقة، يمكنك اختبار التثبيت. لإجراء اختبار سريع، شغِّل "checks --help".

معلومات إضافية

شغِّل checks --help أو اطّلِع على ملخص خيارات وأوامر واجهة سطر الأوامر.

الحصول على الدعم

يمكنك إرسال رسالة إلكترونية إلى [e-mail] متى احتجت إلى مساعدة بشأن Checks CLI أو Checks بشكل عام.

مصادقة واجهة سطر الأوامر

بعد تثبيت واجهة سطر الأوامر، يجب تسجيل الدخول إلى حساب Google. لاعتماد وصول CLI إلى Checks CLI إلى Checks، استخدم حساب خدمة أو حساب مستخدم.

حساب الخدمة هو حساب Google Cloud مرتبط بمشروعك على Google Cloud، وليس مستخدمًا محددًا. تُعد حسابات الخدمة مفيدة لإعداد عمليات التحقق في بيئة CI.

حساب المستخدم هو حساب Google لديه إمكانية الوصول إلى حسابك على Checks. وهذا هو أفضل خيار لاستخدام واجهة سطر الأوامر "Checks CLI" من سطر الأوامر.

المصادقة باستخدام حساب خدمة

1. افتح وحدة التحكّم في Google Cloud واختَر مشروعك.
2. في مكتبة واجهة برمجة التطبيقات، فعِّل Checks API.
3. أنشئ حساب خدمة لمشروعك من خلال الانتقال إلى صفحة حسابات خدمة إدارة الهوية وإمكانية الوصول في Google Cloud Console. انقر على إنشاء حساب خدمة وأدخِل تفاصيل حساب الخدمة.
   1. أنشِئ مفتاح JSON خاصًا لحساب الخدمة الذي أنشأته حديثًا وانقل المفتاح إلى موقع يمكن الوصول إليه من خلال بيئة الإصدار. احرِص على إبقاء هذا الملف في مكان آمن، لأنه يمنح المشرف إمكانية الوصول إلى Checks.
   2. اضبط متغير البيئة CHECKS_CREDENTIALS على مسار ملف JSON للمفتاح الخاص.

المصادقة باستخدام حساب مستخدم

ملاحظة مهمّة: في حال الاتصال من خلال بروتوكول النقل الآمن (SSH)، عليك إعادة توجيه المنفذ 9005.

1. سجِّل الدخول إلى Firebase باستخدام حسابك على Google باستخدام الأمر التالي: checks login

   يربط هذا الأمر جهازك المحلي بميزة Checks ويمنحك إمكانية الوصول إلى حساباتك على Checks.

   • يمكنك استخدام checks login --reauth إذا سبق أن سجّلت الدخول، ولكنك تريد التبديل إلى حساب Google مختلف.
   • استخدِم checks logout لتسجيل الخروج.

2. افتح في المتصفّح عنوان URL الذي تم إنشاؤه للمصادقة.

3. سجِّل الدخول إلى حسابك على Google.

4. امنح Checks الإذن بالوصول إلى حسابك على Checks.