इसे कनेक्ट करने से आपको क्या लाभ मिलता है
Bitbucket को कनेक्ट करने से कोई साइट आपकी Bitbucket Cloud रिपॉजिटरीज़ में से किसी एक से डिप्लॉय हो सकती है: ब्रांच में पुश करें और साइट अपडेट हो जाती है।
शुरू करने से पहले
एक Bitbucket Cloud खाता जिसमें उन रिपॉजिटरीज़ का एक्सेस हो जिन्हें आप डिप्लॉय करना चाहते हैं।
1. Bitbucket पर कुंजी बनाएं
Bitbucket दो प्रकार के क्रेडेंशियल प्रदान करता है, और दोनों ही काम करते हैं:
- किसी रिपॉजिटरी, प्रोजेक्ट या वर्कस्पेस के लिए एक एक्सेस टोकन, जो उस रिपॉजिटरी, प्रोजेक्ट या वर्कस्पेस की अपनी सेटिंग्स में Access tokens के अंतर्गत बनाया गया हो। यह किसी व्यक्ति के बजाय उस रिपॉजिटरी, प्रोजेक्ट या वर्कस्पेस से जुड़ा होता है। इसे रिपॉजिटरीज़ के लिए रीड एक्सेस दें।
- आपके 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 दबाएं।
कुछ भी सहेजे जाने से पहले हम आपके द्वारा पेस्ट की गई सामग्री का परीक्षण करते हैं। जो कुंजी काम नहीं करती उसे कभी भी संग्रहीत नहीं किया जाता है, और उत्तर में बताया जाता है कि उसमें क्या समस्या थी। जो कुंजी काम करती है उसे हमारे सीक्रेट्स वॉल्ट में एन्क्रिप्ट करके सुरक्षित रखा जाता है — हमारे डेटाबेस में कभी नहीं — और इसे फिर कभी नहीं दिखाया जाता है, आपको भी नहीं।
उपयोगकर्ता नाम यह तय करता है कि हम टोकन कैसे भेजते हैं, इसलिए इसे केवल खाता टोकन के लिए ही दर्ज करें। उपयोगकर्ता नाम के साथ दर्ज किया गया एक्सेस टोकन, या बिना उपयोगकर्ता नाम वाला खाता टोकन अस्वीकार कर दिया जाता है।
आगे क्या होता है
- एक साइट इस खाते की किसी रिपॉजिटरी से सीधे डिप्लॉय हो सकती है: इसे साइट के रिपॉजिटरी कनेक्शन पर चुनें, रिपॉजिटरी और ब्रांच चुनें, और एक पुश डिप्लॉय कर देता है।
- प्रत्येक अन्य ब्रांच को अपना स्वयं का पूर्वावलोकन मिल सकता है, ताकि आप लाइव साइट पर पहुँचने से पहले किसी परिवर्तन की जांच कर सकें।
- Git-निर्मित स्टेटिक होस्ट जैसे Render और Azure Static Web Apps इस कनेक्शन का उपयोग साइट के कोड के स्रोत के रूप में करते हैं।
यदि यह कनेक्ट नहीं होता है
कोई रिपॉजिटरी अनुपलब्ध है। एक एक्सेस टोकन केवल उसी रिपॉजिटरी, प्रोजेक्ट या वर्कस्पेस तक पहुँचता है जिसमें इसे बनाया गया था। इसे उस स्तर पर बनाएं जो आपकी ज़रूरत की प्रत्येक रिपॉजिटरी को कवर करता हो।
इसने काम किया और फिर बंद हो गया। दोनों प्रकार के टोकन समाप्त हो सकते हैं। एक नया टोकन बनाएं और उसे कनेक्ट करें।
यह कहता है कि कुंजी अस्वीकार कर दी गई थी। लगभग हमेशा तीन में से एक बात होती है: इसके साथ कॉपी किया गया कोई स्पेस या लाइन ब्रेक, ऐसी कुंजी जो समाप्त हो चुकी है, या ऐसी कुंजी जिसे आपके कॉपी करने के बाद निरस्त या पुनः जनरेट किया गया हो। एक नई कुंजी बनाएं और उसे फिर से पेस्ट करें।
यह कनेक्ट होता है, लेकिन बाद में कुछ विफल हो जाता है। कुंजी प्रमाणित तो होती है लेकिन उसमें उस अनुमति का अभाव होता है जिसकी कार्रवाई को आवश्यकता होती है। ऊपर सूचीबद्ध अनुमतियों के साथ एक नई कुंजी बनाएं, फिर पुराने कनेक्शन को डिस्कनेक्ट करें और नई कुंजी को कनेक्ट करें।
डिस्कनेक्ट करना
Integrations खोलें, खाता ढूंढें और Disconnect दबाएं। यह संग्रहीत कुंजी को तुरंत हटा देता है। जो कुछ भी इसका उपयोग कर रहा था वह अपनी अगली कार्रवाई पर रुक जाता है, और जो स्क्रीन इस पर निर्भर थीं वे चुपचाप विफल होने के बजाय ऐसा बता देती हैं।
डिस्कनेक्ट करने से वह कार्य पूर्ववत नहीं होता जो पहले ही किया जा चुका है — आपके खाते पर हमारे द्वारा बदले गए रिकॉर्ड, डिप्लॉयमेंट या सेटिंग्स वैसे ही रहते हैं जैसे वे हैं। यदि आपको लगता है कि कुंजी स्वयं लीक हो गई होगी, तो इसे वेंडर के यहाँ भी निरस्त करें; डिस्कनेक्ट करने से हमारी प्रतिलिपि हटती है, उनकी नहीं।