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

शुभ दिन, Habr!

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

परिचय

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

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

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

कार्य

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

इनपुट डेटा

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

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

निम्नलिखित पैरामीटर हमारे कार्य में इनपुट के रूप में प्राप्त होने चाहिए:

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

जैसा है

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

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

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

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

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

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

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

नाम - मापदण्ड नाम।
लिपि - कोड जो हर बार संदर्भित पैरामीटर फ़ील्ड से पैरामीटर का मान बदलने पर निष्पादित किया जाएगा (हमारे मामले में, जब हम टेस्ट 1 और टेस्ट 2 के बीच चयन करते हैं)।
Description - पैरामीटर का संक्षिप्त विवरण.
पसंद का प्रकार - स्क्रिप्ट द्वारा लौटाए गए ऑब्जेक्ट का प्रकार (हमारे मामले में हम 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) अपने एपीआई का उपयोग करके, और किसी दिए गए माइक्रोसर्विस के लिए सभी कमिट की आईडी और कमिट संदेश प्राप्त करता है।
जैसा कि पहले उल्लेख किया गया है, इस कोड को HTML लौटाना चाहिए जो पृष्ठ पर प्रदर्शित किया जाएगा पैरामीटर्स के साथ निर्माण करें जेनकींस में, इसलिए हम बिटबकेट से सभी प्राप्त मूल्यों को एक सूची में लपेटते हैं और उन्हें चयन में जोड़ते हैं।

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

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

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

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

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

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

स्रोत: www.habr.com

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