इसका परीक्षण करें: हम यह निर्धारित करते हैं कि पुल अनुरोध जांच पर कौन से परीक्षण चलते हैं

नमस्कार, हेब्र! मेरा नाम Egor Danilenko है। मैं Sberbank Business Online के कॉर्पोरेट इंटरनेट बैंकिंग के लिए एक डिजिटल प्लेटफ़ॉर्म विकसित कर रहा हूं, और आज मैं आपको हमारे द्वारा अपनाई गई CI विकास प्रक्रिया के बारे में बताना चाहता हूं।

डेवलपर परिवर्तन रिलीज़ शाखा में एक जलसेक कैसे आते हैं? डेवलपर स्थानीय रूप से परिवर्तन करता है और हमारे संस्करण नियंत्रण प्रणाली में धकेलता है। हम एक लेखक के प्लगइन के साथ बिटबकेट का उपयोग करते हैं (हमने इस प्लगइन के बारे में यहां पहले लिखा था)। इन परिवर्तनों पर, विधानसभा लॉन्च की जाती है और परीक्षण का पीछा किया जाता है (इकाई, एकीकरण, कार्यात्मक)। यदि असेंबली विफल नहीं हुई और सभी परीक्षण सफलतापूर्वक पारित हो गए, साथ ही एक सफल समीक्षा के बाद, पुल अनुरोध को मुख्य शाखा में डाला गया।

लेकिन समय के साथ, टीमों की संख्या बढ़ी है। परीक्षणों की संख्या आनुपातिक रूप से बढ़ी है। हम समझ गए कि इस तरह की कई टीमें "धीमी पुल-अनुरोध-जांच" समस्या की शुरुआत में तेजी लाएंगी, और उत्पाद विकसित करना असंभव हो जाएगा। वर्तमान में, हमारे पास लगभग 40 टीमें हैं। नई विशेषताओं के साथ, वे नए परीक्षण लाते हैं, जिन्हें पुल अनुरोधों पर भी चलाने की आवश्यकता होती है।

हमने सोचा कि अगर हम जानते हैं कि किसी विशेष कोड को बदलने के लिए कौन से परीक्षण चलाने हैं तो यह अच्छा होगा।

और इस तरह हमने इस समस्या को हल किया।

समस्या का बयान

परीक्षणों के साथ एक परियोजना है, और हम यह निर्धारित करना चाहते हैं कि एक निश्चित फ़ाइल "छुआ" होने पर किन परीक्षणों को चलाने की आवश्यकता है।

हम सभी EclEmma JaCoCo कोड कवरेज लाइब्रेरी के बारे में जानते हैं। हमने इसे आधार के रूप में लिया।

JaCoCo के बारे में थोड़ा

JaCoCo परीक्षणों के साथ कोड कवरेज को मापने के लिए एक पुस्तकालय है। काम कोड बाइट्स के विश्लेषण पर आधारित है। एजेंट निष्पादन जानकारी एकत्र करता है और जेवीएम के अनुरोध या शटडाउन पर अपलोड करता है।

डेटा संग्रह के तीन तरीके हैं:

1. फाइल सिस्टम: JVM को रोकने के बाद, डेटा एक फाइल को लिखा जाएगा।
2. टीसीपी सॉकेट सर्वर: आप बाहरी उपकरणों को जेवीएम से जोड़ सकते हैं और सॉकेट के माध्यम से डेटा प्राप्त कर सकते हैं।
3. TCP सॉकेट क्लाइंट: लॉन्च होने पर, JaCoCo एजेंट एक विशिष्ट TCP समापन बिंदु से जुड़ता है।

हमने दूसरा विकल्प चुना है।

निर्णय

आपको JaCoCo एजेंट के साथ एप्लिकेशन और परीक्षण चलाने की क्षमता का एहसास होना चाहिए।

सबसे पहले, हम JaCoCo एजेंट के साथ परीक्षण चलाने की क्षमता को जोड़ने के लिए जोड़ते हैं।

