GitLab रिपॉजिटरी में धकेलने पर शेल रनर पर जावा प्रोजेक्ट कैसे चलाया जाता है

मेरा नाम इवान सिदोरेंको है, मैं डिजिटल डिजाइन में एक परीक्षण इंजीनियर हूं। मेरा काम जावा सेलेनियम में लिखे ऑटोटेस्ट के लॉन्च को लागू करना था।

मैं CI / CD में नया हूं, इसलिए मैं बहुत सारी समस्याओं में भाग गया। मुझे इस कार्य के लिए इंटरनेट पर विस्तृत निर्देश नहीं मिले, इसलिए, मैंने अपने डेवलपर्स की मदद से इसका पता लगाने के बाद, मैंने अपने जैसे शुरुआती लोगों के लिए एक मैनुअल लिखने का फैसला किया।

मैंने GitLab का उपयोग करके CI / CD को कॉन्फ़िगर करने के लिए सभी आवश्यक चरणों का विस्तार से वर्णन किया है, उदाहरण के लिए, जावा का उपयोग करके लिखा गया एक सरल HelloWorld प्रोग्राम चलाना।



ऑटोटेस्ट्स को हर बार एक डेवलपर को गिटलैब रिपॉजिटरी में परिवर्तन को धकेलना चाहिए। यह कार्य सीआई / सीडी के सिद्धांतों में से एक से मेल खाता है - उत्पाद विकास के प्रत्येक चरण में ऑटोटेस्ट्स का शुभारंभ। मैं इस मैनुअल में पूर्ण सीआई / सीडी अवधारणा का वर्णन नहीं करूंगा - यह जानकारी इंटरनेट पर ढूंढना आसान है।

लेकिन सभी आवश्यक कदमों के विवरण के साथ शुरुआती के लिए जीआईटीलैब का उपयोग करके सीआई / सीडी को कॉन्फ़िगर करने का तरीका नहीं पता है। इस पर नीचे चर्चा की जाएगी।

1. Git स्थापित करें और GitLab रिपॉजिटरी तक पहुंच प्राप्त करें

मैंने रिमोट मशीन पर परियोजना शुरू करने के लिए आवश्यक सभी चीजों को तैनात किया, लेकिन चूंकि इस मैनुअल का उद्देश्य सीआई / सीडी को तैनात करने की मूल बातें से खुद को परिचित करना है, इसलिए हम स्थानीय मशीन पर काम करेंगे।

दिखाई देने वाली विंडो में प्रोजेक्ट पेज पर GitLab पर जाएं, नया प्रोजेक्ट बटन पर क्लिक करें


प्रोजेक्ट का नाम सेट करें, दृश्यता प्रोजेक्ट फ़ील्ड में निजी मान सेट करें और ग्रीन क्रिएट प्रोजेक्ट बटन पर क्लिक करें।



बधाई हो, GitLab में परियोजना बनाई गई है।



अब हमें स्थानीय रिपॉजिटरी को तैनात करने की आवश्यकता है जिससे हम परिवर्तन को गिटलैब में धकेलेंगे। ऐसा करने के लिए, आपको पहले Git को स्थापित करना होगा, स्थापना के दौरान आप सभी डिफ़ॉल्ट मानों का चयन कर सकते हैं। यदि गिट और इसकी स्थापना के साथ कोई अनुभव नहीं था, तो मैं सुझाव देता हूं कि आप www.youtube.com पर इस कोर्स से परिचित हों।

अब आपको Git पर्यावरण चर को user.name और user.email को कॉन्फ़िगर करने की आवश्यकता है। हम GitLab -> प्रोजेक्ट / विवरण पृष्ठ से मान लेते हैं (जैसे ही हम परियोजना बनाते हैं, हमें यह पृष्ठ मिलता है)।

git config --global user.name "user name" git config --global user.email "email@examle.com" 

Git Bash खोलें, इसे करने के लिए, डेस्कटॉप पर कहीं भी क्लिक करें और Git Bash Here चुनें। अब हम इन दोनों आदेशों को क्रमिक रूप से दर्ज करते हैं।

