🥇जेनकिंस जॉब में डायनामिक पैरामीटर बनाना, या अपने कार्य को उपयोगकर्ता के अनुकूल कैसे बनाएं

शुभ दिन, Habr!

आज मैं आपके साथ इसका उपयोग करने का एक तरीका साझा करना चाहूँगा सक्रिय विकल्प प्लगइन कार्य को इस प्रकार करें जेनकींस उपयोगकर्ता के लिए सबसे अधिक एकीकृत और समझने योग्य।

परिचय

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

इसलिए, हमें एक ऐसा जादुई बटन बनाने का ऑर्डर मिला, जिससे प्रशासक एक क्लिक से एप्लीकेशन को तैनात कर सकें। इस कार्य को क्रियान्वित करने के विभिन्न तरीके हैं: किसी भी मैसेंजर के लिए बॉट लिखने से लेकर एक अलग एप्लिकेशन विकसित करने तक। हालाँकि, इन सबका लक्ष्य एक ही है - एप्लिकेशन के निर्माण और परिनियोजन की शुरूआत को यथासंभव पारदर्शी और सुविधाजनक बनाना।

हमारे मामले में हम उपयोग करेंगे जेनकींस.

जेनकिंस जॉब में गतिशील पैरामीटर बनाना, या अपने कार्य को उपयोगकर्ता-अनुकूल कैसे बनाएं

कार्य

एक सुविधाजनक जेनकिंस जॉब बनाएं जो किसी निश्चित संस्करण के चयनित माइक्रोसर्विस का निर्माण और/या परिनियोजन प्रारंभ करेगा।

इनपुट डेटा

हमारे पास विभिन्न माइक्रोसर्विसेज के स्रोत कोड वाले कई रिपॉजिटरी हैं।

मापदंडों की परिभाषा

हमारे जॉब के इनपुट में निम्नलिखित पैरामीटर दिए जाने चाहिए:

माइक्रोसर्विस कोड वाले रिपॉजिटरी का URL जिसे हम जॉब चलने पर बनाना और परिनियोजित करना चाहते हैं।
उस कमिट की आईडी जिससे निर्माण होगा.

जैसा है

इस कार्य को पूरा करने का सबसे आसान तरीका स्ट्रिंग प्रकार के दो पैरामीटर बनाना है।

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

जैसा कि होना चाहिए

अब आइए एक अन्य प्रकार के पैरामीटर को आज़माकर इसके सभी फायदे देखें।
आइए पहला पैरामीटर Choice Parameter प्रकार से बनाएं, तथा दूसरा - Active Choices Reactive Reference Parameter प्रकार से बनाएं। चॉइस प्रकार वाले पैरामीटर में, हम मैन्युअल रूप से उन रिपॉजिटरी के नाम जोड़ देंगे जहां हमारे माइक्रोसर्विसेज का कोड चॉइस फ़ील्ड में संग्रहीत है।

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

दूसरे पैरामीटर के मान गतिशील रूप से भरे जाएंगे, यह इस बात पर निर्भर करेगा कि पहला पैरामीटर क्या मान लेता है (test1 या test2), क्योंकि प्रत्येक रिपॉजिटरी की अपनी प्रतिबद्धताओं की सूची होती है।

सक्रिय विकल्प प्रतिक्रियाशील संदर्भ पैरामीटर इसमें निम्नलिखित फ़ील्ड भरने हैं:

नाम - मापदण्ड नाम।
लिपि - कोड जो हर बार निष्पादित किया जाएगा जब संदर्भित पैरामीटर फ़ील्ड से पैरामीटर का मान बदल दिया जाएगा (हमारे मामले में, जब हम test1 और test2 के बीच चयन करते हैं)।
विवरण - पैरामीटर का संक्षिप्त विवरण.
विकल्प प्रकार - स्क्रिप्ट द्वारा लौटाए गए ऑब्जेक्ट का प्रकार (हमारे मामले में हम HTML कोड लौटाएंगे)।
संदर्भ पैरामीटर - पैरामीटर का नाम जिसका मान बदलने पर स्क्रिप्ट अनुभाग से कोड निष्पादित होगा।

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

चयनित रिपोजिटरी से सभी कमिट्स प्राप्त करने के लिए ग्रूवी कोड:

AUTH = "логин и пароль в Base64"                           
GIT_URL = "url до вашей SCM (https://bitbucket.org/)"                       
PROJECT_NAME = "имя проектной области, где находятся репозитории"

def htmlBuild() {
    html = """
            <html>
            <head>
            <meta charset="windows-1251">
            <style type="text/css">
            div.grayTable {
            text-align: left;
            border-collapse: collapse;
            }
            .divTable.grayTable .divTableCell, .divTable.grayTable .divTableHead {
            padding: 0px 3px;
            }
            .divTable.grayTable .divTableBody .divTableCell {
            font-size: 13px;
            }
            </style>
            </head>
            <body>
        """

    def commitOptions = ""
    getCommitsForMicroservice(MICROSERVICE_NAME).each {
        commitOptions += "<option style='font-style: italic' value='COMMIT=${it.getKey()}'>${it}</option>"
    }
    html += """<p style="display: inline-block;">
        <select id="commit_id" size="1" name="value">
            ${commitOptions}
        </select></p></div>"""

    html += """
            </div>
            </div>
            </div>
            </body>
            </html>
         """
    return html
}

def getCommitsForMicroservice(microserviceRepo) {
    def commits = [:]
    def endpoint = GIT_URL + "/rest/api/1.0/projects/${PROJECT_NAME}/repos/${microserviceRepo}/commits"
    def conn = new URL(endpoint).openConnection()
    conn.setRequestProperty("Authorization", "Basic ${AUTH}")
    def response = new groovy.json.JsonSlurper().parseText(conn.content.text)
    response.values.each {
        commits.put(it.displayId, it.message)
    }
    return commits
}

return htmlBuild()

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

सभी चरणों को पूरा करने के बाद, हमें इस तरह का एक सुंदर पेज मिलना चाहिए पैरामीटर्स के साथ निर्माण करें.

यदि आपने माइक्रोसर्विस टेस्ट1 चुना है:

यदि आपने माइक्रोसर्विस टेस्ट2 चुना है:

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

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

पीएसएस जैसा कि मैंने पहले लिखा था, यदि यह लेख उपयोगी है, तो अगला लेख इस बारे में होगा कोड के माध्यम से जेनकिंस कार्यों को गतिशील रूप से कॉन्फ़िगर करना.

स्रोत: www.habr.com