मोनो प्लेटफॉर्म पर "राइट" डेवलपमेंट प्रोसेस का निर्माण

चक्र का एक प्राथमिक उदाहरण .NET प्लेटफॉर्म पर "सही" विकास प्रक्रिया के निर्माण के आधार पर जेनकिंस CI का उपयोग करके एक आदिम ASP.NET (मोनो) एप्लिकेशन का विकास है ।

प्रस्तुत उदाहरण व्यापक दर्शकों के लिए रुचि का हो सकता है, जैसा कि इसे आसानी से किसी अन्य प्लेटफॉर्म के लिए विकास के लिए अनुकूलित किया जा सकता है।

प्रविष्टि

यह लेख कभी नहीं लिखा होता अगर यह मूल लेख के लिए नहीं होता, जो एक समय में विकास प्रक्रिया की मेरी समझ को आकार देने में महत्वपूर्ण भूमिका निभाता था। और, जैसा कि वे कहते हैं, "मैं इस अवसर को लेना चाहता हूं।" मैं अपने अद्भुत लेख के लिए यूजीन को धन्यवाद देना चाहता हूं, जो शुरुआती डेवलपर्स के लिए सिर्फ एक शानदार शुरुआत है! बहुत बहुत धन्यवाद!

यह लेख, द्वारा और बड़े, मौलिक रूप से कुछ नया नहीं है। समान C # प्रोजेक्ट, NUnit पर समान परीक्षण और NAnt पर समान स्वचालन। लेकिन बारीकियां हैं। सबसे पहले: जेनकिंस CI एक CI सर्वर के रूप में उपयोग किया जाता है, और दूसरी बात, इसकी विधानसभा के दौरान विभिन्न परियोजना मैट्रिक्स के विश्लेषण और प्रस्तुति पर काफी ध्यान दिया जाता है।

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

कार्यस्थान

कार्यक्षेत्र को कॉन्फ़िगर करने के लिए, आपको निम्न की आवश्यकता होगी:

ओएस	GNU / Linux ( ओपनएसयूएसई 12.1, एलएक्सडीई )	ऑपरेटिंग सिस्टम जिसके आधार पर निरंतर एकीकरण सर्वर तैनात किया जाएगा।
सीआईएस	जेनकिंस CI 1.450	निरंतर एकीकरण सर्वर।
VCS	तोड़फोड़ 1.6.17	केंद्रीकृत संस्करण नियंत्रण प्रणाली (तोड़फोड़ के बजाय, किसी भी अन्य वीसीएस का उपयोग किया जा सकता है)
CLR	मोनो 2.6.10	वह मंच जिसके नीचे विकास किया जाता है।
परीक्षण	NUnit 2.4.8	परीक्षण बनाने और चलाने के लिए एक उपकरण (इकाई, गैर-इकाई - यह पहले से ही इस बात पर निर्भर करता है कि परीक्षण कौन बनाएगा)।
	सेलेनियम आरसी 2.18.0	कार्यात्मक परीक्षण करने के लिए उपकरण।
स्थैतिक कोड विश्लेषण	जेंडरमे 2.10.0.0	स्थैतिक कोड विश्लेषक।
	2005-05-30 को क्लोनिनलीज़र	डुप्लिकेट कोड खोजने के लिए एक उपयोगिता।
	स्टाइलकॉप्डम 0.2.1	स्थैतिक कोड विश्लेषक।
अन्य उपकरण	नॉट 0.90	परियोजना की स्वचालित विधानसभा के लिए उपयोगिता।
	फ़ायरफ़ॉक्स 7.0.1	वेब ब्राउज़र जिसके साथ कार्यात्मक परीक्षण बनाए जाएंगे और चलाए जाएंगे (अन्य ब्राउज़र का उपयोग करके परीक्षण भी किए जा सकते हैं)
	सेलेनियम आईडीई 1.6.0	कार्यात्मक परीक्षण बनाने के लिए आईडीई।

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

sudo zypper ar http://download.opensuse.org/repositories/Mono/openSUSE_11.4/ Mono sudo zypper ar http://pkg.jenkins-ci.org/opensuse/ Jenkins 

3. आवश्यक पैकेज स्थापित करें:

 sudo zypper in jenkins mono-complete mono-nunit mono-tools nant subversion-server apache2 http://www.dwheeler.com/sloccount/sloccount-2.26-1.i386.rpm 

