अपने GitHub खाते को एक टोकन के साथ कनेक्ट करें ताकि आपकी साइट्स किसी रिपॉजिटरी से परिनियोजित हो सकें

इसे कनेक्ट करने से आपको क्या लाभ मिलता है

GitHub को टोकन के साथ कनेक्ट करने से किसी साइट को आपके रिपॉजिटरी में से किसी एक से डिप्लॉय करने की सुविधा मिलती है: शाखा (branch) पर पुश करें और साइट अपडेट हो जाती है। यह हमें आपके खाते पर GitHub Pages पर प्रकाशित करने की अनुमति भी देता है, जहाँ आप उसे साइट के होस्ट के रूप में चुनते हैं।

यदि आपकी रिपॉजिटरी किसी संगठन से संबंधित हैं, तो इसके बजाय Zinn® GitHub ऐप को प्राथमिकता दें — देखें Zinn® GitHub ऐप इंस्टॉल करें। एक टोकन एक व्यक्ति का होता है और उनके छोड़ने पर काम करना बंद कर देता है।

शुरू करने से पहले

एक 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 दबाएँ। यह संग्रहीत कुंजी को तुरंत हटा देता है। जो कुछ भी इसका उपयोग कर रहा था वह अपनी अगली कार्रवाई पर रुक जाता है, और जो स्क्रीन इस पर निर्भर थीं वे चुपचाप विफल होने के बजाय ऐसा होने की सूचना देती हैं।

डिस्कनेक्ट करने से वह पूर्ववत नहीं होता जो पहले ही किया जा चुका है — रिकॉर्ड, डिप्लॉयमेंट या सेटिंग्स जो हमने आपके खाते पर बदली हैं, वे जैसी हैं वैसी ही रहती हैं। यदि आपको लगता है कि कुंजी स्वयं लीक हो गई होगी, तो इसे वेंडर के यहाँ भी निरस्त करें; डिस्कनेक्ट करने से हमारी प्रतिलिपि हटती है, उनकी नहीं।