اپنے GitHub اکاؤنٹ کو ٹوکن کے ساتھ مربوط کریں تاکہ آپ کی سائٹس ایک ریپوزٹری سے ڈیپلائے ہو سکیں

اسے جوڑنے سے آپ کو کیا فائدہ ہوتا ہے

GitHub کو ٹوکن کے ساتھ جوڑنے سے کوئی سائٹ آپ کی کسی ریپوزٹری سے ڈپلائے ہو سکتی ہے: برانچ پر پش کریں اور سائٹ اپ ڈیٹ ہو جاتی ہے۔ یہ آپ کے اکاؤنٹ پر GitHub Pages پر بھی شائع کرنے کی سہولت دیتا ہے جہاں آپ اسے کسی سائٹ کے ہوسٹ کے طور پر منتخب کرتے ہیں۔

اگر آپ کی ریپوزٹریز کسی آرگنائزیشن سے تعلق رکھتی ہیں، تو اس کے بجائے the Zinn® GitHub app کو ترجیح دیں — Install the Zinn® GitHub app دیکھیں۔ ایک ٹوکن کا تعلق ایک شخص سے ہوتا ہے اور اس کے جانے پر وہ کام کرنا بند کر دیتا ہے۔

شروع کرنے سے پہلے

آپ کی تعینات کردہ ریپوزٹریز تک رسائی کا حامل GitHub اکاؤنٹ۔ اگر ان کا تعلق کسی آرگنائزیشن سے ہے، تو کسی مالک کو اس کے لیے فائن گرینڈ ٹوکنز کی منظوری دینا پڑ سکتی ہے۔

1. 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 اسے ایک بار دکھاتا ہے۔

2. اسے یہاں جوڑیں

اپنے ڈیش بورڈ میں Integrations کھولیں اور Connect an account کا انتخاب کریں۔ گروپ کے طور پر Code hosting اور اکاؤنٹ کے طور پر GitHub کا انتخاب کریں، API token پُر کریں، اور Connect account دبائیں۔

کچھ بھی محفوظ ہونے سے پہلے ہم آپ کے پیسٹ کردہ مواد کی جانچ کرتے ہیں۔ جو کلید کام نہیں کرتی اسے کبھی محفوظ نہیں کیا جاتا، اور جواب میں بتایاجاتا ہے کہ اس میں کیا خرابی تھی۔ جو کلید کام کرتی ہے اسے ہمارے سیکرٹس والٹ میں انکرپٹڈ رکھا جاتا ہے—کبھی بھی ہمارے ڈیٹا بیس میں نہیں—اور اسے دوبارہ کبھی نہیں دکھایا جاتا، یہاں تک کہ آپ کو بھی نہیں۔

آگے کیا ہوتا ہے

• ایک سائٹ اس اکاؤنٹ پر موجود ریپوزٹری سے براہ راست ڈپلائے ہو سکتی ہے: سائٹ کے ریپوزٹری کنکشن پر اس کا انتخاب کریں، ریپوزٹری اور برانچ کا انتخاب کریں، اور پش کرنے پر ڈپلائے ہو جاتا ہے۔
• ہر دوسری برانچ کا اپنا پیش منظر (پریویو) ہو سکتا ہے، تاکہ آپ لائیو سائٹ تک پہنچنے سے پہلے کسی تبدیلی کی جانچ کر سکیں۔
• Git سے بنے ہوئے سٹیٹک ہوسٹس جیسے کہ Render اور Azure Static Web Apps اس کنکشن کو سائٹ کے کوڈ کے ماخذ کے طور پر استعمال کرتے ہیں۔

اگر یہ کنیکٹ نہ ہو

کوئی ریپوزٹری ظاہر نہیں ہوتی۔ ٹوکن کی ریپوزٹری رسائی میں وہ شامل نہیں ہے۔ GitHub پر ٹوکن میں ترمیم کریں اور ریپوزٹری شامل کریں۔

یہ کام کر رہا تھا اور پھر رک گیا۔ فائن گرینڈ ٹوکنز آپ کی منتخب کردہ تاریخ کو ختم ہو جاتے ہیں۔ ایک نیا تیار کریں اور اسے جوڑیں؛ ٹوکن کی میعاد ختم ہونے سے پہلے GitHub آپ کو ای میل کرتا ہے۔

یہ بتاتا ہے کہ کلید مسترد کر دی گئی تھی۔ تقریباً ہمیشہ تین میں سے ایک بات ہوتی ہے: اس کے ساتھ کوئی سپیس یا لائن بریک کاپی ہو گئی ہو، کوئی ایسی کلید جس کی میعاد ختم ہو چکی ہو، یا کوئی ایسی کلید جسے آپ کے کاپی کرنے کے بعد منسوخ یا دوبارہ تیار کیا گیا ہو۔ ایک نئی کلید بنائیں اور اسے دوبارہ پیسٹ کریں۔

یہ کنیکٹ ہو جاتا ہے، لیکن بعد میں کوئی چیز ناکام ہو جاتی ہے۔ کلید تو تصدیق کرتی ہے لیکن اس میں وہ اجازت نہیں ہے جس کی ایکشن کو ضرورت ہے۔ اوپر درج اجازتوں کے ساتھ ایک نئی کلید بنائیں، پھر پرانا کنکشن ڈس کنیکٹ کریں اور نئی کلید کنیکٹ کریں۔

ڈس کنیکٹ کرنا

Integrations کھولیں، اکاؤنٹ تلاش کریں اور Disconnect دبائیں۔ اس سے محفوظ کردہ کلید فوری طور پر حذف ہو جاتی ہے۔ جو بھی چیز اسے استعمال کر رہی تھی وہ اپنے اگلے ایکشن پر رک جاتی ہے، اور اس پر انحصار کرنے والی سکرینز خاموشی سے ناکام ہونے کے بجائے ایسا ہونے کی اطلاع دیتی ہیں۔

ڈس کنیکٹ کرنے سے پہلے سے کیا گیا کام کالعدم نہیں ہوتا—ریکارڈز، ڈپلائمنٹس یا ترتیبات جو ہم نے آپ کے اکاؤنٹ پر تبدیل کی تھیں وہ ویسی ہی رہتی ہیں۔ اگر آپ کو لگتا ہے کہ کلید خود لیک ہو گئی ہو گی، تو اسے وینڈر کے پاس بھی منسوخ کر دیں؛ ڈس کنیکٹ کرنے سے ہماری کاپی ہٹتی ہے، ان کی نہیں۔