🏿 🙉 ™️ केक और टीमसिटी इंटीग्रेशन 🌆 👌 🏵️

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

आवश्यकताओं

मैं मान लूंगा कि आपको केक और टीमसिटी का पहले से ही ज्ञान है। अन्यथा, आप निम्नलिखित संसाधनों को पढ़कर शुरू कर सकते हैं:

केक के लिए:

टीम के लिए:

अब बात करते हैं केक और टीमसिटी की बातचीत की।

लॉगिंग

केक पाइपलाइन में आमतौर पर कई कार्य होते हैं। टीमसीटी लॉग में ऐसे प्रत्येक कार्य के लिए एक अलग अनुभाग होना बहुत अच्छा होगा। मैं लॉग में प्रत्येक केक कार्य के लिए एक बंधनेवाला अनुभाग प्राप्त करना चाहता हूं:

पत्रिका

केक एपीआई में TeamCity.WriteStartBuildBlock और TeamCity.WriteEndBuildBlock तरीके हैं। यद्यपि हर कार्य में उनका उपयोग करना संभव है, लेकिन यह स्वचालित हो सकता है। केक में टास्कसेटअप और टास्कआर्टडाउन विधियां हैं जिन्हें प्रत्येक कार्य से पहले और बाद में कहा जाता है। वे टीमसिटी लॉग ब्लॉक खोल और बंद कर सकते हैं:

TaskSetup(setupContext => { if(TeamCity.IsRunningOnTeamCity) { TeamCity.WriteStartBuildBlock(setupContext.Task.Name); } }); TaskTeardown(teardownContext => { if(TeamCity.IsRunningOnTeamCity) { TeamCity.WriteEndBuildBlock(teardownContext.Task.Name); } });

यहाँ, TeamCity.IsRunningOnTeamCity गुण का उपयोग यह निर्धारित करने के लिए किया जाता है कि TeamCity का कोड पॉपअप है या नहीं।

अब हमारी पत्रिका में प्रत्येक कार्य के लिए बंधनेवाला ब्लॉक हैं। लेकिन एक और सुधार जोड़ा जा सकता है।

आमतौर पर, केक में कार्यों के छोटे नाम होते हैं: बिल्ड , टेस्ट , क्लीन । इसलिए उन्हें कमांड लाइन से भागना आसान होता है। लेकिन TeamCity में, मैं और अधिक विस्तृत केक कार्य विवरण होगा। और ऐसा करना संभव है। कार्य को विवरण देने के लिए, वर्णन विधि का उपयोग करें:

 Task("Clean") .Description("Create and clean folders with results") .Does(() => { ... });

अब इन विवरणों का उपयोग लॉग में ब्लॉक बनाने के लिए किया जा सकता है:

 TaskSetup(setupContext => { if(TeamCity.IsRunningOnTeamCity) { TeamCity.WriteStartBuildBlock(setupContext.Task.Description ?? setupContext.Task.Name); } }); TaskTeardown(teardownContext => { if(TeamCity.IsRunningOnTeamCity) { TeamCity.WriteEndProgress(teardownContext.Task.Description ?? teardownContext.Task.Name); } });

इससे इसकी पठनीयता में सुधार होता है।

प्रगति हुई

यदि केक स्क्रिप्ट में लंबा समय लगता है, तो यह जानना उपयोगी है कि वर्तमान में कौन सा कार्य चल रहा है।

प्रगति के संकेत

यह TeamCity.WriteStartProgress और TeamCity.WriteEndProgress तरीकों का उपयोग करके प्राप्त किया जा सकता है। उनके कॉल को एक ही टास्कसेटअप और टास्कआर्टडाउन में डाला जा सकता है:

 TaskSetup(setupContext => { if(TeamCity.IsRunningOnTeamCity) { TeamCity.WriteStartBuildBlock(setupContext.Task.Description ?? setupContext.Task.Name); TeamCity.WriteStartProgress(setupContext.Task.Description ?? setupContext.Task.Name); } }); TaskTeardown(teardownContext => { if(TeamCity.IsRunningOnTeamCity) { TeamCity.WriteEndProgress(teardownContext.Task.Description ?? teardownContext.Task.Name); TeamCity.WriteEndBuildBlock(teardownContext.Task.Description ?? teardownContext.Task.Name); } });

परीक्षण के परिणाम

यदि आप केक कार्य में परीक्षण चलाते हैं, तो टीमसिटी आपको उनके परिणाम दिखाने में सक्षम है।

