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

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

Bitbucket کو جوڑنے سے کوئی سائٹ آپ کے کسی Bitbucket Cloud ریپوزٹری سے ڈپلائی ہو سکتی ہے: برانچ پر پش کریں اور سائٹ اپ ڈیٹ ہو جاتی ہے۔

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

ایک Bitbucket Cloud اکاؤنٹ جس میں ان ریپوزٹریز تک رسائی ہو جنہیں آپ ڈپلائی کرنا چاہتے ہیں۔

1. Bitbucket پر کی (key) بنائیں

Bitbucket دو قسم کی اسناد (credentials) پیش کرتا ہے، اور دونوں میں سے کوئی بھی کام کرتی ہے:

• ریپوزٹری، پروجیکٹ یا ورک اسپیس کے لیے ایک رسائی ٹوکن، جو اسی ریپوزٹری، پروجیکٹ یا ورک اسپیس کی اپنی سیٹنگز میں Access tokens کے تحت بنایا گیا ہو۔ یہ کسی شخص کے بجائے اس ریپوزٹری، پروجیکٹ یا ورک اسپیس سے جڑا ہوتا ہے۔ اسے ریپوزٹریز تک پڑھنے کی رسائی (read access) دیں۔
• آپ کے Atlassian اکاؤنٹ پر ایک API ٹوکن۔ اپنا پروفائل منتخب کریں، پھر Account settings → Security → Create and manage API tokens → Create API token with scopes پر جائیں۔ اسے نام دیں، میعاد ختم ہونے کی تاریخ مقرر کریں، ایپ کے طور پر Bitbucket کو منتخب کریں، اور ریپوزٹریز تک پڑھنے کی رسائی کا انتخاب کریں۔ Bitbucket ٹوکن صرف ایک بار دکھاتا ہے؛ تب ہی اسے کاپی کریں۔

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

اپنے ڈیش بورڈ میں Integrations کھولیں اور Connect an account منتخب کریں۔ گروپ کے طور پر Code hosting اور اکاؤنٹ کے طور پر Bitbucket کا انتخاب کریں، API token پُر کریں — اور اگر آپ نے رسائی ٹوکن کے بجائے اپنے Atlassian اکاؤنٹ پر ٹوکن بنایا ہے، تو Account username بھی پُر کریں، اور Connect account دبائیں۔

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

صارف کا نام (username) یہ طے کرتا ہے کہ ہم ٹوکن کیسے بھیجتے ہیں، اس لیے اسے صرف اکاؤنٹ ٹوکن کے لیے درج کریں۔ صارف نام کے ساتھ درج کردہ رسائی ٹوکن، یا بغیر صارف نام کے اکاؤنٹ ٹوکن کو مسترد کر دیا جاتا ہے۔

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

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

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

کوئی ریپوزٹری غائب ہے۔ رسائی ٹوکن صرف اسی ریپوزٹری، پروجیکٹ یا ورک اسپیس تک رسائی حاصل کرتا ہے جہاں یہ بنایا گیا تھا۔ ایسی سطح پر ایک بنائیں جو آپ کو درکار ہر ریپوزٹری کا احاطہ کرتا ہو۔

یہ کام کرتا تھا اور پھر رک گیا۔ دونوں قسم کے ٹوکنز کی میعاد ختم ہو سکتی ہے۔ ایک نیا بنائیں اور اسے جوڑیں۔

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

یہ جڑ جاتا ہے، لیکن بعد میں کوئی چیز ناکام ہو جاتی ہے۔ کی تو توثیق کر دیتی ہے لیکن اس میں وہ اجازت نہیں ہوتی جو کارروائی کے لیے درکار ہو۔ اوپر درج اجازتوں کے ساتھ ایک نئی کی بنائیں، پھر پرانے کنکشن کو منقطع کریں اور نئی کی کو جوڑیں۔

منقطع کرنا (Disconnecting)

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

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