4. आवश्यक उपयोगिताओं को डाउनलोड करें और इंस्टॉल करें जिन्हें आरपीएम पैकेज (स्टाइलकॉप्डम और क्लोनऑनलियर) के रूप में आपूर्ति नहीं की गई है। कई बारीकियां हैं।
पहला: बॉक्स के बाहर लिनक्स के तहत बायनेरिज़ का उपयोग करना संभव नहीं है। अनुप्रयोग एक संपूर्ण कार्य करता है, लेकिन ReportBuilder.cs फ़ाइल की लाइन 460 में हार्ड-सेट पथ विभाजक के कारण, रिपोर्ट फ़ाइल वह जगह नहीं है जहाँ यह अपेक्षित है:

  private static string GetViolationsFile(string outputXmlFile) { var offp = Path.GetFullPath(outputXmlFile); var f = string.Format( CultureInfo.CurrentCulture, "{0}\\{1}.violations.xml", // String No 460, wrong separator here! Path.GetFullPath(Path.GetDirectoryName(offp)), Path.GetFileNameWithoutExtension(outputXmlFile)); return f; } 

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

 sudo mkdir -p /var/lib/jenkins/tools/{StyleCop,CloneAnalyzer,SeleniumRC} # 1.   SlyleCop    StyleCopCmd. # ... # 2.  CloneAnalyzer cd /var/lib/jenkins/tools/CloneAnalyzer sudo wget http://sourceforge.net/projects/cloneanalyzer/files/latest/download?source=files sudo unzip CloneAnalyzerPluginInstall_20050530.zip sudo mv eclipse/plugins/CloneAnalyzer . rm -rf eclipse # 3.     CloneAnalyzer   . # ... # 4.  Selenium Remoute Control. cd /var/lib/jenkins/tools/SeleniumRC sudo wget http://selenium.googlecode.com/files/selenium-server-standalone-2.19.0.jar 

5. जेनकिंस (जेनकिंस -> मैनेज जेनकिंस -> मैनेज प्लगिन -> उपलब्ध) के लिए प्लग-इन स्थापित करें:

जरूरी
विनाश	आप svn भंडार (डिफ़ॉल्ट रूप से स्थापित) से स्रोत कोड प्राप्त करने के संचालन को स्वचालित करने की अनुमति देता है
NUnit	आपको NUnit के परिणामों पर रिपोर्ट बनाने की अनुमति देता है।
NAnt	आपको जेनकिन्स परियोजना के लिए NAnt स्क्रिप्ट को विधानसभा लक्ष्यों के रूप में सेट करने की अनुमति देता है।
स्थैतिक कोड विश्लेषण	DRY प्लगइन के लिए आवश्यक है।
टास्क स्कैनर	आपको कोड (TODO और अन्य) में पाए जाने वाले टैग के बारे में रिपोर्ट बनाने की अनुमति देता है।
SLOCCount	आपको उपयोगिता SLOCCount (मामूली कोड मैट्रिक्स प्रदर्शित करता है) के परिणामों पर रिपोर्ट बनाने की अनुमति देता है।
DocLinks	आपको प्रोजेक्ट के मुख्य पृष्ठ पर प्रोजेक्ट के लिए प्रलेखन के लिए लिंक की अनुमति देता है।
उल्लंघन	आपको विभिन्न उपयोगिताओं के परिणामों पर रिपोर्ट बनाने की अनुमति देता है। इस उदाहरण का उपयोग Gendarme और StyleCopCmd के परिणामों को प्रदर्शित करने के लिए किया जाता है।
सूखी	आपको डुप्लिकेट कोड पर रिपोर्ट बनाने की अनुमति देता है।
Seleniumhq	सेलेनियम रिपोर्ट के लिंक पोस्ट करें।
चेतावनी	आपको संकलक चेतावनी प्रदर्शित करके रिपोर्ट बनाने की अनुमति देता है।
द्वारा अनुशंसित:
JobConfigHistory	प्रोजेक्ट सेटिंग्स में परिवर्तनों का इतिहास रखता है।
बैकअप	आपको सर्वर बैकअप बनाने की प्रक्रिया को सरल बनाने की अनुमति देता है।
वैकल्पिक:
हरी गेंदें	नीले रंग की गेंद को हरे रंग से बदल देता है।
अगला बिल्ड नंबर	आपको एक असेंबली संख्या सेट करने की अनुमति देता है।
साइडबार लिंक	आपको सर्वर के मुख्य पृष्ठ और परियोजनाओं के पन्नों पर लिंक बनाने की अनुमति देता है।

डेमो प्रोजेक्ट का विवरण

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

• ExampleCore - जिसमें सभी अनुप्रयोग तर्क केंद्रित है (और यह एक दूसरे के लिए, दो विधियों के रूप में कई)!
• ExampleGUI - एप्लिकेशन इंटरफ़ेस (एक एकल, लेकिन इससे भी अधिक महत्वपूर्ण, aspx पृष्ठ)।
• उदाहरण-परीक्षण के साथ एक परियोजना (NUnit)।
• ExampleFTest - कार्यात्मक परीक्षण (सेलेनियम) के साथ ExampleFTest फ़ोल्डर, जो समाधान में शामिल नहीं है, रूट निर्देशिका में भी स्थित है।

असेंबली स्क्रिप्ट बनाएं और टूल कॉन्फ़िगर करें

सबसे पहले, जेनकिंस परियोजना बनाना आवश्यक है, जिसके लिए यह उपलब्ध वेब इंटरफेस के माध्यम से आवश्यक है: http: // localhost: 8080 (यदि स्थानीय कंप्यूटर पर जेनकिंस स्थापित है), तो नई नौकरी लिंक पर क्लिक करें, प्रोजेक्ट प्रकार चुनें एक नि: शुल्क का निर्माण करें- शैली सॉफ्टवेयर परियोजना, परियोजना का नाम दर्ज करें और इसे बनाएं। प्रोजेक्ट बना है।
जैसा कि पहले उल्लेख किया गया है, विधानसभा परियोजना का मूल एक NAnt स्क्रिप्ट होगा, इसके लिए आपको बिल्ड सेक्शन में एक लक्ष्य बनाने की आवश्यकता है जो स्क्रिप्ट को कॉल करेगा: सामान्य तौर पर, परियोजना संगठन के कई दृष्टिकोण हो सकते हैं जिनके फायदे और नुकसान हैं। उदाहरण में, सभी क्रियाओं को एक NAnt स्क्रिप्ट में रखा जाता है, जिसे जेनकिन्स परियोजना में एक कमांड द्वारा कहा जाता है। यह सुविधाजनक है कि असेंबली जेनकिंस के बिना करना बहुत आसान है, बस NAnt स्क्रिप्ट को चलाएं। लेकिन असेंबली प्रक्रिया को बदलने के लिए यह हमेशा सुविधाजनक नहीं होता है (पहले आपको NAnt स्क्रिप्ट में बदलाव करने की आवश्यकता है, फिर कमिट करें, और उसके बाद ही बिल्ड प्रक्रिया अपडेट की जाएगी)। इस दृष्टिकोण के विपरीत, आप जेनकिंस परियोजना में बैश स्क्रिप्ट निष्पादित करने के लिए कई लक्ष्य बना सकते हैं और उनमें सभी विधानसभा तर्क रख सकते हैं। इस मामले में, निर्माण प्रक्रिया को संपादित करना सुविधाजनक है, लेकिन जेनकींस के बाहर निर्माण संभव नहीं होगा।
आइए, एक Nant-script बनाना शुरू करें, जिसमें निम्नलिखित रूप हैं:

 <?xml version="1.0"?> <project name="Example" default="cis" basedir="."> <!-- Property --> <!--Targets --> <target name="cis" description="Execute all targets in CIS."> <call target="clean" /> <call target="build" /> <call target="documentation" /> <call target="utest" /> <call target="gendarme" /> <call target="stylecop" /> <call target="sloccount" /> <call target="cloneanalyze" /> <call target="ftest" /> </target> </project> 

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

सादगी के लिए, हम उन गुणों की घोषणा करेंगे जो हमारे कोड को और कम कर देंगे।
जेनकींस पर्यावरण चर:

  <property name="work.d" value="${environment::get-variable('WORKSPACE')}" /> 

वह निर्देशिका जहाँ उपकरण एकत्रित किए जाते हैं:

  <property name="tools.d" value="/var/lib/jenkins/tools" /> 

विभिन्न निर्देशिकाओं के उपनाम, जिसका उद्देश्य नाम से स्पष्ट है:

  <property name="bin.d" value="${build.conf}/bin"/> <property name="deploy.d" value="/home/vm/public_html" /> <property name="test.res.d" value="test-results" /> <property name="report.d" value="${work.d}/reports" /> <property name="doc.d" value="${work.d}/doc" /> <property name="core.d" value="${work.d}/ExampleCore" /> <property name="gui.d" value="${work.d}/ExampleGUI" /> <property name="utest.d" value="${work.d}/ExampleUTest" /> <property name="ftest.d" value="${work.d}/ExampleFTest" /> 

बाइनरी फ़ाइल और स्टाइलकॉम्प्ड सेटिंग्स फ़ाइल के उपनाम:

  <property name="style.exe" value="${tools.d}/StyleCop/Net.SF.StyleCopCmd.Console.exe" /> <property name="style.conf" value="${tools.d}/StyleCop/Settings.StyleCop" /> 

निष्पादन योग्य फ़ाइल, कनवर्टर और कॉन्फ़िगरेशन फ़ाइल CloneAnalyzer का उपनाम:

  <property name="clone.jar" value="${tools.d}/CloneAnalyzer/CloneAnalyzer.jar" /> <property name="clone.conf" value="${tools.d}/CloneAnalyzer/comments.conf" /> <property name="clone.conv" value="${tools.d}/CloneAnalyzer/ca2cpd.exe" /> 

निष्पादन योग्य फ़ाइल का उपनाम, आवरण स्क्रिप्ट, साथ ही परीक्षण सूट और होस्ट नाम के साथ फ़ाइल जिस पर सेलेनियमआरसी के लिए आवेदन तैनात किया गया है:

  <property name="selen.jar" value="${tools.d}/SeleniumRC/selenium-server-standalone-2.18.0.jar" /> <property name="selen.sh" value="${tools.d}/SeleniumRC/selenium.sh" /> <property name="selen.host" value="http://192.168.56.210" /> <property name="selen.suite" value="${ftest.d}/Main.html" /> 

चलिए लक्ष्य बनाना शुरू करते हैं।
1. सबसे पहले, पुरानी कलाकृतियों से विधानसभा निर्देशिका को साफ करने और आवश्यक निर्देशिका बनाने का लक्ष्य बनाएं:

  <target name="clean" description="Remove binary files, recreate report directory."> <echo message="Target starded at: ${datetime::now()}."/> <delete failonerror="false" dir= "${core.d}/${bin.d}"/> <delete failonerror="false" file="${core.d}/ExampleCore.pidb"/> <delete failonerror="false" dir= "${utest.d}/${bin.d}"/> <delete failonerror="false" dir= "${utest.d}/${test.res.d}"/> <delete failonerror="false" file="${utest.d}/ExampleUTest.pidb"/> <delete failonerror="false" dir= "${gui.d}/${bin.d}"/> <delete failonerror="false" dir= "${gui.d}/${test.res.d}"/> <delete failonerror="false" file="${gui.d}/ExampleGUI.pidb"/> <delete failonerror="false" dir= "${report.d}"/> <delete failonerror="false" dir= "${doc.d}"/> <delete failonerror="false" file="${work.d}/stylecop.report"/> <delete failonerror="false" file="${work.d}/stylecop.violations.xml"/> <mkdir dir="${report.d}"/> <mkdir dir="${report.d}/gendarme"/> <mkdir dir="${report.d}/sloccount"/> <mkdir dir="${report.d}/cloneanalyzer"/> <mkdir dir="${report.d}/selenium"/> <mkdir dir="${doc.d}/xml"/> <mkdir dir="${doc.d}/html"/> <echo message="Target completed at: ${datetime::now()}."/> </target> 

2. दूसरा चरण रिपॉजिटरी से अपडेट प्राप्त करने के लिए हो सकता है। चूंकि यह ऑपरेशन जेनकिंस द्वारा किया जाता है, इस उदाहरण में, NAnt स्क्रिप्ट में यह शामिल नहीं है, लेकिन यदि यह आवश्यक था, तो इसका स्थान यहां है।
सबवर्सन रिपॉजिटरी बनाएँ और कॉन्फ़िगर करें:

 su a2enmod dav a2enmod dav_svn a2enmod mod_authz_svn cd /srv/www/htdocs wget http://tortoisesvn.googlecode.com/svn/trunk/contrib/svnindex/menucheckout.ico wget http://tortoisesvn.googlecode.com/svn/trunk/contrib/svnindex/svnindex.css wget http://tortoisesvn.googlecode.com/svn/trunk/contrib/svnindex/svnindex.xsl mkdir -p /srv/svn/{repos,user_access,html} cat > /etc/apache2/conf.d/subversion.conf << EOF <IfModule mod_alias.c> Alias /repos "/srv/svn/html" </IfModule> <Directory /srv/svn/html> Options +Indexes +Multiviews -FollowSymLinks IndexOptions FancyIndexing \ ScanHTMLTitles \ NameWidth=* \ DescriptionWidth=* \ SuppressLastModified \ SuppressSize order allow,deny allow from all </Directory> <Location /repos/Example> DAV svn SVNListParentPath on SVNPath /srv/svn/repos/Example SVNIndexXSLT "/svnindex.xsl" AuthType Basic AuthName "Subversion" AuthUserFile /srv/svn/user_access/passwdfile AuthGroupFile /srv/svn/user_access/groupfile AuthzSVNAccessFile /srv/svn/user_access/accessfile Require valid-user </Location> EOF cd /srv/svn/repos svnadmin create --fs-type fsfs Example mkdir -p /srv/svn/repos/Example/dav chown -R wwwrun:www Example/{dav,db,locks} touch /srv/svn/user_access/passwdfile chown root:www /srv/svn/user_access/passwdfile chmod 640 /srv/svn/user_access/passwdfile touch /srv/svn/user_access/groupfile cat > /srv/svn/user_access/groupfile << EOF Example_commiters: Admin User Example_readers: Admin User CIS touch /srv/svn/user_access/accessfile cat > /srv/svn/user_access/accessfile << EOF [groups] admin = Admin user = User cis = CIS [/] * = @admin = rw [Example:/] @user = rw @cis = r /sbin/service apache2 restart exit 

उसके बाद, तोड़फोड़ प्लगइन को कॉन्फ़िगर करें:

और हम असेंबली की आवृत्ति भी निर्धारित करते हैं (यदि अद्यतन हैं तो इकट्ठा करने के लिए, जिसकी उपस्थिति सप्ताह में हर घंटे जाँच की जाती है):

3. एक ऐसा लक्ष्य बनाएं जो सबप्रोजेक्ट्स उदाहरण Xore और उदाहरण GUI के xml प्रारूप में प्रलेखन की पीढ़ी के साथ संकलित करेगा:

  <target name="build" description="Compiles the source code."> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Building ExampleCore."/> <csc codepage="utf8" target="library" output="${core.d}/${bin.d}/${build.conf}/ExampleCore.dll" doc="${doc.d}/xml/ExampleCore.xml"> <sources> <include name="${core.d}/**.cs"/> </sources> </csc> <copy file="${core.d}/${bin.d}/${build.conf}/ExampleCore.dll" tofile="${gui.d}/${bin.d}/${build.conf}/ExampleCore.dll" /> <copy file="${core.d}/${bin.d}/${build.conf}/ExampleCore.dll" tofile="${utest.d}/${bin.d}/${build.conf}/ExampleCore.dll" /> <echo message="Building ExampleGUI."/> <csc codepage="utf8" target="library" output="${gui.d}/${bin.d}/${build.conf}/ExampleGUI.dll" doc="${doc.d}/xml/ExampleGUI.xml"> <sources> <include name="${gui.d}/**.cs" /> </sources> <references> <include name="System.Web.dll" /> <include name="${gui.d}/${bin.d}/${build.conf}/ExampleCore.dll" /> </references> </csc> <echo message="Target completed at: ${datetime::now()}." /> </target> 

हम चेतावनियों को कॉन्फ़िगर करते हैं ताकि संकलक संदेश जेनकिन्स द्वारा संसाधित किए जाएँ:

भविष्य में, यह आपको कंपाइलर चेतावनी पर इन रिपोर्टों को प्राप्त करने की अनुमति देगा:

4. हम HTML प्रारूप में प्रलेखन उत्पन्न करते हैं:

  <target name="documentation" description="Generation documentation."> <echo message="Target starded at: ${datetime::now()}."/> <exec program="monodocer" commandline=" -pretty -i:${doc.d}/xml/ExampleCore.xml -assembly:${core.d}/${bin.d}/${build.conf}/ExampleCore.dll -path:${doc.d}/xml"/> <exec program="monodocer" commandline=" -pretty -i:${doc.d}/xml/ExampleGUI.xml -assembly:${gui.d}/${bin.d}/${build.conf}/ExampleGUI.dll -path:${doc.d}/xml"/> <exec program="mdoc" commandline="export-html ${doc.d}/xml -o=${doc.d}/html"/> <echo message="Target completed at: ${datetime::now()}." /> </target> 

DocLinks प्लगइन सेट करें: नतीजतन, प्रलेखन का एक लिंक परियोजना के मुख्य पृष्ठ पर बनाया जाएगा।

5. यूनिट परीक्षण एकत्र करें और चलाएं:

  <target name="utest" description="Test the source code."> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Building ExampleUTest."/> <csc codepage="utf8" target="library" output="${utest.d}/${bin.d}/${build.conf}/ExampleUTest.dll"> <sources> <include name="${utest.d}/**.cs" /> </sources> <references> <include name="System.Web.dll" /> <include name="${gui.d}/${bin.d}/${build.conf}/ExampleCore.dll" /> <include name="nunit.core.dll" /> <include name="nunit.framework.dll" /> </references> </csc> <echo message="Launch NUnit." /> <nunit2 haltonfailure="false"> <formatter type="Xml" usefile="true" extension=".xml" outputdir="${utest.d}/${test.res.d}" /> <formatter type="Plain" usefile="false" /> <test assemblyname="${utest.d}/${bin.d}/${build.conf}/ExampleUTest.dll" /> </nunit2> <echo message="Target completed at: ${datetime::now()}." /> </target> 

NUnit प्लगइन सेट करें:

NUnit प्लगइन रिपोर्ट इस तरह दिखती हैं:

6. Gendarme का उपयोग करके स्थिर कोड विश्लेषण करें:

  <target name="gendarme"> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Check code by Gendarme."/> <exec program="gendarme" failonerror="false" commandline=" --config GendarmeRules.xml ${core.d}/${bin.d}/${build.conf}/ExampleCore.dll --xml ${report.d}/gendarme/ExampleCore.gendarme.xml --severity medium+ --confidence total"/> <exec program="gendarme" failonerror="false" commandline=" --config GendarmeRules.xml ${gui.d}/${bin.d}/${build.conf}/ExampleGUI.dll --xml ${report.d}/gendarme/ExampleGUI.gendarme.xml --severity medium+ --confidence total"/> <echo message="Target completed at: ${datetime::now()}." /> </target> 

... और StyleCopCmd:

  <target name="stylecop"> <echo message="Target starded at: ${datetime::now()}."/> <exec program="mono" commandline=" ${style.exe} -r -sc ${style.conf} -d ${work.d} -of ${work.d}/stylecop/stylecop.report"/> <echo message="Target completed at: ${datetime::now()}." /> </target> 

StyleCopCmd के कारण हुई त्रुटि से छुटकारा पाने के लिए:

 While saving registry data at /etc/mono/2.0/../registry/last-btime: System.UnauthorizedAccessException: Access to the path "/etc/mono/registry/last-btime" is denied. at System.IO.FileStream..ctor (System.String path, FileMode mode, FileAccess access, FileShare share, Int32 bufferSize, Boolean anonymous, FileOptions options) [0x00000] in <filename unknown>:0 at System.IO.FileStream..ctor (System.String path, FileMode mode, FileAccess access, FileShare share) [0x00000] in <filename unknown>:0 at (wrapper remoting-invoke-with-check) System.IO.FileStream:.ctor (string,System.IO.FileMode,System.IO.FileAccess,System.IO.FileShare) at System.IO.StreamWriter..ctor (System.String path, Boolean append, System.Text.Encoding encoding, Int32 bufferSize) [0x00000] in <filename unknown>:0 at System.IO.StreamWriter..ctor (System.String path, Boolean append, System.Text.Encoding encoding) [0x00000] in <filename unknown>:0 at (wrapper remoting-invoke-with-check) System.IO.StreamWriter:.ctor (string,bool,System.Text.Encoding) at Microsoft.Win32.KeyHandler.SaveRegisteredBootTime (System.String path, Int64 btime) [0x00000] in <filename unknown>:0 

सभी के लिए लिखने की अनुमति के साथ एक वांछित फ़ाइल बनाएँ:

 sudo touch /etc/mono/registry/last-btime sudo chmod 666 /etc/mono/registry/last-btime 

उल्लंघन प्लगइन सेट करें:

तो रिपोर्ट दिखेगा:

कई अप्रिय क्षण हैं: सबसे पहले, स्टाइलकॉप पर विस्तृत रिपोर्ट को सफलतापूर्वक प्रदर्शित करने के लिए, रिपोर्ट को परियोजना की जड़ (जो सामान्य प्रवृत्ति का उल्लंघन करता है) पर झूठ होना चाहिए, और दूसरी बात: मैं अभी भी Gendarme की विस्तृत रिपोर्ट को कॉन्फ़िगर नहीं कर सका ( कौन आया था - मैं मदद माँगता हूँ)।

7. हम मैट्रिक्स इकट्ठा करते हैं:

  <target name="sloccount"> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Analyze code by SLOCCount."/> <exec program="sloccount" output="${report.d}/sloccount/sloccount.report" commandline=" --duplicates --wide --details ${work.d}"/> <echo message="Target completed at: ${datetime::now()}." /> </target> 

SLOCCount प्लगइन सेट करें:

रिपोर्ट का उदाहरण:

8. हम दो चरणों में डुप्लिकेट की खोज करते हैं: सबसे पहले, CloneAnalyzer एप्लिकेशन चलाएँ, और फिर प्राप्त रिपोर्ट को कनवर्ट करें:

  <target name="cloneanalyze"> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Find code duplicates by CloneAnalyze."/> <exec program="java" failonerror="false" output="${report.d}/cloneanalyzer/cloneanalyzer.report.txt" commandline=" -jar ${clone.jar} -c ${clone.conf} -f .*\.\(cs\|aspx\) -d ${work.d}"/> <echo message="Convert CloneAnalyze report in CPD report."/> <exec program="mono" failonerror="false" commandline=" ${clone.conv} ${report.d}/cloneanalyzer/cloneanalyzer.report.txt ${report.d}/cloneanalyzer/cloneanalyzer.report.xml"/> <echo message="Target completed at: ${datetime::now()}." /> </target> 

DRY प्लगइन सेट करें:

रिपोर्ट का उदाहरण:

9. कार्यात्मक परीक्षण करें, जिसके लिए हम पहले एप्लिकेशन को तैनात करते हैं, वेब सर्वर को पुनरारंभ करते हैं और वास्तव में परीक्षण चलाते हैं:

  <target name="ftest"> <echo message="Target starded at: ${datetime::now()}."/> <echo message="Prepare to launch tests."/> <copy todir="${deploy.d}/${bin.d}/"> <fileset basedir="${gui.d}/${bin.d}/${build.conf}"> <include name="*.dll"/> </fileset> </copy> <copy todir="${deploy.d}/"> <fileset basedir="${gui.d}/"> <include name="*.aspx"/> <include name="*.asax"/> <include name="*.config"/> </fileset> </copy> <echo message="Restart apache2 server."/> <exec program="/bin/bash" commandline="-c 'sudo /etc/init.d/apache2 restart'"/> <echo message="Testing project by Selenium."/> <exec program="${selen.sh}" failonerror="false" commandline=" -htmlSuite *firefox ${selen.host} ${selen.suite} ${report.d}/selenium/selenium.html"/> <echo message="Target completed at: ${datetime::now()}." /> </target> 

जेनकिंस उपयोगकर्ता वेब सर्वर को पुनरारंभ करने में सक्षम होने के लिए, उसे उचित अधिकार दिए जाने की आवश्यकता है:

 su cat > /etc/sudoers << EOF jenkins ALL=(ALL) NOPASSWD: /etc/init.d/apache2 EOF exit 

परीक्षणों को चलाने के लिए, एक स्क्रिप्ट आवरण बनाएँ जो आवश्यक पर्यावरण चर निर्धारित करेगा और कमांड लाइन मापदंडों को स्वयं के माध्यम से सेलेनियम सर्वर पर प्रेषित करेगा:

 cd /var/lib/jenkins/tools/SeleniumRC touch selenium.sh chmod +x selenium.sh cat > selenium.sh << EOF #!/bin/bash export $(dbas-launch) export NSS_USE_SHARED_DB=ENABLE export DISPLAY=:0 java -jar /var/lib/jenkins/tools/SeleniumRC/selenium-server-standalone-2.18.0.jar $@ EOF 

अपाचे को कॉन्फ़िगर करें। फ़ाइल /etc/apache/conf.d/mod_mono संपादित करें और आवेदन का स्थान निर्दिष्ट करें:

 <IfModule !mod_mono.c> LoadModule mono_module /usr/lib/apache2/mod_mono.so </IfModule> MonoAutoApplication disabled AddHandler mono .aspx .ascx .asax .ashx .config .cs .asmx .axd MonoApplications "/:/home/vm/public_html" AddType application/x-asp-net .aspx AddType application/x-asp-net .asmx AddType application/x-asp-net .ashx AddType application/x-asp-net .asax AddType application/x-asp-net .ascx AddType application/x-asp-net .soap AddType application/x-asp-net .rem AddType application/x-asp-net .axd AddType application/x-asp-net .cs AddType application/x-asp-net .vb AddType application/x-asp-net .master AddType application/x-asp-net .sitemap AddType application/x-asp-net .resources AddType application/x-asp-net .skin AddType application/x-asp-net .browser AddType application/x-asp-net .webinfo AddType application/x-asp-net .resx AddType application/x-asp-net .licx AddType application/x-asp-net .csproj AddType application/x-asp-net .vbproj AddType application/x-asp-net .config AddType application/x-asp-net .Config AddType application/x-asp-net .dll DirectoryIndex index.aspx DirectoryIndex Default.aspx DirectoryIndex default.aspx 

और एप्लिकेशन कॉन्फ़िगरेशन फ़ाइल बनाएं /etc/apache2/conf.d/Example:

 Alias / "home/vm/public_html" MonoServerPath Example "/usr/bin/mod-mono-server2" MonoSetEnv Example MONO_IOMAP=all MonoApplications Example "/:/home/vm/public_html" <Location "/"> Allow from all Order allow,deny MonoSetServerAlias Example SetHandler mono SetOutputFilter DEFLATE SetEnvIfNoCase Request_URI "\.(?:gif|jpe?g|png)$" no-gzip dont-vary </Location> 

 su cat > /etc/sudoers << EOF jenkins ALL=(ALL) NOPASSWD: /etc/init.d/apache2 EOF exit 

सेलेनियम प्लगइन सेट करें:

नमूना रिपोर्ट (जेनकिंस सिर्फ एक सेलेनियम रिपोर्ट एक को प्रदर्शित करता है): यह NAnt स्क्रिप्ट के गठन को पूरा करता है।

10. रिपॉजिटरी से सोर्स कोड प्राप्त करने के कार्य के साथ-साथ खुले कार्यों के लिए कोड को स्कैन करने का कार्य भी सीधे जेनकिन्स (नैन्ट-लिपि को दरकिनार) से किया जाता है।
टास्क स्कैनर प्लगइन सेट करें:

रिपोर्ट का उदाहरण:

असेंबली प्रोजेक्ट कॉन्फ़िगर किया गया है और चलाने के लिए तैयार है।

ट्यूनिंग

संक्षेप में, मैं कुछ अन्य प्लगइन्स (जिनमें से एक बड़ी संख्या है ) पर ध्यान देना चाहूंगा।

बैकअप - प्लगइन का उद्देश्य इसके नाम से स्पष्ट है, और इसका कॉन्फ़िगरेशन तुच्छ है। इसका वर्णन अनावश्यक है, क्योंकि बैकअप चिंता की पहली बात है!

JobConfigHistory - कभी-कभी कॉन्फ़िगरेशन प्रक्रिया के दौरान प्रोजेक्ट कॉन्फ़िगरेशन में किए गए परिवर्तन असफल हो जाते हैं और पिछले संस्करण में आसानी से लौटने के लिए पिछले संस्करण को बचाने के लिए उपाय करना आवश्यक होता है। डेटा प्लगइन परिवर्तनों का इतिहास रखता है और आपको किए गए परिवर्तनों को आसानी से निर्धारित करने की अनुमति देता है।

ग्रीन बॉल्स - डिफ़ॉल्ट रूप से, जेनकिन्स स्थिति प्रदर्शित करने के लिए तीन रंगों का उपयोग करता है: लाल, पीला और नीला। यह प्लगइन आपको हरे रंग के साथ नीले रंग को बदलने की अनुमति देता है। इस प्लगइन का व्यावहारिक मूल्य बहुत ही संदेहास्पद है, लेकिन सौंदर्यशास्त्र को नजरअंदाज करना कठिन है!

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

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

परिणामस्वरूप, मुख्य पृष्ठ पर महत्वपूर्ण लिंक दिखाई देता है:

प्रोजेक्ट पेज पर, आप इस प्रोजेक्ट के लिए विशिष्ट संसाधन का लिंक दे सकते हैं (उदाहरण के लिए, svn रिपॉजिटरी के लिए), या, जो अधिक उपयोगी हो सकता है, कुछ उपयोगिता की रिपोर्ट के लिए जिसके लिए कोई जेनकिन्स प्लग-इन नहीं है। प्रोजेक्ट पेज पर एक लिंक बनाने के लिए, आपको इसे कॉन्फ़िगर करना होगा:

कृपया ध्यान दें कि आइकन फ़ाइलों को केवल सर्वर सेटिंग्स के माध्यम से सर्वर पर डाउनलोड किया जा सकता है, यह फ़ंक्शन प्रोजेक्ट सेटिंग्स में उपलब्ध नहीं है।
यह प्रोजेक्ट पृष्ठ पर सबवर्सन लिंक जैसा दिखेगा।

यह परियोजना पृष्ठ निष्कर्ष में कैसा दिखेगा:

और यहां बिल्ड रिपोर्ट पृष्ठ है:

व्यापक तर्क (सामान्य निष्कर्ष के बजाय)

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

दूसरी बात: CI Servere पर असेंबल करना अक्सर पर्याप्त नहीं हो सकता है, ज्यादातर मामलों में यह एक मैट्रिक्स प्रोजेक्ट बनाने के लिए सलाह दी जाती है ताकि एप्लिकेशन को तैनात करने का ऑपरेशन कुछ अधिक जटिल हो।

तीसरा: यूनिट टेस्ट संभवतया टेस्ट सर्वर के बजाय बिल्ड सर्वर पर अधिक सही ढंग से किए जाते हैं।

उदाहरण में, कोई भी सूचना प्लगिन नहीं माना जाता है। व्यवहार में, उनका उपयोग आवश्यक हो सकता है।

अंत में, सीआई servere पर कुछ परिवर्तन (इस मामले में कार्यात्मक परीक्षण चलाने के लिए एक्स-सर्वर तंत्र नहीं किया जा सकता पर जब उपायों )।

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

पुनश्च

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