সংযোগটি আপনার জন্য কী করে
একটি টোকেন দিয়ে GitHub যুক্ত করলে আপনার একটি রিপোজিটরি থেকে সাইট ডিপ্লয় করা যায়: শাখায় পুশ করুন এবং সাইট আপডেট হয়ে যায়। আপনি যখন GitHub Pages কে কোনো সাইটের হোস্ট হিসেবে বেছে নেন, তখন এটি আপনার অ্যাকাউন্টে GitHub Pages-এ প্রকাশ করতেও আমাদের সহায়তা করে।
আপনার রিপোজিটরিগুলো যদি কোনো সংস্থার মালিকানাধীন হয়, তবে তার পরিবর্তে the Zinn® GitHub app ব্যবহার করুন—Install the Zinn® GitHub app দেখুন। একটি টোকেন একজন ব্যক্তির মালিকানাধীন এবং সেই ব্যক্তি চলে গেলে এটি কাজ করা বন্ধ করে দেয়।
শুরু করার আগে
ডিপ্লয় করতে চান এমন রিপোজিটরিগুলোতে অ্যাক্সেসসহ একটি 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 এ চাপুন। এর মাধ্যমে সংরক্ষিত কি অবিলম্বে মুছে যায়। এটি ব্যবহার করছিল এমন যেকোনো কিছু তার পরবর্তী কাজের সময় বন্ধ হয়ে যায় এবং যেসব স্ক্রিন এর ওপর নির্ভরশীল ছিল সেগুলো নীরবে ব্যর্থ না হয়ে তা জানিয়ে দেয়।
সংযোগ বিচ্ছিন্ন করার ফলে যা ইতিমধ্যে করা হয়েছে তা পূর্বাবস্থায় ফিরে যায় না—রেকর্ড, ডিপ্লয়মেন্ট বা আপনার অ্যাকাউন্টে আমরা যে সেটিংস পরিবর্তন করেছি তা যেমন ছিল তেমনি থাকে। আপনার যদি মনে হয় কি-টি নিজে থেকেই ফাঁস হয়ে গেছে, তবে ভেন্ডার-এ গিয়েও এটি বাতিল করুন; সংযোগ বিচ্ছিন্ন করার মাধ্যমে আমাদের কপি মুছে যায়, তাদেরটা নয়।