शेल स्क्रिप्ट को चलाते समय जेनकिन्स में अस्थिर निर्माण को कैसे चिह्नित किया जाए

Question 1

जिस परियोजना में मैं काम कर रहा हूं, हम विभिन्न कार्यों को निष्पादित करने के लिए शेल स्क्रिप्ट का उपयोग कर रहे हैं। कुछ श / बैश स्क्रिप्ट हैं जो rsync चलाते हैं, और कुछ PHP स्क्रिप्ट हैं। PHP स्क्रिप्ट में से एक कुछ एकीकरण परीक्षण चला रहा है जो जेयूनिट एक्सएमएल, कोड कवरेज रिपोर्ट और इसी तरह का आउटपुट देता है।

जेनकींस निकास स्थिति के आधार पर नौकरियों को सफल / असफल के रूप में चिह्नित करने में सक्षम है । में पीएचपी, 1 के साथ स्क्रिप्ट बाहर निकलता है यह पता लगाया है कि परीक्षण चलाने के दौरान विफल रहा है। अन्य शेल स्क्रिप्ट कमांड चलाते हैं और उन बिल्ड से बाहर निकलने के कोड का उपयोग करते हैं जो एक असफल को चिह्नित करते हैं।

// :: End of PHP script:
// If any tests have failed, fail the build
if ($build_error) exit(1);

में जेनकींस शब्दावली , एक अस्थिर निर्माण के रूप में परिभाषित किया गया है:

एक बिल्ड अस्थिर है अगर इसे सफलतापूर्वक बनाया गया था और एक या अधिक प्रकाशक इसे अस्थिर रिपोर्ट करते हैं। उदाहरण के लिए यदि JUnit प्रकाशक कॉन्फ़िगर किया गया है और एक परीक्षण विफल हो जाता है तो बिल्ड को अस्थिर चिह्नित किया जाएगा।

शेल स्क्रिप्ट चलाने के दौरान मैं केवल सफलता के बजाय अस्थिर के रूप में निर्माण को चिह्नित करने के लिए जेनकिन्स कैसे प्राप्त कर सकता हूं?

Question 2

पाठ-खोजक प्लगइन का उपयोग करें ।

स्थिति 1 से बाहर निकलने के बजाय (जो निर्माण को विफल करेगा), करें:

if ($build_error) print("TESTS FAILED!");

पोस्ट-बिल्ड एक्शन की तुलना में टेक्स्ट फाइंडर को सक्षम करें, आपके द्वारा प्रिंट किए गए संदेश से मेल खाने के लिए नियमित अभिव्यक्ति सेट करें ( TESTS FAILED!) और उस प्रविष्टि के तहत "अस्थिर पाए गए" चेकबॉक्स की जांच करें।

Question 3

आधुनिक जेनकींस संस्करण (२.२६, अक्टूबर २०१६ से) ने इसे हल कर दिया: यह एग्ज़िक्यूट शेल बिल्ड स्टेप के लिए एक उन्नत विकल्प है!

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

Question 4

यह मैजिक स्ट्रिंग्स को प्रिंट किए बिना और TextFinder का उपयोग किए बिना किया जा सकता है। यहाँ पर कुछ जानकारी है।

मूल रूप से आपको शेल स्क्रिप्ट में उपलब्ध http: // yourserver.com / cli से एक .jar फ़ाइल की आवश्यकता होती है , तो आप एक निर्माण अस्थिर बनाने के लिए निम्न कमांड का उपयोग कर सकते हैं:

java -jar jenkins-cli.jar set-build-result unstable

त्रुटि पर अस्थिर निर्माण को चिह्नित करने के लिए, आप इसका उपयोग कर सकते हैं:

failing_cmd cmd_args || java -jar jenkins-cli.jar set-build-result unstable

समस्या यह है कि शेल स्क्रिप्ट से जेनकिंस-क्लि.जर उपलब्ध है। आप इसे आसान-से-एक्सेस पथ में रख सकते हैं, या नौकरी के खोल स्क्रिप्ट के माध्यम से डाउनलोड कर सकते हैं:

wget ${JENKINS_URL}jnlpJars/jenkins-cli.jar

Question 5

