এটি সংযুক্ত করলে আপনার কী সুবিধা হবে
টোকেনের মাধ্যমে GitHub সংযুক্ত করলে আপনার কোনো একটি রিপোজিটরি থেকে সাইট ডিপ্লয় করা যায়: ব্রাঞ্চে পুশ করলেই সাইট আপডেট হয়ে যাবে। আপনি সাইটের হোস্ট হিসেবে বেছে নিলে এটি আপনার অ্যাকাউন্টের GitHub Pages-এ আমাদের প্রকাশ করার সুবিধাও দেয়।
আপনার রিপোজিটরিগুলো যদি কোনো প্রতিষ্ঠানের আওতাভুক্ত হয়, তবে তার বদলে Zinn® GitHub অ্যাপ ব্যবহার করুন — দেখুন Zinn® GitHub অ্যাপ ইনস্টল করুন। একটি টোকেন কেবল একজন ব্যক্তির অধীনে থাকে এবং তিনি চলে গেলে এটি কাজ করা বন্ধ করে দেয়।
শুরু করার আগে
যেসব রিপোজিটরি আপনি ডিপ্লয় করতে চান, সেগুলোতে অ্যাক্সেসসহ একটি GitHub অ্যাকাউন্ট থাকতে হবে। সেগুলো কোনো প্রতিষ্ঠানের আওতাভুক্ত হলে, তার জন্য একজন মালিকের ফাইন-গ্রেইনড টোকেন অনুমোদন করার প্রয়োজন হতে পারে।
১. GitHub-এ কি তৈরি করুন
GitHub-এ, আপনার প্রোফাইল ছবিতে ক্লিক করুন, তারপর Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token-এ যান। এটির একটি নাম দিন এবং মেয়াদের সময়সীমা নির্বাচন করুন। Repository access-এর অধীনে Only select repositories নির্বাচন করুন এবং আপনি যেগুলো ডিপ্লয় করেন সেগুলো বেছে নিন — সবচেয়ে সীমিত যে অ্যাক্সেসে কাজ চলে।
Repository permissions-এর অধীনে এগুলোতে Read and write অনুমতি দিন:
- Contents
- Pages
- Administration
Generate token-এ চাপ দিন এবং এটি কপি করুন — GitHub এটি কেবল একবারই দেখায়।
২. এখানে এটি সংযুক্ত করুন
আপনার ড্যাশবোর্ডে Integrations খুলুন এবং Connect an account বেছে নিন। গ্রুপ হিসেবে Code hosting এবং অ্যাকাউন্ট হিসেবে GitHub বেছে নিন, API token পূরণ করুন এবং Connect account-এ চাপ দিন।
কোনো কিছু সংরক্ষণ করার আগে আপনি যা পেস্ট করেছেন তা আমরা পরীক্ষা করে দেখি। কাজ করে না এমন কি কখনোই সংরক্ষণ করা হয় না, এবং উত্তরে বলা থাকে এতে কী সমস্যা ছিল। কাজ করে এমন কি আমাদের সিক্রেটস ভল্টে এনক্রিপ্ট করে রাখা হয় — আমাদের ডেটাবেসে কখনোই নয় — এবং এটি আপনার কাছেও আর কখনোই দেখানো হয় না।
এর পরে কী ঘটে
- এই অ্যাকাউন্টের রিপোজিটরি থেকে সরাসরি একটি সাইট ডিপ্লয় হতে পারে: সাইটের রিপোজিটরি সংযোগে এটি নির্বাচন করুন, রিপোজিটরি ও ব্রাঞ্চ বেছে নিন এবং পুশ করলেই ডিপ্লয় হয়ে যাবে।
- অন্য প্রতিটি ব্রাঞ্চের নিজস্ব প্রিভিউ থাকতে পারে, যাতে লাইভ সাইটে পৌঁছানোর আগেই আপনি কোনো পরিবর্তন যাচাই করে নিতে পারেন।
- Render এবং Azure Static Web Apps-এর মতো Git-বিল্ট স্ট্যাটিক হোস্টগুলো সাইটের কোডের উৎস হিসেবে এই সংযোগটি ব্যবহার করে।
এটি সংযুক্ত না হলে
একটি রিপোজিটরি প্রদর্শিত হচ্ছে না। টোকেনের রিপোজিটরি অ্যাক্সেসে এটি অন্তর্ভুক্ত নেই। GitHub-এ টোকেনটি এডিট করুন এবং রিপোজিটরিটি যোগ করুন।
এটি কাজ করছিল এবং তারপর বন্ধ হয়ে গেছে। আপনার বেছে নেওয়া তারিখে ফাইন-গ্রেইনড টোকেনের মেয়াদ শেষ হয়ে যায়। নতুন একটি তৈরি করে সংযুক্ত করুন; কোনো টোকেনের মেয়াদ শেষ হওয়ার আগে GitHub আপনাকে ইমেল পাঠায়।
এতে বলা হচ্ছে কি প্রত্যাখ্যান করা হয়েছে। প্রায় সবসময়ই তিনটি বিষয়ের একটি ঘটে: এর সাথে একটি স্পেস বা লাইন ব্রেক কপি হওয়া, মেয়াদের সময়সীমা শেষ হয়ে যাওয়া একটি কি, অথবা আপনি কপি করার পর বাতিল বা পুনরায় জেনারেট করা কোনো কি। নতুন একটি তৈরি করে আবার পেস্ট করুন।
এটি সংযুক্ত হয়, কিন্তু পরবর্তীতে কোনো কিছু ব্যর্থ হয়। কি-টি প্রমাণীকরণ সম্পন্ন করে কিন্তু প্রক্রিয়াটির জন্য প্রয়োজনীয় অনুমতির অভাব থাকে। উপরে তালিকাভুক্ত অনুমতিগুলো দিয়ে একটি নতুন কি তৈরি করুন, তারপর পুরনো সংযোগটি বিচ্ছিন্ন করে নতুন কি-টি সংযুক্ত করুন।
সংযোগ বিচ্ছিন্ন করা
Integrations খুলুন, অ্যাকাউন্টটি খুঁজুন এবং Disconnect-এ চাপ দিন। এতে সংরক্ষিত কি অবিলম্বে মুছে যায়। এটি ব্যবহার করছিল এমন যেকোনো কিছু এর পরবর্তী পদক্ষেপেই থেমে যাবে, এবং এর উপর নির্ভরশীল স্ক্রিনগুলো কোনো বার্তা না দিয়ে ব্যর্থ হওয়ার বদলে বিষয়টি জানিয়ে দেবে।
সংযোগ বিচ্ছিন্ন করলে ইতিমধ্যে যা করা হয়েছে তা বাতিল হয় না — আপনার অ্যাকাউন্টে আমাদের পরিবর্তিত রেকর্ড, ডিপ্লয়মেন্ট বা সেটিংস অপরিবর্তিত থাকে। আপনি যদি মনে করেন কি-টি ফাঁস হয়ে থাকতে পারে, তবে ভেন্ডরের কাছ থেকেও এটি প্রত্যাহার করুন; সংযোগ বিচ্ছিন্ন করলে কেবল আমাদের কপিটি মুছে যায়, তাদেরটি নয়।