जावा एजेंट शुरू किया जा सकता है:

-javaagent:[yourpath/]jacocoagent.jar=[option1]=[value1],[option2]=[value2] 

हमारी परियोजना के लिए एक निर्भरता जोड़ें:

 dependencies { compile 'org.jacoco:org.jacoco.agent:0.8.0' } 

हमें केवल आँकड़े एकत्र करने के लिए एजेंट के साथ शुरुआत करने की आवश्यकता है, इसलिए हम डिफ़ॉल्ट मूल्य के साथ withJacoco ध्वज को जोड़ते हैं, जोकि gradle.properties के लिए डिफ़ॉल्ट मान है। हम उस निर्देशिका को भी निर्दिष्ट करते हैं जहां आँकड़े, पता और पोर्ट एकत्र किए जाएंगे।

परीक्षण लॉन्च कार्य के लिए एजेंट के साथ jvm तर्क जोड़ें:

 if (withJacoco.toBoolean()) { … jvmArgs "-javaagent:${tempPath}=${jacocoArgs.join(',')}".toString() } 

अब, परीक्षण के प्रत्येक सफल समापन के बाद, हमें JaCoCo के साथ आंकड़े एकत्र करने की आवश्यकता है। ऐसा करने के लिए, TestNG श्रोता लिखें।

 public class JacocoCoverageTestNGListener implements ITestListener { private static final IntegrationTestsCoverageReporter reporter = new IntegrationTestsCoverageReporter(); private static final String TEST_NAME_PATTERN = "%s.%s"; @Override public void onTestStart(ITestResult result) { reporter.resetCoverageDumpers(String.format(TEST_NAME_PATTERN, result.getInstanceName(), result.getMethod().getMethodName())); } @Override public void onTestSuccess(ITestResult result) { reporter.report(String.format(TEST_NAME_PATTERN, result.getInstanceName(), result.getMethod().getMethodName())); } } 

Testng.xml में एक श्रोता जोड़ें और इसे टिप्पणी दें, क्योंकि हमें सामान्य परीक्षण चलाने में इसकी आवश्यकता नहीं है।

अब हमारे पास JaCoCo एजेंट के साथ परीक्षण चलाने का अवसर है, प्रत्येक सफल परीक्षण के आँकड़े एकत्र किए जाएंगे।

आंकड़ों को इकट्ठा करने के लिए रिपोर्टर को कैसे लागू किया जाता है, इसके बारे में थोड़ा और।
रिपोर्टर आरंभीकरण के दौरान, एजेंटों के लिए एक कनेक्शन बनाया जाता है, एक निर्देशिका बनाई जाती है जहां आंकड़े संग्रहीत किए जाएंगे, और आंकड़े एकत्र किए जाएंगे।

रिपोर्ट विधि जोड़ें:

 public void report(String test) { reportClassFiles(test); reportResources(test); } 

ReportClassFile विधि आँकड़ों के डायरेक्टरी में jvm फोल्डर बनाती है, जिसमें क्लास फाइल्स द्वारा एकत्रित आँकड़ों को संग्रहित किया जाता है।

ReportResource विधि संसाधन फ़ोल्डर बनाता है, जो संसाधनों पर एकत्रित आँकड़ों को संग्रहीत करता है (सभी गैर-वर्ग फ़ाइलों के लिए)।

रिपोर्ट में एजेंट से जुड़ने, सॉकेट से डेटा पढ़ने और फ़ाइल में लिखने के सभी तर्क शामिल हैं। JaCoCo द्वारा प्रदान किए गए औजारों जैसे कि org.jacoco.core.runtime.emoteControlReader / RemoteControlWriter द्वारा कार्यान्वित किया गया।

