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