চেকস সিএলআই আপনার ডেভেলপমেন্ট ওয়ার্কফ্লোতে চেকস-এর কার্যকারিতা নিয়ে আসে। আপনি সিএলআই-টি স্থানীয়ভাবে, আপনার সিআই/সিডি পাইপলাইনে, অথবা অন্যান্য ধরনের স্ক্রিপ্ট ও অটোমেশনের মাধ্যমে চালাতে পারেন।
চেকস সিএলআই (Checks CLI) সেট আপ এবং ব্যবহার করার জন্য নিম্নলিখিত ধাপগুলি অনুসরণ করতে হবে:
- চেকস সিএলআই ইনস্টল করুন
- আপনার মেশিনটি প্রমাণীকরণ করুন
- কমান্ড লাইন থেকে কমান্ড চালিয়ে অথবা আপনার CI/CD পরিবেশে Checks CLI সংহত করে এটি ব্যবহার করুন।
চেক্স সিএলআই সেট আপ করুন
আপনি লিনাক্স বা ম্যাকওএস-এর জন্য টেবিলগুলিতে থাকা স্বতন্ত্র এক্সিকিউটেবলগুলি ব্যবহার করে চেক্স সিএলআই ইনস্টল বা আপডেট করতে পারেন।
চেকস সিএলআই ইনস্টল করার পর, আপনাকে অবশ্যই প্রমাণীকরণ করতে হবে। তারপর আপনি আপনার ইনস্টলেশন পরীক্ষা করার মাধ্যমে দুর্বলতাগুলো পরীক্ষা ও সমাধান করা শুরু করতে পারেন।
স্বতন্ত্র এক্সিকিউটেবল দিয়ে ইনস্টল করুন
চেকস সর্বশেষ রিলিজ এবং নির্দিষ্ট সংস্করণগুলির জন্য স্বতন্ত্র এক্সিকিউটেবল ডাউনলোড লিঙ্ক প্রদান করে। উদাহরণস্বরূপ, নিম্নলিখিত লিঙ্কগুলি ম্যাকওএস এবং লিনাক্সের জন্য:
- https://dl.google.com/checks/cli/latest/checks-macos
- https://dl.google.com/checks/cli/v0.2.0/checks-linux
উদাহরণস্বরূপ, macOS-এ সর্বশেষ Checks CLI ডাউনলোড ও রান করতে, নিম্নলিখিত কমান্ডটি চালান:
curl --compressed https://dl.google.com/checks/cli/latest/checks-macos -o checks
chmod +x ./checks
mv ./checks /usr/local/bin/- আপনার প্যাকেজ ম্যানেজার এবং প্রয়োজনীয় থার্ড-পার্টি টুলগুলো ইনস্টল করা হয়েছে কিনা, তা নিশ্চিত করুন।
- আপনার প্ল্যাটফর্মের জন্য Checks CLI বাইনারিটি ডাউনলোড করুন:
লিনাক্স
প্ল্যাটফর্ম | প্যাকেজ | আকার | SHA256 চেকসাম |
লিনাক্স | ৩৫.১ এমবি | cc12317c0d5b0a2edfe8d5bf28a3a0739d5bd469ccd771772bf65129ae97c94f |
chmod +x ./checks .` কমান্ডটি চালিয়ে বাইনারিটিকে এক্সিকিউটেবল করুন। ( ঐচ্ছিক ) বাইনারিটিকে এমন একটি স্থানে সরান যেখানে আপনি এটিকে গ্লোবালি এক্সিকিউট করতে পারবেন: mv ./checks /usr/local/bin/
ম্যাকওএস
প্ল্যাটফর্ম | প্যাকেজ | আকার | SHA256 চেকসাম |
ম্যাকওএস | ২৯.৪ এমবি | a82699336aaf0f6b0a9502c293c84be45459d79d348a74eae3bbaaf89d1daa33 |
chmod +x ./checks কমান্ডটি চালিয়ে বাইনারিটিকে এক্সিকিউটেবল করুন ( ঐচ্ছিক )। বাইনারিটিকে এমন একটি স্থানে সরান যেখানে আপনি এটিকে গ্লোবালি এক্সিকিউট করতে পারবেন: mv ./checks /usr/local/bin/
উইন্ডোজ
প্ল্যাটফর্ম | প্যাকেজ | আকার | SHA256 চেকসাম |
উইন্ডোজ ৮.১ ও তার পরবর্তী সংস্করণ এবং উইন্ডোজ সার্ভার ২০১২ ও তার পরবর্তী সংস্করণ | ২৯.৫ এমবি | 7ca465e28ffec9a7e16bc71e01bbaf9629c95d517e5846a31280a49af400d3c7 |
( ঐচ্ছিক ) ফাইলটির নাম পরিবর্তন করে checks.exe রাখুন, যাতে আপনি নির্দেশিকা অনুযায়ী checks কমান্ডগুলো চালাতে পারেন, যেমন— checks help ।
সর্বশেষ CLI সংস্করণে আপডেট করুন
সর্বাধুনিক ফিচার ও বাগ ফিক্সগুলো পাওয়া নিশ্চিত করতে, আমরা আপনাকে CLI-এর আপডেটগুলো নিয়মিত পরীক্ষা করার পরামর্শ দিই।
আপনি পূর্ববর্তী সারণিগুলো থেকে নতুন সংস্করণটি ডাউনলোড করে আপনার সিস্টেমে থাকা পূর্ববর্তী সংস্করণটি প্রতিস্থাপন করতে পারেন।
আপনার ইনস্টলেশন পরীক্ষা করুন
প্রমাণীকরণের পর, আপনি আপনার ইনস্টলেশন পরীক্ষা করতে পারেন। দ্রুত পরীক্ষার জন্য, checks --help চালান।
অতিরিক্ত তথ্য
checks --help চালিয়ে দেখুন অথবা CLI কমান্ড এবং অপশনগুলোর সারাংশ দেখুন।
সমর্থন পাওয়া
যখনই আপনার Checks CLI বা সাধারণভাবে Checks নিয়ে সাহায্যের প্রয়োজন হবে, checks-support@google.com-এ একটি ইমেল পাঠান।
CLI প্রমাণীকরণ করুন
CLI ইনস্টল করার পরে, আপনাকে অবশ্যই একটি Google অ্যাকাউন্টে সাইন ইন করতে হবে। Checks-এ Checks CLI-এর অ্যাক্সেস অনুমোদন করতে, একটি সার্ভিস অ্যাকাউন্ট বা ইউজার অ্যাকাউন্ট ব্যবহার করুন।
সার্ভিস অ্যাকাউন্ট হলো আপনার গুগল ক্লাউড প্রজেক্টের সাথে যুক্ত একটি গুগল ক্লাউড অ্যাকাউন্ট, এটি কোনো নির্দিষ্ট ব্যবহারকারী নয়। CI পরিবেশে চেক সেট আপ করার জন্য সার্ভিস অ্যাকাউন্টগুলো উপযোগী।
ইউজার অ্যাকাউন্ট হলো এমন একটি গুগল অ্যাকাউন্ট যার আপনার চেক্স অ্যাকাউন্টে অ্যাক্সেস আছে। আপনার কমান্ড লাইন থেকে চেক্স সিএলআই (Checks CLI) ব্যবহার করার জন্য এটিই সেরা বিকল্প।
একটি পরিষেবা অ্যাকাউন্ট দিয়ে প্রমাণীকরণ করুন
- গুগল ক্লাউড কনসোল খুলুন এবং আপনার প্রজেক্টটি নির্বাচন করুন।
- এপিআই লাইব্রেরিতে চেক্স এপিআই সক্রিয় করুন।
- Google Cloud Console-এর IAM Service Accounts পৃষ্ঠায় গিয়ে আপনার প্রোজেক্টের জন্য একটি সার্ভিস অ্যাকাউন্ট তৈরি করুন। Create Service Account-এ ক্লিক করুন এবং সার্ভিস অ্যাকাউন্টের বিবরণ লিখুন।
- আপনার নতুন তৈরি করা সার্ভিস অ্যাকাউন্টের জন্য একটি প্রাইভেট JSON কী তৈরি করুন এবং কী-টি আপনার বিল্ড এনভায়রনমেন্টের নাগালের মধ্যে থাকা কোনো স্থানে সরিয়ে নিন। এই ফাইলটি অবশ্যই কোনো নিরাপদ জায়গায় রাখবেন , কারণ এটি চেক্স (Checks)-এ অ্যাডমিনিস্ট্রেটর অ্যাক্সেস প্রদান করে।
- CLI ব্যবহার করার সময়,
CHECKS_CREDENTIALSএনভায়রনমেন্ট ভেরিয়েবলটি আপনার প্রাইভেট কী JSON ফাইলের পাথে সেট করুন। যদি কোনো চেক্স CI/CD প্লাগইন ব্যবহার করেন, তাহলে ক্রেডেনশিয়াল কীভাবে প্রদান করতে হবে তা জানতে প্লাগইনটির ডকুমেন্টেশন দেখুন।
- আপনার চেক্স অ্যাকাউন্টে সার্ভিস অ্যাকাউন্টকে অ্যাক্সেস দেওয়ার জন্য, চেক্স কনসোল সেটিংস পৃষ্ঠায় ইমেল ঠিকানাটি যোগ করুন এবং এটিকে ওনার ( Owner) ভূমিকা দিন। আপনার চেক্স অ্যাকাউন্টে ব্যবহারকারীদের আমন্ত্রণ জানানোর বিষয়ে আরও তথ্যের জন্য, টিম অ্যাক্সেস পরিচালনা (Managing team access) দেখুন।
ব্যবহারকারী অ্যাকাউন্ট দিয়ে প্রমাণীকরণ করুন
গুরুত্বপূর্ণ: আপনি যদি SSH-এর মাধ্যমে সংযোগ করেন, তাহলে পোর্ট 9005 ফরওয়ার্ড করুন।
নিম্নলিখিত কমান্ডটি ব্যবহার করে আপনার Google অ্যাকাউন্ট দিয়ে Checks CLI-তে সাইন ইন করুন:
checks loginএই কমান্ডটি আপনার স্থানীয় মেশিনকে চেক্স-এর সাথে সংযুক্ত করে এবং আপনাকে আপনার চেক্স অ্যাকাউন্টগুলিতে প্রবেশাধিকার প্রদান করে।
- আপনি যদি আগে সাইন ইন করে থাকেন, কিন্তু অন্য কোনো Google অ্যাকাউন্টে পরিবর্তন করতে চান, তাহলে
checks login --reauthব্যবহার করুন। - সাইন আউট করতে
checks logoutব্যবহার করুন।
- আপনি যদি আগে সাইন ইন করে থাকেন, কিন্তু অন্য কোনো Google অ্যাকাউন্টে পরিবর্তন করতে চান, তাহলে
ব্রাউজারে তৈরি হওয়া অথেনটিকেশন ইউআরএলটি খুলুন।
আপনার গুগল অ্যাকাউন্টে সাইন ইন করুন।
আপনার চেক্স অ্যাকাউন্ট অ্যাক্সেস করার জন্য চেক্স-কে সম্মতি দিন।