GitLab इंटीग्रेशन के साथ आप मर्ज रिक्वेस्ट, पाइपलाइन, एनवायरनमेंट और कमिट सीधे FeatValue में अपने कार्यों पर देखते हैं। आपके क्लाइंट आसान शब्दों में जानते हैं कि उनके बदलाव पर काम जारी है, वह टेस्ट के लिए staging पर है या लाइव है।
GitLab इंटीग्रेशन किसलिए है
सॉफ़्टवेयर कंपनियों और वेब एजेंसियों से बार बार एक ही सवाल पूछा जाता है: “क्या यह ऑनलाइन हो गया?” इंटीग्रेशन के साथ FeatValue इसका जवाब कार्य पर देता है:
- कार्य की ID वाली ब्रांच, कमिट और मर्ज रिक्वेस्ट सही कार्य पर दिखते हैं।
- पाइपलाइन और डिप्लॉयमेंट दिखाते हैं कि बदलाव टेस्ट हुआ है या नहीं और वह किस एनवायरनमेंट तक पहुँचा है।
- FeatValue महत्वपूर्ण चरणों को टिप्पणी के रूप में कार्य के इतिहास में लिखता है।
- हर प्रोजेक्ट के लिए आप तय करते हैं कि आपके क्लाइंट इसमें से क्या देखें।
- आप मैनुअल जॉब, जैसे डिप्लॉयमेंट, सीधे FeatValue से शुरू करते हैं।
अवलोकन के लिए GitLab इंटीग्रेशन का पेज देखें।
आवश्यकताएँ
- आपकी कंपनी का FeatValue खाता, जिसमें कम से कम एक क्लाइंट और प्रोजेक्ट हो (देखें परियोजनाएँ बनाना)
- gitlab.com पर या अपने इंस्टेंस के रूप में GitLab, जो https से पहुँच योग्य हो
- जिन GitLab प्रोजेक्ट को आप जोड़ना चाहते हैं, उनमें कम से कम Maintainer भूमिका। इससे FeatValue वेबहुक बना सकता है।
GitLab जोड़ें
-
ऐप खोलें
बाईं साइडबार में
अनुप्रयोग पर क्लिक करें,
GitLab चुनें और
इंस्टॉल करें पर क्लिक करें (देखें
अनुप्रयोग जोड़ें)।
GitLab जोड़ें पेज खुलता है, जिसमें सवाल होता है
आपका GitLab कहाँ है?
-
gitlab.com
gitlab.com चुनें और आगे पर क्लिक करें। GitLab में साइन इन करें और पहुँच की अनुमति दें। इससे FeatValue को आपके प्रोजेक्ट तक पहुँच मिलती है।
-
अपना GitLab इंस्टेंस
अपना GitLab इंस्टेंस चुनें। इंस्टेंस का पता में https पता दर्ज करें, जैसे https://gitlab.example.com, और Personal access token में एक टोकन। आगे पर क्लिक करें।
अपने इंस्टेंस के लिए मुझे कौन सा टोकन चाहिए?
टोकन GitLab में Preferences › Access tokens में बनाएँ:
- स्कोप (Scopes):
api। read_api जैसे केवल पढ़ने वाले स्कोप काफ़ी नहीं हैं, क्योंकि FeatValue वेबहुक बनाता है और मैनुअल जॉब शुरू करता है।
- भूमिका (Role): टोकन वाले उपयोगकर्ता को प्रोजेक्ट में कम से कम Maintainer भूमिका चाहिए।
- समाप्ति तिथि (Expiration date): टोकन की अवधि खत्म होते ही नया डेटा आना बंद हो जाता है। नया टोकन बनाएँ और GitLab को फिर से जोड़ें।
बेहतर है कि इंटीग्रेशन के लिए एक अलग उपयोगकर्ता या ग्रुप टोकन इस्तेमाल करें। इस तरह यह किसी एक व्यक्ति के खाते पर निर्भर नहीं रहता।
रिपॉज़िटरी को प्रोजेक्ट से जोड़ें
हर रिपॉज़िटरी ठीक एक FeatValue प्रोजेक्ट से जुड़ी होती है। केवल जुड़ी हुई रिपॉज़िटरी FeatValue तक पहुँचती हैं।
-
रिपॉज़िटरी जोड़ें खोलें
-
रिपॉज़िटरी खोजें
आपकी रिपॉज़िटरी GitLab में रिपॉज़िटरी के तहत सूचीबद्ध हैं। सूची छोटी करने के लिए रिपॉज़िटरी खोजें का इस्तेमाल करें।
-
प्रोजेक्ट चुनें और जोड़ें
रिपॉज़िटरी के बगल में FeatValue प्रोजेक्ट चुनें और जोड़ें पर क्लिक करें। FeatValue GitLab में एक वेबहुक बनाता है और पिछले कुछ दिनों का डेटा भी ले आता है।
सभी कनेक्शन जुड़ी रिपॉज़िटरी के तहत सूचीबद्ध हैं। कॉलम अपडेट में वेबहुक से तुरंत या हर 10 मिनट दिखता है। बदलें से आप दूसरा प्रोजेक्ट चुनते हैं, और अलग करें से कनेक्शन हटाते हैं; तब FeatValue वेबहुक भी हटा देता है।
कार्य की ID का सही इस्तेमाल
FeatValue में हर कार्य की एक ID होती है, जैसे abc123-4। यह आपको कार्य पर मिलती है। यह ID इनमें से किसी एक जगह लिखें:
| कहाँ |
उदाहरण |
| ब्रांच नाम |
abc123-4-contact-form |
| कमिट मैसेज |
abc123-4 Make phone number required |
| मर्ज रिक्वेस्ट का शीर्षक या विवरण |
Contact form: make phone number required (abc123-4) |
- बड़े और छोटे अक्षरों से फ़र्क नहीं पड़ता, और शुरुआत में
# लिखा जा सकता है।
- अगर ID ब्रांच नाम में है, तो केवल वे कमिट गिने जाते हैं जो सिर्फ़ इसी ब्रांच पर हैं। ब्रांच बनाते समय डिफ़ॉल्ट ब्रांच से साथ आए कमिट कार्य पर नहीं दिखते।
- दूसरी ब्रांच के कमिट तभी दिखते हैं जब ID उनके कमिट मैसेज में हो।
- ID केवल जुड़े हुए प्रोजेक्ट के भीतर लागू होती है। जो रिपॉज़िटरी किसी दूसरे प्रोजेक्ट से जुड़ी हैं या बिल्कुल नहीं जुड़ी हैं, उन्हें FeatValue कभी इस कार्य से नहीं जोड़ता।
- पाइपलाइन और डिप्लॉयमेंट उस कार्य के होते हैं, अगर वे उसकी किसी ब्रांच, कमिट या मर्ज रिक्वेस्ट के लिए चलते हैं।
कार्य पर क्या दिखता है
कार्य पर डेवलपमेंट सेक्शन एक छोटी पंक्ति के साथ दिखता है, जैसे: MR !12 मर्ज हुआ · पाइपलाइन सफल · Staging पर रोल आउट हुआ। खोलने के लिए विवरण दिखाएँ पर क्लिक करें:
- स्टेज, जॉब और उनकी स्थिति के साथ पाइपलाइन
- खोलने के लिंक के साथ एनवायरनमेंट, जैसे Staging और Production
- मर्ज रिक्वेस्ट, ब्रांच और कमिट
प्रोजेक्ट में क्या दिखता है
प्रोजेक्ट में डेवलपमेंट सेक्शन एनवायरनमेंट को उनके नवीनतम डिप्लॉयमेंट के साथ और डिफ़ॉल्ट ब्रांच की नवीनतम पाइपलाइन दिखाता है। नवीनतम पाइपलाइन देखने के लिए सभी पाइपलाइन दिखाएँ पर क्लिक करें। यहीं आपको प्रोजेक्ट की सेटिंग्स भी मिलती हैं।
क्लाइंट क्या देखते हैं?
प्रोजेक्ट में डेवलपमेंट सेक्शन की सेटिंग्स में क्लाइंट क्या देखते हैं? के तहत चुनें:
| सेटिंग |
आपका क्लाइंट देखता है |
| कुछ नहीं |
GitLab की कोई जानकारी नहीं |
| सरल स्थिति |
तकनीकी शब्दों के बिना एक वाक्य: काम जारी है, लिंक यहाँ टेस्ट करें के साथ Staging पर रोल आउट हुआ, या लिंक अभी देखें के साथ लाइव |
| विवरण |
वे सेक्शन जिन्हें आप क्लाइंट के लिए विवरण में चुनते हैं: कमिट, ब्रांच, मर्ज रिक्वेस्ट, पाइपलाइन, एनवायरनमेंट और इतिहास टिप्पणियाँ |
आपकी कंपनी के जो लोग प्रोजेक्ट संपादित कर सकते हैं, वे यह सेटिंग बदल सकते हैं। इसके बाद आपका क्लाइंट कैसे टेस्ट और स्वीकृत करता है, यह समीक्षा और स्वीकृति में बताया गया है।
इतिहास टिप्पणियाँ सेट करना
FeatValue महत्वपूर्ण चरणों को टिप्पणी के रूप में कार्य के इतिहास में लिखता है। टास्क पर इतिहास टिप्पणियाँ में आप हर प्रोजेक्ट के लिए चुनते हैं कि किन इवेंट पर टिप्पणी बने:
- मर्ज रिक्वेस्ट मर्ज हुआ
- पाइपलाइन सफल
- पाइपलाइन विफल (विफल जॉब के साथ)
- एनवायरनमेंट पर डिप्लॉय हुआ
अचयनित इवेंट कार्य पर स्थिति अपडेट करते रहते हैं, पर टिप्पणी नहीं बनाते। आपका क्लाइंट टिप्पणियाँ देखता है या नहीं, यह क्लाइंट क्या देखते हैं? की सेटिंग पर निर्भर करता है।
FeatValue से जॉब चलाएँ
Starter
आप अपनी पाइपलाइन के मैनुअल जॉब, जैसे deploy-production, सीधे FeatValue में शुरू करते हैं। यह Starter प्लान से उपलब्ध है (देखें प्लान)।
-
जॉब की अनुमति दें
प्रोजेक्ट में डेवलपमेंट सेक्शन की सेटिंग्स खोलें। FeatValue से जॉब चलाएँ में आपको वे मैनुअल जॉब मिलते हैं जिनकी जानकारी GitLab अब तक दे चुका है। जो जॉब FeatValue में दिखने चाहिए, उन्हें चुनें और सहेजें पर क्लिक करें।
-
क्लाइंट के लिए भी
अगर आपका क्लाइंट भी चुने गए जॉब शुरू कर सके, तो क्लाइंट भी चुने गए जॉब चला सकते हैं चुनें।
-
जॉब चलाएँ
जब कोई अनुमत जॉब मैनुअल शुरुआत की प्रतीक्षा में होता है, तो वह चलाएँ बटन के साथ दिखता है। क्लिक के बाद FeatValue शुरू हुआ दिखाता है, और आगे की प्रगति आप पाइपलाइन पर देखते हैं।
अगर अभी तक कोई मैनुअल जॉब नहीं मिला। लिखा है, तो अभी तक मैनुअल जॉब वाली कोई पाइपलाइन नहीं चली है। जैसे ही GitLab किसी जॉब की जानकारी देता है, आप उसकी अनुमति दे सकते हैं।
सुरक्षा
- केवल जुड़ी हुई रिपॉज़िटरी: FeatValue केवल वही रिपॉज़िटरी पढ़ता है जिन्हें आपने किसी प्रोजेक्ट से जोड़ा है, और कार्य की ID केवल उसी प्रोजेक्ट के भीतर जोड़ता है।
- कोई कोड नहीं: FeatValue आपकी रिपॉज़िटरी की फ़ाइलें सेव नहीं करता, केवल ब्रांच, कमिट, मर्ज रिक्वेस्ट, पाइपलाइन और एनवायरनमेंट की जानकारी।
- सत्यापित वेबहुक: हर वेबहुक को अपना गुप्त टोकन मिलता है। FeatValue केवल वही कॉल स्वीकार करता है जो यह टोकन भेजती हैं।
- GitLab में आपके अधिकार: FeatValue साइन इन या टोकन के अधिकारों के साथ काम करता है। यह केवल वही जॉब शुरू कर सकता है जिनकी आपने अनुमति दी है।
- कभी भी अलग करें: अलग करें कनेक्शन हटाता है, और FeatValue वेबहुक हटा देता है।
समस्या निवारण
मेरी रिपॉज़िटरी सूची में नहीं है
FeatValue केवल वे रिपॉज़िटरी दिखाता है जिनमें आपकी कम से कम Maintainer भूमिका है। GitLab में अपनी भूमिका जाँचें या रिपॉज़िटरी खोजें से नाम खोजें।
वेबहुक नहीं बन सका
तब कनेक्शन पर वेबहुक से तुरंत की जगह हर 10 मिनट दिखता है। इस स्थिति में FeatValue हर 10 मिनट में GitLab जाँचता है, इसलिए कुछ नहीं छूटता, बस थोड़ी देर से आता है। आम कारण: आपके पास Maintainer भूमिका नहीं है, या आपका GitLab इंस्टेंस इंटरनेट पर अनुरोध नहीं भेज सकता। इसे जाँचें, फिर बदलें और दोबारा जोड़ें पर क्लिक करें।
कार्य पर कुछ नहीं दिखता
- क्या रिपॉज़िटरी उसी प्रोजेक्ट से जुड़ी है जिसका यह कार्य है?
- क्या कार्य की पूरी ID ब्रांच नाम, कमिट मैसेज या मर्ज रिक्वेस्ट में है?
- वेबहुक के बिना नया डेटा आने में 10 मिनट तक लगते हैं।
GitLab ने टोकन स्वीकार नहीं किया
इंस्टेंस का पता, टोकन और स्कोप api जाँचें। टोकन की अवधि खत्म नहीं होनी चाहिए।
कोई जॉब शुरू नहीं हो पा रहा
जॉब चलाना Starter प्लान से उपलब्ध है। साथ ही जॉब की प्रोजेक्ट सेटिंग्स में अनुमति होनी चाहिए और वह इस समय मैनुअल शुरुआत की प्रतीक्षा में होना चाहिए। अगर शुरू नहीं हो सका दिखे, तो GitLab में जाँचें कि साइन इन को अब भी जॉब शुरू करने की अनुमति है या नहीं।