ReportClassFiles और reportResources फ़ंक्शन सामान्य डंपटॉयल फ़ंक्शन का उपयोग करते हैं।

 public void dumpToFile(File file) { try (Writer fileWriter = new BufferedWriter(new FileWriter(file))) { for (RemoteControlReader remoteControlReader : remoteControlReaders) { remoteControleReader.setExecutionDataVisitor(new IExecutionDataVisitor() { @Override public void visitClassExecution(ExecutionData data) { if (data.hasHits()) { String name = data.getName(); try { fileWriter.write(name); fileWriter.write('\n'); } catch (IOException e) { throw new RuntimeException(e); } } } }); } } } 

फ़ंक्शन का परिणाम कक्षाओं / संसाधनों के एक सेट के साथ एक फ़ाइल होगा जो इस परीक्षण को प्रभावित करता है।

और इसलिए, सभी परीक्षणों को चलाने के बाद, हमारे पास कक्षा फ़ाइलों और संसाधनों के आंकड़ों के साथ एक निर्देशिका है।

यह दैनिक सांख्यिकी संग्रह के लिए एक पाइपलाइन लिखने और पुल अनुरोध चेक के पाइपलाइन लॉन्च में जोड़ने के लिए बनी हुई है।

हमें प्रोजेक्ट असेंबली के चरणों में कोई दिलचस्पी नहीं है, लेकिन हम आंकड़ों के प्रकाशन के लिए मंच पर अधिक विस्तार से विचार करेंगे।

 stage('Agregate and parse result') { def inverterInJenkins = downloadMavenDependency( url: NEXUS_RELEASE_REPOSITORY, group: '', name: 'coverage-inverter', version: '0', type: 'jar', mavenHome: wsp ) dir('coverage-mapping') { gitFullCheckoutRef '', '', 'coverage-mapping', "refs/heads/${params.targetBranch}-integration-tests" sh 'rm -rf *' } sh "ls -lRa ..//out/coverage/" def inverter = wsp + inverterInJenkins.substring(wsp.length()) sh "java -jar ${inverter} " + "-d ..//out/coverage/jvm " + "-o coverage-mapping//jvm " + "-i coverage-config/jvm-include " + "-e coverage-config/jvm-exclude" sh "java -jar ${inverter} " + "-d ..//out/coverage/resources " + "-o coverage-mapping//resources " + "-i coverage-config/resources-include " + "-e coverage-config/resources-exclude" gitPush '', '', 'coverage-mapping', "${params.targetBranch}-integration-tests" } 

कवरेज-मैपिंग में, हमें फ़ाइल नाम को संग्रहीत करने की आवश्यकता है और इसके अंदर उन परीक्षणों की एक सूची है जिन्हें चलाने की आवश्यकता है। चूंकि आंकड़े इकट्ठा करने का परिणाम उस परीक्षण का नाम है जो कक्षाओं और संसाधनों के सेट को संग्रहीत करता है, हमें पूरी चीज़ को उलटने और अनावश्यक डेटा (तृतीय-पक्ष पुस्तकालयों से कक्षाएं) को बाहर करने की आवश्यकता है।

हम अपने आँकड़ों को उलट देते हैं और अपने भंडार पर धकेल देते हैं।

हर रात आंकड़े एकत्र किए जाते हैं। यह प्रत्येक रिलीज शाखा के लिए एक अलग भंडार में संग्रहीत किया जाता है।

बिंगो!

अब, परीक्षण चलाते समय, हमें केवल संशोधित फ़ाइल ढूंढनी होगी और उन परीक्षणों को निर्धारित करना होगा जिन्हें चलाने की आवश्यकता है।

हमने जिन समस्याओं का सामना किया:

• चूंकि JaCoCo केवल bytecode के साथ काम करता है, इसलिए बॉक्स से .xml, .gradle, .sql जैसी फ़ाइलों पर आंकड़े एकत्र करना असंभव है। इसलिए, हमें अपने फैसलों को "जकड़ना" पड़ा।
• आँकड़ों की प्रासंगिकता और असेंबली की आवृत्ति की लगातार निगरानी, ​​यदि रात विधानसभा किसी कारण से विफल हो जाती है, तो "कल" ​​के आँकड़ों का उपयोग पुल अनुरोधों में सत्यापन के लिए किया जाएगा।