এটি আপনার জন্য কী করে
Zinn® GitHub অ্যাপ ইনস্টল করলে ব্যক্তিগত টোকেন প্রদান ছাড়াই আপনার রেপোজিটরি থেকে একটি সাইট ডিপ্লয় করা যায় এবং প্রজেক্ট বোর্ড GitHub-এর সাথে তাল মিলিয়ে চলতে পারে। আমরা কেবল অ্যাপের ইনস্টলেশন নম্বর সংরক্ষণ করি, যা নিজে থেকে কোনো কাজে লাগে না, এবং প্রয়োজন অনুযায়ী প্রতিবার এক ঘণ্টার জন্য একটি টোকেন তৈরি করি। এটি কোনো প্রতিষ্ঠানের জন্য ভালো পছন্দ, কারণ এটি কোনো নির্দিষ্ট ব্যক্তির নয় এবং কেউ চলে গেলে কাজ বন্ধ হয়ে যায় না।
শুরু করার আগে
একটি GitHub অ্যাকাউন্ট, অথবা যে প্রতিষ্ঠানে আপনি অ্যাপটি ইনস্টল করতে চান সেখানে মালিকের অধিকার। যেসব প্রতিষ্ঠান তৃতীয় পক্ষের অ্যাপ নিষিদ্ধ করে, সেখানে অ্যাপটি অনুমোদনের জন্য একজন মালিকের প্রয়োজন হয়; যদি তা সম্ভব না হয়, তবে এর পরিবর্তে একটি ফাইন-গ্রেইন্ড টোকেন ব্যবহার করুন (আপনার GitHub অ্যাকাউন্ট যুক্ত করুন)।
১. GitHub-এ কি তৈরি করুন
তৈরি করার মতো কোনো কি নেই। আপনার ব্যক্তিগত অ্যাকাউন্টে বা আপনার প্রতিষ্ঠানে Zinn® GitHub অ্যাপ ইনস্টল করুন, এবং সব রেপোজিটরি অথবা আপনি যেগুলোর মাধ্যমে ডিপ্লয় করতে চান কেবল সেগুলোর যেকোনো একটি বেছে নিন।
তারপর ইনস্টলেশন নম্বরটি খুঁজে বের করুন:
- ব্যক্তিগত অ্যাকাউন্ট — Settings → Applications → Installed GitHub Apps, এবং Zinn® অ্যাপের পাশে Configure-এ ক্লিক করুন।
- প্রতিষ্ঠান — Your organizations → Settings → GitHub Apps, এবং Zinn® অ্যাপের পাশে Configure-এ ক্লিক করুন।
ওই পেজে অ্যাড্রেস বারের শেষের নম্বরটি—উদাহরণস্বরূপ github.com/settings/installations/12345678—হলো ইনস্টলেশন নম্বর।
২. এখানে সংযুক্ত করুন
ইন্টিগ্রেশন স্ক্রিনে নয়, বরং যেখানে অ্যাপটি ব্যবহার করা হয় সেখানেই এটি নির্বাচন করা হয়:
- কোনো সাইটের রেপোজিটরি সংযোগে, GitHub (app install) নির্বাচন করুন।
- কোনো প্রজেক্ট বোর্ডের GitHub লিঙ্কে, The Zinn® GitHub app নির্বাচন করুন।
ইনস্টলেশন নম্বর পেস্ট করুন এবং এগিয়ে যান। কোনো কিছু সংরক্ষণের আগে আমরা ইনস্টলেশনটি পরীক্ষা করে দেখি; যে নম্বরটিতে পৌঁছানো যায় না তা কখনো সংরক্ষণ করা হয় না।
এরপর কী ঘটে
- সাইট থেকে ডিপ্লয় করার জন্য আপনি অ্যাপটিকে যে রেপোজিটরিগুলোর অনুমতি দিয়েছেন সেগুলো প্রদর্শিত হয়, এবং একটি পুশ ডিপ্লয় সম্পন্ন করে।
- আপনার নামে নয়, বরং অ্যাপের নামে GitHub-এ ইনস্টলেশনের অডিট লগে আমাদের করা প্রতিটি কাজ প্রদর্শিত হয়।
- আমাদের আরও রেপোজিটরি দিতে চাইলে, একই Configure পেজে গিয়ে অ্যাপের রেপোজিটরি অ্যাক্সেস পরিবর্তন করুন—কোনো কিছু পুনরায় সংযুক্ত করার প্রয়োজন নেই।
যদি এটি সংযুক্ত না হয়
একটি রেপোজিটরি অনুপস্থিত রয়েছে। ইনস্টলেশনটি শুধুমাত্র আপনার বেছে নেওয়া রেপোজিটরিগুলো কভার করে। Configure খুলুন এবং এটি যোগ করুন।
নম্বারটি প্রত্যাখ্যাত হয়েছে। এটি যাচাই করুন যে এটি অ্যাড্রেস বারের ইনস্টলেশন নম্বর, অ্যাপের নিজস্ব আইডি নয়, এবং অ্যাপটি এখনও ইনস্টল করা আছে—একটি আনইনস্টল করা অ্যাপের কোনো ইনস্টলেশন থাকে না।
এটি বলে যে কি প্রত্যাখ্যান করা হয়েছে। প্রায় সবসময় তিনটি বিষয়ের যেকোনো একটি: এর সাথে একটি অতিরিক্ত স্পেস বা লাইন ব্রেক কপি করা হয়েছে, এমন একটি কি যার মেয়াদ শেষ হয়ে গেছে, অথবা কপি করার পর যে কি বাতিল বা পুনরুৎপাদন করা হয়েছে। একটি নতুন কি তৈরি করুন এবং এটি আবার পেস্ট করুন।
এটি সংযুক্ত হয়, কিন্তু পরবর্তীতে কোনো কিছু ব্যর্থ হয়। কি-টি প্রমাণীকরণ সম্পন্ন করে কিন্তু কাজের জন্য প্রয়োজনীয় কোনো অনুমতি তার নেই। উপরে তালিকাভুক্ত অনুমতিগুলো সহ একটি নতুন কি তৈরি করুন, তারপর পুরোনো সংযোগটি বিচ্ছিন্ন করুন এবং নতুন কি-টি সংযুক্ত করুন।
সংযোগ বিচ্ছিন্ন করা
Integrations খুলুন, অ্যাকাউন্টটি খুঁজুন এবং Disconnect-এ চাপুন। এটি অবিলম্বে সংরক্ষিত কি মুছে ফেলে। এটি ব্যবহার করা যেকোনো কিছু তার পরবর্তী কাজে থেমে যায় এবং যে স্ক্রিনগুলো এর ওপর নির্ভরশীল ছিল সেগুলো নীরবে ব্যর্থ না হয়ে তা জানিয়ে দেয়।
সংযোগ বিচ্ছিন্ন করা ইতিমধ্যে যা করা হয়েছে তা পূর্বাবস্থায় ফেরায় না—আপনার অ্যাকাউন্টে আমরা যে রেকর্ড, ডিপ্লয়মেন্ট বা সেটিংস পরিবর্তন করেছি তা যেমন আছে তেমনই থাকে। আপনার যদি মনে হয় কি-টি নিজেই ফাঁস হয়ে থাকতে পারে, তবে ভেন্ডরের কাছে গিয়েও তা বাতিল করুন; সংযোগ বিচ্ছিন্ন করা আমাদের অনুলিপিটি সরিয়ে দেয়, তাদেরটি নয়।