यह TeamCity.ImportData पद्धति का उपयोग करके किया जा सकता है। यह दो पैरामीटर लेता है: डेटा प्रकार का एक स्ट्रिंग विवरण और इस डेटा वाली फ़ाइल का पथ। उदाहरण के लिए, यदि आप MSTest का उपयोग करते हैं, तो यहां परीक्षणों के परिणामों के बारे में टीमसिटी को कैसे बताया जाए:

 Task("Run-Tests") .Description("Run tests") .IsDependentOn("Clean") .IsDependentOn("Build") .Does(() => { var testDllsPattern = string.Format("./**/bin/{0}/*.*Tests.dll", configuration); var testDlls = GetFiles(testDllsPattern); var testResultsFile = System.IO.Path.Combine(temporaryFolder, "testResults.trx"); MSTest(testDlls, new MSTestSettings() { ResultsFile = testResultsFile }); if(TeamCity.IsRunningOnTeamCity) { TeamCity.ImportData("mstest", testResultsFile); } });

टीमसिटी कई तरह के परीक्षणों का समर्थन करती है। Mestest के अलावा , आप nunit , vstest और कुछ अन्य का उपयोग कर सकते हैं ।

टेस्ट कवरेज विश्लेषण कोड

टीमसिटी परीक्षण द्वारा कोड कवरेज के विश्लेषण के परिणाम को दिखाने में सक्षम है।

TeamCity वर्तमान में DotCover के साथ एकीकरण का समर्थन करता है। मुझे एक केक स्क्रिप्ट में DotCover का उपयोग करने का तरीका बताते हैं। सबसे पहले, DotCover स्थापित करने की आवश्यकता है:

 #tool "nuget:?package=JetBrains.dotCover.CommandLineTools"

उसके बाद, इसका उपयोग कार्यों में किया जा सकता है:

 Task("Analyse-Test-Coverage") .Description("Analyse code coverage by tests") .IsDependentOn("Clean") .IsDependentOn("Build") .Does(() => { var coverageResultFile = System.IO.Path.Combine(temporaryFolder, "coverageResult.dcvr"); var testDllsPattern = string.Format("./**/bin/{0}/*.*Tests.dll", configuration); var testDlls = GetFiles(testDllsPattern); var testResultsFile = System.IO.Path.Combine(temporaryFolder, "testResults.trx"); DotCoverCover(tool => { tool.MSTest(testDlls, new MSTestSettings() { ResultsFile = testResultsFile }); }, new FilePath(coverageResultFile), new DotCoverCoverSettings() .WithFilter("+:Application") .WithFilter("-:Application.*Tests") ); if(TeamCity.IsRunningOnTeamCity) { TeamCity.ImportData("mstest", testResultsFile); TeamCity.ImportDotCoverCoverage(coverageResultFile); } });

जैसा कि आप देख सकते हैं, यहां परीक्षण भी चलाए जाते हैं। इसलिए, हम टीम के परीक्षण के परिणामों और उनके कोड कवरेज के विश्लेषण के परिणामों के बारे में तुरंत सूचित कर सकते हैं। TeamCity.ImportDotCoverCoverage विधि यही करती है।

कलाकृति प्रकाशन

TeamCity में, आप केक स्क्रिप्ट के संचालन के दौरान बनाई गई कुछ कलाकृतियों को प्रकाशित कर सकते हैं। इस भूमिका के लिए एक अच्छा उम्मीदवार NuGet पैकेज हैं:

ऐसा करने के लिए, उन सभी कलाकृतियों को रखें जिन्हें आप एक फ़ोल्डर में प्रकाशित करना चाहते हैं। तो आप TeamCity.PublishArtifacts विधि का उपयोग कर प्रकाशित कर सकते हैं:

 Task("Publish-Artifacts-On-TeamCity") .Description("Publish artifacts on TeamCity") .IsDependentOn("Create-NuGet-Package") .WithCriteria(TeamCity.IsRunningOnTeamCity) .Does(() => { TeamCity.PublishArtifacts(artifactsFolder); });

निष्कर्ष

उम्मीद है कि ये सरल कोड उदाहरण आपके समय और प्रयास को बचाएंगे यदि आप चाहते हैं कि आपकी केक स्क्रिप्ट टीमसिटी पर चले। स्क्रिप्ट का पूरा संस्करण और अनुप्रयोग जो इसे प्रोसेस करता है, उसे GitHub पर पाया जा सकता है । सौभाग्य है

केक और टीमसिटी इंटीग्रेशन