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