इसे कनेक्ट करने से आपको क्या लाभ मिलता है
Zinn® GitHub ऐप इंस्टॉल करने से आपकी साइट आपकी रिपॉजिटरी से डिप्लॉय हो सकती है — और प्रोजेक्ट बोर्ड GitHub के साथ सिंक रह सकता है — बिना हमें कोई व्यक्तिगत टोकन दिए। हमारे पास केवल ऐप का इंस्टॉलेशन नंबर रहता है, जो अपने आप में बेकार है, और जब भी हमें आवश्यकता होती है, हम एक ऐसा टोकन बनाते हैं जो केवल एक घंटे तक काम करता है। किसी संगठन के लिए यह बेहतर विकल्प है, क्योंकि यह किसी एक व्यक्ति का नहीं होता और किसी के जाने पर काम करना बंद नहीं करता है।
शुरू करने से पहले
एक GitHub खाता, या उस संगठन पर स्वामी के अधिकार जहाँ आप ऐप इंस्टॉल करना चाहते हैं। जो संगठन तृतीय-पक्ष ऐप्स को प्रतिबंधित करते हैं, उन्हें इसकी अनुमति देने के लिए एक स्वामी की आवश्यकता होती है; यदि यह संभव नहीं है, तो इसके बजाय फाइन-ग्रेन्ड टोकन का उपयोग करें (अपना GitHub खाता कनेक्ट करें)।
1. GitHub पर कुंजी बनाएँ
बनाने के लिए कोई कुंजी नहीं है। अपने व्यक्तिगत खाते या अपने संगठन पर Zinn® GitHub ऐप इंस्टॉल करें, और या तो सभी रिपॉजिटरी चुनें या केवल वे रिपॉजिटरी चुनें जिन्हें आप चाहते हैं कि हम डिप्लॉय करें।
फिर इंस्टॉलेशन नंबर खोजें:
- व्यक्तिगत खाता — Settings → Applications → Installed GitHub Apps, और Zinn® ऐप के आगे Configure।
- संगठन — Your organizations → Settings → GitHub Apps, और Zinn® ऐप के आगे Configure।
उस पृष्ठ पर एड्रेस बार के अंत में दी गई संख्या — उदाहरण के लिए github.com/settings/installations/12345678 — इंस्टॉलेशन नंबर है।
2. इसे यहाँ कनेक्ट करें
ऐप को इंटीग्रेशन स्क्रीन के बजाय वहीं चुना जाता है जहाँ इसका उपयोग किया जाता है:
- साइट के रिपॉजिटरी कनेक्शन पर, GitHub (ऐप इंस्टॉल) चुनें।
- प्रोजेक्ट बोर्ड के GitHub लिंक पर, The Zinn® GitHub app चुनें।
इंस्टॉलेशन नंबर पेस्ट करें और जारी रखें। हम कुछ भी सहेजने से पहले इंस्टॉलेशन की जाँच करते हैं; जिस नंबर तक हम नहीं पहुँच सकते, उसे कभी भी संग्रहीत नहीं किया जाता है।
आगे क्या होता है
- ऐप को आपके द्वारा दी गई रिपॉजिटरी साइट के डिप्लॉय होने के लिए दिखाई देती हैं, और एक पुश इसे डिप्लॉय कर देता है।
- हमारे द्वारा की जाने वाली प्रत्येक कार्रवाई GitHub पर ऐप के नाम के तहत इंस्टॉलेशन के ऑडिट लॉग में दिखाई देती है, आपके नाम के तहत नहीं।
- हमें और अधिक रिपॉजिटरी देने के लिए, उसी Configure पृष्ठ पर ऐप की रिपॉजिटरी एक्सेस बदलें — किसी भी चीज़ को फिर से कनेक्ट करने की आवश्यकता नहीं है।
यदि यह कनेक्ट नहीं होता है
एक रिपॉजिटरी गायब है। इंस्टॉलेशन केवल आपके द्वारा चुनी गई रिपॉजिटरी को ही कवर करता है। Configure खोलें और इसे जोड़ें।
नंबर अस्वीकार कर दिया गया है। जाँचें कि यह एड्रेस बार से लिया गया इंस्टॉलेशन नंबर है, न कि ऐप की अपनी आईडी, और यह कि ऐप अभी भी इंस्टॉल है — अनइंस्टॉल किए गए ऐप का कोई इंस्टॉलेशन नहीं होता है।
यह कहता है कि कुंजी अस्वीकार कर दी गई थी। लगभग हमेशा तीन में से एक बात होती है: इसके साथ कॉपी किया गया स्पेस या लाइन ब्रेक, एक कुंजी जिसकी समय सीमा समाप्त हो गई है, या एक कुंजी जिसे कॉपी करने के बाद रद्द या पुनर्जीवित किया गया था। एक नई कुंजी बनाएँ और इसे फिर से पेस्ट करें।
यह कनेक्ट होता है, लेकिन बाद में कुछ विफल हो जाता है। कुंजी प्रमाणित होती है लेकिन इसमें उस अनुमति का अभाव होता है जिसकी कार्रवाई को आवश्यकता होती है। ऊपर सूचीबद्ध अनुमतियों के साथ एक नई कुंजी बनाएँ, फिर पुराने कनेक्शन को डिस्कनेक्ट करें और नई कुंजी को कनेक्ट करें।
डिस्कनेक्ट करना
इंटीग्रेशन्स खोलें, खाता खोजें और डिस्कनेक्ट करें दबाएँ। यह संग्रहीत कुंजी को तुरंत हटा देता है। जो कुछ भी इसका उपयोग कर रहा था वह अपनी अगली कार्रवाई पर रुक जाता है, और जो स्क्रीन इस पर निर्भर थीं वे चुपचाप विफल होने के बजाय ऐसा संकेत देती हैं।
डिस्कनेक्ट करने से वह पहले जैसा नहीं होता जो पहले ही किया जा चुका है — आपके खाते पर हमारे द्वारा बदले गए रिकॉर्ड, डिप्लॉयमेंट या सेटिंग्स वैसे ही रहते हैं जैसे वे हैं। यदि आपको लगता है कि कुंजी स्वयं लीक हो गई है, तो इसे विक्रेता के पास भी रद्द करें; डिस्कनेक्ट करने से हमारी प्रतिलिपि हटती है, उनकी नहीं।