यसलाई जडान गर्दा तपाईँलाई हुने फाइदा
GitHub लाई टोकनमार्फत जडान गर्दा एउटा साइट तपाईँको कुनै एउटा रिपोजिटरीबाट डिप््लोय हुन सक्छ: शाखा (branch) मा पुश गर्नुहोस् र साइट अपडेट हुन्छ। यसले तपाईँले कुनै साइटको होस्टको रूपमा छनौट गर्नुभएको ठाउँमा तपाईँको खातामा GitHub Pages मा प्रकाशन गर्न पनि अनुमति दिन्छ।
यदि तपाईँका रिपोजिटरीहरू कुनै संस्था (organisation) सँग सम्बन्धित छन् भने, यसको सट्टा the Zinn® GitHub app लाई प्राथमिकता दिनुहोस् — Install the Zinn® GitHub app हेर्नुहोस्। एउटा टोकन एकै व्यक्तिसँग सम्बन्धित हुन्छ र तिनीहरू बाहिरिएपछि काम गर्न बन्द गर्छ।
तपाईँले सुरु गर्नु अघि
तपाईँले डिप््लोय गर्न चाहनुभएको रिपोजिटरीहरूमा पहुँच भएको GitHub खाता। यदि तिनीहरू कुनै संस्थासँग सम्बन्धित छन् भने, कुनै मालिक (owner) ले यसका लागि फाइन-ग्र्रेनड टोकनहरू (fine-grained tokens) अनुमोदन गर्नुपर्ने हुन सक्छ।
१. 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 थिच्नुहोस् र यसलाई प्रतिलिपि (copy) गर्नुहोस् — GitHub ले यसलाई एक पटक मात्र देखाउँछ।
२. यसलाई यहाँ जडान गर्नुहोस्
तपाईँको ड्यासबोर्डमा Integrations खोल्नुहोस् र Connect an account छनौट गर्नुहोस्। समूहको रूपमा Code hosting र खाताको रूपमा GitHub छान्नुहोस्, API token भर्नुहोस्, र Connect account थिच्नुहोस्।
कुनै पनि कुरा सेभ हुनुभन्दा अघि हामी तपाईँले टाँस्नुभएको (paste) कुराको परीक्षण गर्छौं। काम नगर्ने कुराको कुञ्जी कहिल्यै पनि भण्डारण गरिँदैन, र प्रतिक्रियामा यसमा के गल्ती थियो भनी देखाइन्छ। काम गर्ने कुञ्जी हाम्रो सेक्रेट्स भाल्टमा (secrets vault) — हाम्रो डेटाबेसमा कहिल्यै होइन — ईन्क्रिप्टेड रूपमा राखिन्छ र यसलाई फेरि कहिल्यै देखाइँदैन, तपाईँलाई पनि देखाइँदैन।
त्यसपछि के हुन्छ
- एउटा साइट यस खाताको रिपोजिटरीबाट सिधै डिप््लोय हुन सक्छ: साइटको रिपोजिटरी जडानमा यसलाई छनौट गर्नुहोस्, रिपोजिटरी र शाखा (branch) छान्नुहोस्, र पुश गर्दा डिप््लोय हुन्छ।
- अन्य प्रत्येक शाखाले यसको आफ्नै प्रिभ्यु प्राप्त गर्न सक्छ, त्यसैले लाइभ साइटमा पुग्नु अघि तपाईँले परिवर्तन जाँच गर्न सक्नुहुन्छ।
- Render र Azure Static Web Apps जस्ता Git-निर्मित स्ट्याटिक होस्टहरूले यस जडानलाई साइटको कोडको स्रोतको रूपमा प्रयोग गर्छन्।
यदि यो जडान भएन भने
कुनै रिपोजिटरी देखिँदैन। टोकनको रिपोजिटरी पहुँचले यसलाई समावेश गर्दैन। GitHub मा टोकन सम्पादन गर्नुहोस् र रिपोजिटरी थप्नुहोस्।
यो काम गर्यो र त्यसपछि बन्द भयो। फाइन-ग्र्रेनड टोकनहरूको म्याद तपाईँले छनौट गर्नुभएको मितिमा समाप्त हुन्छ। नयाँ सिर्जना गर्नुहोस् र यसलाई जडान गर्नुहोस्; टोकनको म्याद समाप्त हुनु अघि GitHub ले तपाईँलाई इमेल पठाउँछ।
कुञ्जी अस्वीकार गरियो भनी देखाउँछ। प्रायः यी तीनवटा कुरामध्ये एउटा हुन्छ: यससँगै प्रतिलिपि भएको खाली ठाउँ (space) वा लाइन ब्रेक, म्याद समाप्त भएको कुञ्जी, वा तपाईँले प्रतिलिपि गरेपछि रद्द गरिएको वा पुन: उत्पन्न गरिएको (regenerated) कुञ्जी। नयाँ सिर्जना गर्नुहोस् र यसलाई फेरि टाँस्नुहोस्।
यो जडान हुन्छ, तर पछि केहि असफल हुन्छ। कुञ्जी प्रमाणित हुन्छ तर कार्यलाई आवश्यक पर्ने अनुमति हुँदैन। माथि सूचीबद्ध अनुमतिहरूसँग नयाँ कुञ्जी सिर्जना गर्नुहोस्, त्यसपछि पुरानो जडान विच्छेद गर्नुहोस् र नयाँ कुञ्जी जडान गर्नुहोस्।
जडान विच्छेद गर्दै
Integrations खोल्नुहोस्, खाता फेला पार्नुहोस् र Disconnect थिच्नुहोस्। यसले भण्डारण गरिएको कुञ्जी तुरुन्तै मेटाउँछ। यसलाई प्रयोग गरिरहेको कुनै पनि कुरा यसको अर्को कार्यमा बन्द हुन्छ, र यसमा भर पर्ने स्क्रिनहरू चुपचाप असफल हुनुको सट्टा त्यस्तै भनी देखाउँछन्।
जडान विच्छेद गर्दा पहिले गरिसकेका कामहरू पूर्ववत् हुँदैनन् — हामीले तपाईँको खातामा परिवर्तन गरेका रेकर्डहरू, डिप््लोइमेन्टहरू वा सेटिङहरू जस्ताको तस्तै रहन्छन्। यदि तपाईँलाई कुञ्जी आफैँ लीक भएको हुन सक्छ जस्तो लाग्छ भने, विक्रेता (vendor) सँग यसलाई रद्द (revoke) पनि गर्नुहोस्; जडान विच्छेद गर्दा हाम्रो प्रतिलिपि हट्छ, उनीहरूको होइन।