এটি সংযোগ করা আপনার জন্য কী সুবিধা দেয়
Zinn® GitHub অ্যাপটি ইনস্টল করলে আমাদের ব্যক্তিগত টোকেন না দিয়েও একটি সাইট আপনার রিপোজিটরিগুলো থেকে ডিপ্লয় হতে পারে — এবং একটি প্রজেক্ট বোর্ড GitHub-এর সাথে তাল মিলিয়ে চলতে পারে। আমরা কেবল অ্যাপটির ইনস্টলেশন নম্বর সংরক্ষণ করি, যা একা কোনো কাজে আসে না, এবং প্রতিবার প্রয়োজন হলে এক ঘণ্টা স্থায়ী একটি টোকেন তৈরি করি। কোনো প্রতিষ্ঠানের জন্য এটিই শ্রেয় পছন্দ, কারণ এটি কোনো একক ব্যক্তির অন্তর্গত নয় এবং কেউ চলে গেলে কাজ করা বন্ধ করে না।
শুরু করার আগে
একটি GitHub অ্যাকাউন্ট, বা যে প্রতিষ্ঠানে আপনি অ্যাপটি ইনস্টল করতে চান সেখানে ওনার (owner) অধিকার প্রয়োজন। যে প্রতিষ্ঠানগুলোতে তৃতীয় পক্ষের অ্যাপ নিষিদ্ধ, সেখানে একজন ওনারের অনুমতির প্রয়োজন; যদি তা সম্ভব না হয়, তবে বিকল্প হিসেবে একটি ফাইন-গ্রেইন্ড (fine-grained) টোকেন ব্যবহার করুন (Connect your GitHub account)।
১. GitHub-এ কি (key) তৈরি করুন
কোনো কি তৈরি করার প্রয়োজন নেই। আপনার ব্যক্তিগত অ্যাকাউন্টে বা আপনার প্রতিষ্ঠানে 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 বেছে নিন।
ইনস্টলেশন নম্বর পেস্ট করুন এবং এগিয়ে যান। কোনো কিছু সংরক্ষণ করার আগে আমরা ইনস্টলেশনটি যাচাই করি; যে নম্বরে আমরা পৌঁছাতে পারি না তা কখনোই সংরক্ষণ করা হয় না।
পরবর্তীতে কী ঘটবে
- সাইটের ডিপ্লয় করার জন্য অ্যাপটিকে আপনার অনুমোদিত রিপোজিটরিগুলো প্রদর্শিত হবে, এবং একটি পুশ (push) এটি ডিপ্লয় করবে।
- আমাদের নেওয়া প্রতিটি পদক্ষেপ GitHub-এ অ্যাপটির ইনস্টলেশন অডিট লগ-এ প্রদর্শিত হবে, আপনার নামে নয়।
- আমাদের আরও রিপোজিটরি দিতে, একই Configure পৃষ্ঠায় অ্যাপটির রিপোজিটরি অ্যাক্সেস পরিবর্তন করুন — পুনরায় কোনো কিছু সংযোগ করার প্রয়োজন নেই।
যদি এটি সংযোগ না হয়
একটি রিপোজিটরি পাওয়া যাচ্ছে না। ইনস্টলেশনটি কেবল আপনার বেছে নেওয়া রিপোজিটরিগুলো কভার করে। Configure খুলুন এবং এটি যোগ করুন।
নম্বরটি প্রত্যাখ্যান করা হয়েছে। এটি অ্যাড্রেস বার থেকে নেওয়া ইনস্টলেশন নম্বর কিনা তা যাচাই করুন, অ্যাপের নিজস্ব আইডি নয়, এবং অ্যাপটি এখনও ইনস্টল করা আছে কিনা — একটি আনইনস্টল করা অ্যাপের কোনো ইনস্টলেশন থাকে না।
এটি বলছে যে কি বাতিল হয়েছে। প্রায় সবসময় এটি তিনটি বিষয়ের একটি: এর সাথে কপি করা একটি স্পেস বা লাইন ব্রেক, একটি কি যা মেয়াদোত্তীর্ণ হয়ে গেছে, অথবা এমন একটি কি যা আপনি কপি করার পর প্রত্যাহার বা পুনরায় তৈরি করা হয়েছে। একটি নতুন কি তৈরি করুন এবং এটি আবার পেস্ট করুন।
এটি সংযোগ করে, কিন্তু পরবর্তীতে কিছু ব্যর্থ হয়। কি-টি প্রমাণীকরণ করে কিন্তু কাজটি সম্পন্ন করতে প্রয়োজনীয় অনুমতির অভাব রয়েছে। উপরে তালিকাভুক্ত অনুমতিসহ একটি নতুন কি তৈরি করুন, তারপর পুরোনো সংযোগটি বিচ্ছিন্ন করুন এবং নতুন কি সংযোগ করুন।
সংযোগ বিচ্ছিন্ন করা
Integrations খুলুন, অ্যাকাউন্টটি খুঁজুন এবং Disconnect চাপুন। এটি সংরক্ষিত কি সাথে সাথেই মুছে ফেলে। যা কিছু এটি ব্যবহার করছিল তা তার পরবর্তী পদক্ষেপে থেমে যায়, এবং এর উপর নির্ভরশীল স্ক্রিনগুলো নীরবে ব্যর্থ হওয়ার চেয়ে কারণ উল্লেখ করে।
সংযোগ বিচ্ছিন্ন করা ইতিমধ্যে সম্পন্ন হওয়া কাজগুলোকে পূর্বাবস্থায় ফিরিয়ে আনে না — আপনার অ্যাকাউন্টে আমাদের পরিবর্তিত রেকর্ড, ডিপ্লয়মেন্ট বা সেটিংস অপরিবর্তিত থাকে। আপনি যদি মনে করেন যে কি-টি ফাঁস হয়ে থাকতে পারে, তবে ভেন্ডরের কাছ থেকেও এটি প্রত্যাহার করুন; সংযোগ বিচ্ছিন্ন করলে কেবল আমাদের কপিটি মুছে যায়, তাদের কপিটি নয়।