उसके बाद, आपको एक स्थानीय रिपॉजिटरी बनाने की आवश्यकता है, जहां से हम गिटलैब के सभी परिवर्तनों को आगे बढ़ाएंगे। ऐसा करने के लिए, स्थानीय मशीन पर एक फ़ोल्डर बनाएं, उस पर जाएं, गिट बैश खोलें और इन आदेशों को क्रमिक रूप से निष्पादित करें (वे GitLab -> प्रोजेक्ट / विवरण पृष्ठ पर भी उपलब्ध हैं)।

git init
git remote add origin git init
git remote add origin यहाँ अपनी परियोजना के लिए पथ निर्दिष्ट करें

अब हमारे दूरस्थ भंडार को जोड़ दिया गया है। लेकिन इससे पहले कि आप गिटलैब रिपॉजिटरी में बदलावों को आगे बढ़ाएं, आपको एसएसएच कीज़ को कॉन्फ़िगर करना होगा।

2. SSH कुंजी को कॉन्फ़िगर करना

SSH प्रोटोकॉल के माध्यम से मुख्य git रिपॉजिटरी में दूरस्थ रिपॉजिटरी से सुरक्षित डेटा ट्रांसफर के लिए SSH कीज़ की आवश्यकता होती है। एक प्रमुख जोड़ी बनाएं।

गेट बैश खोलें और दर्ज करें:

 ssh-keygen -o -t rsa -b 4096 -C email@example.com 

Email@example.com के बजाय हम आपके ईमेल को प्रतिस्थापित करते हैं।

आगे हमें एक संदेश मिलता है जहां कुंजियाँ संग्रहीत की जाएंगी। यहाँ हम सिर्फ Enter दबाते हैं। प्रपत्र के फ़ोल्डर में कुंजियों को सहेजा जाएगा:

 C:\Users\User_name\.ssh 

एक फ़ोल्डर चुनने के बाद, हमें कुंजियों के लिए एक पासवर्ड दर्ज करने के लिए कहा जाएगा, आप इस चरण को एंटर को दो बार दबाकर छोड़ सकते हैं।

अब आपको अपने GitLab खाते में सार्वजनिक कुंजी जोड़ने की आवश्यकता है। .Ssh फ़ोल्डर में जाएं और नोटपैड के साथ आईडी _rsa.pub आईडी फ़ाइल खोलें। फ़ाइल की सामग्री की प्रतिलिपि बनाएँ और GitLab पर जाएँ। यहां आपको उपयोगकर्ता सेटिंग्स पर जाने की आवश्यकता है (ऊपरी दाएं बटन पर क्लिक करें और सेटिंग्स का चयन करें)।



SSH कुंजी अनुभाग पर जाएँ।

कुंजी फ़ील्ड में सार्वजनिक कुंजी डालें और कुंजी बटन जोड़ें पर क्लिक करें।



अब आपको रिमोट मशीन पर निजी कुंजी को सहेजने की आवश्यकता है। ऐसा करने के लिए, कमांड निष्पादित करें:

 ssh-agent bash ssh-add ~/.ssh/key 

जहां कुंजी उत्पन्न निजी कुंजी ("id_rsa" नाम की फ़ाइल है)
ssh-agent सार्वजनिक कुंजी के साथ प्रमाणीकरण के लिए उपयोग की जाने वाली निजी कुंजी संग्रहीत करने का एक कार्यक्रम है (हमारे मामले में, यह एक आरएसए कुंजी है)।

अब आप GitLab में फ़ाइलों को पुश करने के लिए तैयार हैं। जांचें कि क्या सब कुछ काम करता है। उस रिपॉजिटरी में जाएं जिसे पहले इनिशियलाइज़ किया गया था। इसमें खाली txt फ़ाइल जोड़ें। उसके बाद, हम Git Bash में क्रमिक रूप से इन कमांड्स को निष्पादित करते हैं।

 git add . git commit -m "Initial commit" git push -u origin master 

प्रोजेक्ट / विवरण पृष्ठ पर GitLab पर जाएं और सत्यापित करें कि सब कुछ ठीक काम कर रहा है।

3. गिटलैब रनर (शेल) बनाना