आपको अपनी बिल्ड स्क्रिप्ट को लपेटने के लिए जेनकिंसफाइल का उपयोग करना चाहिए और बस उपयोग करके वर्तमान बिल्ड को UNSTABLE के रूप में चिह्नित करना चाहिए currentBuild.result = "UNSTABLE"।

   मंच {
      स्टेटस = / * आपकी बिल्ड कमांड यहाँ जाती है * /
      अगर (स्थिति === "MARK-AS-UNSTABLE") {
        currentBuild.result = "UNSTABLE"
      }
   }

Question 6

आपको ग्रूवी का उपयोग करने में सक्षम होना चाहिए और वही करना चाहिए जो टेक्स्टफाइंडर ने किया था

ग्रूवी पोस्ट-बिल्ड प्लगइन के साथ एक बिल्ड को स्थिर के रूप में चिह्नित करना

if(manager.logContains("Could not login to FTP server")) {
    manager.addWarningBadge("FTP Login Failure")
    manager.createSummary("warning.gif").appendText("<h1>Failed to login to remote FTP Server!</h1>", false, false, false, "red")
    manager.buildUnstable()
}

ग्रूवी पोस्टबिल्ट प्लगिन भी देखें

Question 7

मेरी नौकरी की स्क्रिप्ट में, मेरे पास निम्नलिखित कथन हैं (यह नौकरी केवल जेनकिंस मास्टर पर चलती है):

# This is the condition test I use to set the build status as UNSTABLE
if [ ${PERCENTAGE} -gt 80 -a ${PERCENTAGE} -lt 90 ]; then
  echo WARNING: disc usage percentage above 80%

  # Download the Jenkins CLI JAR:
  curl -o jenkins-cli.jar ${JENKINS_URL}/jnlpJars/jenkins-cli.jar

  # Set build status to unstable
  java -jar jenkins-cli.jar -s ${JENKINS_URL}/ set-build-result unstable

fi

आप जेनकिंस विकी पर बिल्ड स्टेटस सेट करने के बारे में यह और बहुत अधिक जानकारी देख सकते हैं: https://wiki.jenkins-ci.org/display/JENKINS/Jenkins+CLI

Question 8

Xml जूनिट रिपोर्ट बनाने के लिए PHP बिल्ड को कॉन्फ़िगर करें

<phpunit bootstrap="tests/bootstrap.php" colors="true" >
   <logging>
       <log type="junit" target="build/junit.xml" 
           logIncompleteSkipped="false" title="Test Results"/>
   </logging>

   ....

 </phpunit>

स्थिति 0 के साथ स्क्रिप्ट का निर्माण समाप्त करें
```
...
exit 0;
```
टेस्ट रिपोर्ट XMLs के लिए पोस्ट-बिल्ड एक्शन प्रकाशित करें JUnit परीक्षा परिणाम रिपोर्ट जोड़ें । जब परीक्षण विफल हो रहे हैं तो यह प्लगइन स्थिर बिल्ड को अस्थिर में बदल देगा।
```
**/build/junit.xml
```
कंसोल आउटपुट स्कैनिंग और अनियंत्रित विकल्पों के साथ जेनकिंस टेक्स्ट फाइंडर प्लगइन जोड़ें । यह प्लगइन पूरी तरह से असफल त्रुटि पर निर्माण करता है।
```
PHP Fatal error:
```

Question 9

मुझे लगता है कि ऐसा करने का सबसे लचीला तरीका ग्रूवी पोस्ट बिल्ड प्लगइन में एक फ़ाइल को पढ़ना है।

import hudson.FilePath
import java.io.InputStream

def build = Thread.currentThread().executable

String unstable = null
if(build.workspace.isRemote()) {
    channel = build.workspace.channel;
    fp = new FilePath(channel, build.workspace.toString() + "/build.properties")
    InputStream is = fp.read()
    unstable = is.text.trim()
} else {
    fp = new FilePath(new File(build.workspace.toString() + "/build.properties"))
    InputStream is = fp.read()
    unstable = is.text.trim()
}

manager.listener.logger.println("Build status file: " + unstable)
if (unstable.equalsIgnoreCase('true')) {
    manager.listener.logger.println('setting build to unstable')
    manager.buildUnstable()
}

यदि फ़ाइल सामग्री 'सत्य' है, तो निर्माण अस्थिर हो जाएगा। यह स्थानीय मास्टर और आपके द्वारा काम चलाने वाले किसी भी दास पर और किसी भी तरह की स्क्रिप्ट के लिए काम करेगा जो डिस्क पर लिख सकता है।

