با Checks CLI شروع کنید

Checks CLI عملکرد چک ها را در گردش کار توسعه شما به ارمغان می آورد. می توانید CLI را به صورت محلی، در خط لوله CI/CD خود یا از طریق انواع دیگر اسکریپت ها و اتوماسیون اجرا کنید.

راه اندازی و استفاده از Checks CLI به مراحل زیر نیاز دارد:

1. Checks CLI را نصب کنید
2. دستگاه خود را احراز هویت کنید
3. با اجرای دستورات از خط فرمان یا ادغام Checks CLI در محیط CI/CD خود، Checks CLI را ادغام کرده و از آن استفاده کنید.

چک های CLI را تنظیم کنید

می‌توانید Checks CLI را با استفاده از فایل‌های اجرایی مستقل در جداول برای Linux یا macOS نصب یا به‌روزرسانی کنید.

پس از نصب Checks CLI، باید احراز هویت کنید. سپس می‌توانید آزمایش و رفع آسیب‌پذیری‌های خود را شروع کنید و با آزمایش نصب خود شروع کنید.

توجه: چک ها توصیه می کنند همیشه نصب CLI خود را به آخرین نسخه به روز نگه دارید. با اجرای checks --version می توانید بررسی کنید که کدام نسخه از Checks CLI را نصب کرده اید.

با فایل های اجرایی مستقل نصب کنید

Checks پیوندهای دانلود اجرایی مستقلی را برای آخرین نسخه و نسخه های خاص ارائه می دهد. برای مثال پیوندهای زیر برای macOS و Linux هستند:

• https://dl.google.com/checks/cli/latest/checks-macos
• https://dl.google.com/checks/cli/v0.2.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 را برای پلتفرم خود دانلود کنید:

لینوکس

پلت فرم	بسته	اندازه	SHA256 Checksum
لینوکس	چک لینوکس	35.1 مگابایت	cc12317c0d5b0a2edfe8d5bf28a3a0739d5bd469ccd771772bf65129ae97c94f

با اجرای chmod +x ./checks باینری را قابل اجرا کنید. ( اختیاری ) باینری را به مکانی منتقل کنید که بتوانید آن را به صورت سراسری اجرا کنید: mv ./checks /usr/local/bin/

macOS

پلت فرم	بسته	اندازه	SHA256 Checksum
macOS	چک-ماکو	29.4 مگابایت	a82699336aaf0f6b0a9502c293c84be45459d79d348a74eae3bbaaf89d1daa33

با اجرای chmod +x ./checks mv ./checks /usr/local/bin/ اختیاری ) باینری را قابل اجرا کنید.

ویندوز

پلت فرم	بسته	اندازه	SHA256 Checksum
ویندوز 8.1 و بالاتر و ویندوز سرور 2012 به بعد	checks-win.exe	29.5 مگابایت	7ca465e28ffec9a7e16bc71e01bbaf9629c95d517e5846a31280a49af400d3c7

( اختیاری ) نام فایل را به checks.exe تغییر دهید تا بتوانید دستورات چک را به صورت مستند اجرا کنید، به عنوان مثال، checks help .

به آخرین نسخه CLI به روز کنید

برای اطمینان از دریافت جدیدترین ویژگی‌ها و رفع اشکال، توصیه می‌کنیم مرتباً به‌روزرسانی‌های CLI را بررسی کنید.

می توانید نسخه جدید را از جداول قبلی دانلود کرده و سپس نسخه قبلی را در سیستم خود جایگزین کنید.

نصب خود را تست کنید

پس از احراز هویت، می توانید نصب خود را تست کنید. برای یک آزمایش سریع، checks --help اجرا کنید.

اطلاعات تکمیلی

checks --help یا خلاصه دستورات و گزینه های CLI را ببینید.

دریافت پشتیبانی

هر زمان که در مورد چک‌های CLI یا به‌طور کلی چک‌ها به کمک نیاز داشتید، ایمیلی به [e-mail] ارسال کنید.

CLI را احراز هویت کنید

پس از نصب CLI، باید به یک حساب Google وارد شوید. برای اجازه دسترسی چک‌های CLI به چک‌ها، از یک حساب سرویس یا حساب کاربری استفاده کنید.

حساب سرویس یک حساب Google Cloud مرتبط با پروژه Google Cloud شما است و نه یک کاربر خاص. حساب‌های سرویس برای تنظیم چک‌ها در یک محیط CI مفید هستند.

حساب کاربری یک حساب Google است که به حساب چک های شما دسترسی دارد. این بهترین گزینه برای استفاده از Checks CLI از خط فرمان شما است.

با یک حساب سرویس احراز هویت

1. کنسول Google Cloud را باز کنید و پروژه خود را انتخاب کنید.
2. در کتابخانه API، Checks API را فعال کنید.
3. با رفتن به صفحه حساب‌های خدمات IAM در Google Cloud Console، یک حساب سرویس برای پروژه خود ایجاد کنید. روی ایجاد حساب سرویس کلیک کنید و جزئیات حساب سرویس را وارد کنید.
   1. یک کلید JSON خصوصی برای حساب سرویس تازه ایجاد شده خود ایجاد کنید و کلید را به مکان قابل دسترسی برای محیط ساخت خود منتقل کنید. مطمئن شوید که این فایل را در جایی امن نگه دارید ، زیرا به سرپرست اجازه دسترسی به چک ها را می دهد.
   2. هنگام استفاده از CLI، متغیر محیطی CHECKS_CREDENTIALS روی مسیر فایل JSON کلید خصوصی خود تنظیم کنید. اگر از افزونه Checks CI/CD استفاده می کنید، برای نحوه ارائه اعتبارنامه به مستندات افزونه مراجعه کنید.
4. برای اعطای دسترسی به حساب سرویس به حساب چک خود، آدرس ایمیل را اضافه کنید و در صفحه تنظیمات کنسول چک به آن نقش مالک بدهید. برای اطلاعات بیشتر در مورد دعوت از کاربران به حساب چک خود، به مدیریت دسترسی تیم مراجعه کنید.

احراز هویت با حساب کاربری

مهم: اگر از طریق SSH وصل می‌شوید، پورت 9005 را فوروارد کنید.

1. با استفاده از حساب Google خود با دستور زیر وارد Checks CLI شوید: checks login

   این دستور دستگاه محلی شما را به چک ها متصل می کند و به شما امکان دسترسی به حساب های چک های خود را می دهد.

   • اگر قبلاً وارد سیستم شده‌اید، اما می‌خواهید به حساب Google دیگری بروید، از checks login --reauth استفاده کنید.
   • برای خروج از checks logout استفاده کنید.

2. URL احراز هویت ایجاد شده را در مرورگر باز کنید.

3. به حساب Google خود وارد شوید.

4. برای دسترسی به حساب چک های شما به چک ها رضایت دهید.