गिटलैब पर जोर देते समय परियोजनाएं शुरू करने के लिए, हमें एक धावक को तैनात करना होगा। GitLab Runner एक विशेष .gitlab-ci.yml फ़ाइल से निर्देश चलाने के लिए एक एजेंट है। धावक कई प्रकार के होते हैं। एक शेल रनर - सबसे सरल में से एक को स्थापित करने और लॉन्च करने पर विचार करें।

शेल-रनर आपको उस मशीन पर प्रोजेक्ट चलाने की अनुमति देता है जहां यह रनर स्थापित है। हमारे स्थानीय मशीन पर इस धावक को स्थापित करने पर विचार करें:

1. धावक के लिए एक फ़ोल्डर बनाएँ, उदाहरण के लिए C: \ GitLab-Runner

2. लिंक से रनर डाउनलोड करें:
https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-windows-386.exe
इसे gitlab-runner.exe का नाम दें।

3. व्यवस्थापक के रूप में PowerShell चलाएँ।

4. हमारे फ़ोल्डर में जाएं:

 cd C:\GitLab-Runner 

5. GitLab का लिंक दर्ज करें। GitLab में Settings-> CI / CD-> Runers पर जाएं।



6. टोकन दर्ज करें:



7. धावक का विवरण दर्ज करें।

8. धावक के लिए टैग दर्ज करें।

9. रनर का प्रकार चुनें - शेल।

10. धावक स्थापित करें:

 gitlab-runner install 

11. और चलाएं:

 gitlab-runner start 

यह सत्यापित करने के लिए कि धावक शुरू हो गया है, GitLab -> सेटिंग्स -> CI / CD -> धावक पर जाएँ। ग्रीन सर्कल का मतलब है कि धावक चल रहा है।

4. पर्यावरण चर सेट करना

हमारे जावा प्रोग्राम को चलाने के लिए, हमें चाहिए:

1. जावा स्थापित करें:
https://java.com/ru/download/

2. jdk स्थापित करें: https://www.oracle.com/technetwork/java/javase/downloads/index.html

3. पर्यावरण चर सेट करें।

पर्यावरण चर को कॉन्फ़िगर करने के लिए, यहां जाएं:
मेरा कंप्यूटर -> गुण -> उन्नत पर्यावरण सेटिंग्स -> पर्यावरण चर
यहां, "सिस्टम वेरिएबल्स" अनुभाग में, JAVA_HOME वैरिएबल बनाएं, "वैरिएबल वैल्यू" लाइन में jdk का पथ लिखें।



इस मान को पथ चर में जोड़ें। आपको यह भी सत्यापित करना होगा कि जावा के लिए एक रास्ता है।

5. परियोजना का निर्माण और इसकी शुरूआत

चलो एक सरल जावा परियोजना बनाएं जो "हैलो वर्ल्ड!" कंसोल में। इसे हमारे स्थानीय भंडार में रखें। यह कुछ इस तरह दिखेगा:



यहाँ मैंने yml एक्सटेंशन के साथ .itlab-ci फ़ाइल बनाई।


इसके दो चरण हैं - बिल्ड और एक्सक्यूट। Javac कमांड का उपयोग करते हुए, हम स्रोत कोड को संकलित करते हैं, और java कमांड का उपयोग करते हुए, हम इसे चलाते हैं। प्रत्येक चरण में, हमें स्पष्ट रूप से इंगित करना चाहिए कि हम किस धावक का उपयोग करेंगे। रनर को उसके टैग के मान से निर्धारित किया जाएगा (आप इसे GitLab में रनर सेटिंग्स में देख सकते हैं)।

फ़ाइल की सामग्री सेट करने के बाद, स्थानीय रिपॉजिटरी में जाएं और गिट बैश खोलें। हम क्रमिक रूप से आदेशों को निष्पादित करना शुरू करते हैं:

 git add . git commit -m "Initial commit" git push -u origin master 

परिवर्तन शुरू हो गए हैं, अब हम सत्यापित करेंगे कि हमारा कार्यक्रम सफलतापूर्वक पूरा हो गया है। GitLab -> CI / CD -> नौकरी पर जाएं, अंतिम नौकरी खोलें:



कार्यक्रम पूरा हो गया है, आप महान हैं!