Question 10

TextFinder केवल तभी अच्छा है जब जॉब की स्थिति SUCCESS से बदलकर FAILED या ABORTED नहीं की गई है। ऐसे मामलों के लिए, PostBuild चरण में एक ग्रूवी स्क्रिप्ट का उपयोग करें:

errpattern = ~/TEXT-TO-LOOK-FOR-IN-JENKINS-BUILD-OUTPUT.*/;
manager.build.logFile.eachLine{ line ->
    errmatcher=errpattern.matcher(line)
    if (errmatcher.find()) {
        manager.build.@result = hudson.model.Result.NEW-STATUS-TO-SET
    }
 }

मेरे द्वारा इसके बारे में लिखी गई पोस्ट में अधिक विवरण देखें: http://www.tikalk.com/devops/JenkinsJobStatusChange/

Question 11

यहाँ से अपना उत्तर दोहरा रहा हूँ क्योंकि मैंने कुछ समय इसके लिए खोजा था:

जेनकींस के नए संस्करणों में अब यह संभव है, आप कुछ इस तरह कर सकते हैं:

#!/usr/bin/env groovy

properties([
  parameters([string(name: 'foo', defaultValue: 'bar', description: 'Fails job if not bar (unstable if bar)')]),
])


stage('Stage 1') {
  node('parent'){
    def ret = sh(
      returnStatus: true, // This is the key bit!
      script: '''if [ "$foo" = bar ]; then exit 2; else exit 1; fi'''
    )
    // ret can be any number/range, does not have to be 2.
    if (ret == 2) {
      currentBuild.result = 'UNSTABLE'
    } else if (ret != 0) {
      currentBuild.result = 'FAILURE'
      // If you do not manually error the status will be set to "failed", but the
      // pipeline will still run the next stage.
      error("Stage 1 failed with exit code ${ret}")
    }
  }
}

पाइपलाइन सिंटैक्स जनरेटर आपको उन्नत टैब में यह दिखाता है:

Question 12

मैंने सोचा कि मैं ऐसे लोगों के लिए एक और उत्तर दूंगा जो कुछ इसी तरह की तलाश में हों।

हमारे निर्माण कार्य में हमारे पास ऐसे मामले हैं जहां हम चाहते हैं कि निर्माण जारी रहेगा, लेकिन अस्थिर के रूप में चिह्नित किया जाएगा। हमारे लिए यह संस्करण संख्याओं से संबंधित है।

इसलिए, मैं बिल्ड पर एक शर्त स्थापित करना चाहता था और अगर वह शर्त पूरी हो जाती है तो बिल्ड को अस्थिर कर सकता है।

मैंने निर्माण चरण के रूप में सशर्त चरण (एकल) विकल्प का उपयोग किया।

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

मैंने ग्रूवी कमांड का उपयोग किया और स्क्रिप्ट को निम्नलिखित सेट किया

import hudson.model.*

def build = Thread.currentThread().executable
build.@result = hudson.model.Result.UNSTABLE

return

यह काफी अच्छा काम करता है।

मैं यहाँ समाधान पर ठोकर खाई

http://tech.akom.net/archives/112-Marking-Jenkins-build-UNSTABLE-from-environment-inject-groovy-script.html

Question 13

मौजूदा उत्तरों के लिए एक हल्के विकल्प के रूप में, आप Groovy स्क्रिप्ट कंसोल को एक्सेस करने के लिए एक साधारण HTTP POST के साथ बिल्ड रिजल्ट सेट कर सकते हैं :

    curl -X POST \
     --silent \
     --user "$YOUR_CREDENTIALS" \
     --data-urlencode "script=Jenkins.instance.getItemByFullName( '$JOB_NAME' ).getBuildByNumber( $BUILD_NUMBER ).setResult( hudson.model.Result.UNSTABLE )" $JENKINS_URL/scriptText

लाभ:

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

इस समाधान के लिए, आपके पर्यावरण को इन शर्तों को पूरा करना चाहिए:

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

Question 14

अस्थिर बनाने के लिए एक आसान तरीका, आपके "निष्पादित शेल" ब्लॉक में है, चलाएं exit 13

Question 15

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

function safemake {
  make "$@"
  if [ "$?" -ne 0 ]; then
    echo "ERROR: BUILD FAILED"
    exit 1
  else
    echo "BUILD SUCCEEDED"
  fi
}