लामो अवधिको टोकन बिना नै हामीले डिप्लोय गर्न सकून् भनेर Zinn® GitHub एप इन्स्टल गर्नुहोस्।

यसलाई जडान गर्दा हुने फाइदाहरू

Zinn® GitHub एप इन्स्टल गर्नाले कुनै पनि साइटलाई व्यक्तिगत टोकन (personal token) नदिईकन नै तपाईंका भण्डारहरू (repositories) बाट डिप्लोय गर्न र प्रोजेक्ट बोर्डलाई GitHub सँग अद्यावधिक राख्न अनुमति दिन्छ। हामी केवल एपको इन्स्टलेशन नम्बर (installation number) मात्र राख्छौँ, जुन आफैँमा निरर्थक हुन्छ, र आवश्यक परेका बेला प्रत्येक पटक एक घण्टासम्म चल्ने टोकन जारी गर्छौँ। संस्थाका लागि यो उत्तम विकल्प हो, किनकि यो कुनै एक व्यक्तिमा सीमित हुँदैन र कोही व्यक्तिले छाडेर जाँदा पनि काम गर्न छाड्दैन।

सुरु गर्नुअघि

एक GitHub खाता, वा तपाईंले एप इन्स्टल गर्न चाहनुभएको संस्थामा मालिकको अधिकार (owner rights) आवश्यक पर्दछ। तेस्रो-पक्ष (third-party) एपहरूलाई प्रतिबन्ध लगाउने संस्थाहरूमा मालिकले यसलाई अनुमति दिनुपर्छ; यदि त्यो सम्भव छैन भने, त्यसको सट्टा फाइन-ग्रेन टोकन (fine-grained token) प्रयोग गर्नुहोस् (तपाईंको GitHub खाता जडान गर्नुहोस्)।

१. GitHub मा कुञ्जी (key) सिर्जना गर्नुहोस्

सिर्जना गर्नुपर्ने कुनै कुञ्जी छैन। आफ्नो व्यक्तिगत खाता वा संस्थामा Zinn® GitHub एप इन्स्टल गर्नुहोस्, र कि त सबै भण्डारहरू (repositories) वा हामीले डिप्लोय गर्न चाहेका भण्डारहरू मात्र छनोट गर्नुहोस्।

त्यसपछि इन्स्टलेशन नम्बर पत्ता लगाउनुहोस्:

• व्यक्तिगत खाता — Settings → Applications → Installed GitHub Apps, र Zinn® एपको छेउमा रहेको Configure मा जानुहोस्।
• संस्था — Your organizations → Settings → GitHub Apps, र Zinn® एपको छेउमा रहेको Configure मा जानुहोस्।

त्यस पृष्ठको एड्रेस बारको अन्त्यमा रहेको नम्बर — उदाहरणका लागि github.com/settings/installations/12345678 — नै इन्स्टलेशन नम्बर हो।

२. यहाँ जडान गर्नुहोस्

एप इन्टिग्रेसन (Integrations) स्क्रिनमा भन्दा पनि यसको प्रयोग हुने ठाउँमा छनोट गरिन्छ:

• साइटको भण्डार जडानमा, GitHub (app install) छनोट गर्नुहोस्।
• प्रोजेक्ट बोर्डको GitHub लिङ्कमा, The Zinn® GitHub app छनोट गर्नुहोस्।

इन्स्टलेशन नम्बर पेस्ट गर्नुहोस् र अगाडि बढ्नुहोस्। हामी केही कुरा सेभ गर्नुअघि इन्स्टलेशनको जाँच गर्छौँ; हामीले पहुँच पाउन नसकेको नम्बर कहिल्यै सेभ हुँदैन।

त्यसपछि के हुन्छ

• तपाईंले एपलाई अनुमति दिनुभएका भण्डारहरू साइटले डिप्लोय गर्नका लागि देखा पर्छन्, र पुश (push) ले यसलाई डिप्लोय गर्छ।
• हामीले गर्ने प्रत्येक कार्य GitHub मा तपाईंको नाममा नभई एपको नाममा इन्स्टलेशनको अडिट लगमा देखा पर्छ।
• हामीलाई थप भण्डारहरूको पहुँच दिनका लागि, सोही Configure पृष्ठमा एपको भण्डार पहुँच परिवर्तन गर्नुहोस् — केही पनि पुनः जडान गर्नुपर्दैन।

यदि यो जडान भएन भने

भण्डार फेला परेन। इन्स्टलेशनले तपाईंले छनोट गर्नुभएका भण्डारहरूलाई मात्र समेट्छ। Configure खोल्नुहोस् र यसलाई थप्नुहोस्।

नम्बर अस्वीकृत भयो। एड्रेस बारबाट लिइएको नम्बर नै इन्स्टलेशन नम्बर हो कि होइन (एपको आफ्नै ID होइन) र एप अझै इन्स्टल छ कि छैन भनी जाँच गर्नुहोस् — अनइन्स्टल गरिएको एपको कुनै इन्स्टलेशन हुँदैन।

कुञ्जी अस्वीकृत भयो भन्छ। प्रायः यी तीनवटा कारणहरूमध्ये एक हुन्छ: यससँगै प्रतिलिपि (copy) गरिएको खाली ठाउँ (space) वा लाइन ब्रेक, म्याद सकिएको कुञ्जी, वा तपाईंले प्रतिलिपि गरेपछि रद्द वा पुनः सिर्जना गरिएको कुञ्जी। नयाँ कुञ्जी सिर्जना गर्नुहोस् र यसलाई पुनः पेस्ट गर्नुहोस्।

यो जडान हुन्छ, तर पछि केही असफल हुन्छ। कुञ्जीले प्रमाणीकरण त गर्छ तर यसमा कार्यका लागि आवश्यक अनुमति हुँदैन। माथि सूचीबद्ध अनुमतिहरूसहित नयाँ कुञ्जी सिर्जना गर्नुहोस्, त्यसपछि पुरानो जडान हटाउनुहोस् र नयाँ कुञ्जी जडान गर्नुहोस्।

जडान विच्छेद गर्दै

Integrations खोल्नुहोस्, खाता फेला पार्नुहोस् र Disconnect थिच्नुहोस्। यसले सेभ गरिएको कुञ्जी तुरुन्तै मेटाउँछ। यसको प्रयोग गरिरहेको जुनसुकै कुरा पनि यसको पछिल्लो कार्यमा रोकिन्छ, र यसमा निर्भर स्क्रिनहरूले मौन रूपमा असफल हुनुको सट्टा जानकारी गराउँछन्।

जडान विच्छेद गर्दा पहिले नै भइसकेका कार्यहरू पूर्ववत (undo) हुँदैनन् — तपाईंको खातामा हामीले परिवर्तन गरेका रेकर्डहरू, डिप्लोयमेन्टहरू वा सेटिङहरू जस्ताको तस्तै रहन्छन्। यदि तपाईंलाई कुञ्जी नै लीक भएको छ भन्ने लाग्छ भने, भेन्डरमा गएर पनि यसलाई रद्द गर्नुहोस्; जडान विच्छेद गर्नाले हाम्रो प्रतिलिपि हट्छ, उनीहरूको हट्दैन।