🥇 დინამიური პარამეტრების შექმნა ჯენკინსის სამუშაოში, ან როგორ გახადოთ თქვენი დავალება მომხმარებლისთვის მოსახერხებელი

Კარგი დღე, ჰაბრ!

დღეს მინდა გაგიზიაროთ გამოყენების ერთ-ერთი გზა Active Choices Plugin შეასრულე დავალება Jenkins ყველაზე ერთიანი და მოსახერხებელი.

შესავალი

ისეთი აბრევიატურა, როგორიცაა DevOps, აღარ არის ახალი IT საზოგადოებისთვის. ბევრისთვის ფრაზა „do DevOps“ ასოცირდება რაიმე სახის ჯადოსნურ ღილაკთან, დაწკაპუნებისას აპლიკაციის კოდი ავტომატურად გადაიქცევა განლაგებულ და შემოწმებულ აპლიკაციად (ფაქტობრივად ყველაფერი უფრო რთულია, მაგრამ ჩვენ აბსტრაქციას ვაკეთებთ ყველა პროცესისგან).

ასე რომ, ჩვენ მივიღეთ ბრძანება, გაგვეკეთებინა ასეთი ჯადოსნური ღილაკი, რათა ადმინისტრატორებმა განათავსონ აპლიკაცია ერთი დაწკაპუნებით. ამ ამოცანის განხორციელების სხვადასხვა სახეობა არსებობს: რომელიმე მყისიერი მესინჯერისთვის ბოტის დაწერიდან ცალკე აპლიკაციის შემუშავებამდე. მიუხედავად ამისა, ამ ყველაფერს ერთი და იგივე მიზანი აქვს - აპლიკაციის შექმნისა და დანერგვის დაწყება რაც შეიძლება გამჭვირვალე და მოსახერხებელი იყოს.

ჩვენს შემთხვევაში გამოვიყენებთ Jenkins.

დავალება

შექმენით მოსახერხებელი ჯენკინსის სამუშაო, რომელიც დაიწყებს გარკვეული ვერსიის შერჩეული მიკროსერვისის აშენებას და (ან) დანერგვას.

Შესაყვანი მონაცემები

ჩვენ გვაქვს რამდენიმე საცავი, რომელიც შეიცავს სხვადასხვა მიკროსერვისის საწყის კოდს.

პარამეტრების განსაზღვრა

შემდეგი პარამეტრები უნდა მივიღოთ, როგორც შეყვანა ჩვენს სამუშაოში:

საცავის URL მიკროსერვისის კოდით, რომელიც გვინდა ავაშენოთ და გავავრცელოთ სამუშაოს შესრულებისას.
საკომისიოს ID, საიდანაც მოხდება აშენება.

ისე

ამ ამოცანის შესრულების უმარტივესი გზაა String ტიპის ორი პარამეტრის შექმნა.

ამ შემთხვევაში, მომხმარებელს მოუწევს ხელით შეიყვანოს საცავის გზა და commit id, რაც, როგორც ხედავთ, მთლად მოსახერხებელი არ არის.

როგორც უნდა იყოს

ახლა მოდით ვცადოთ სხვა ტიპის პარამეტრები, რათა განვიხილოთ მისი ყველა უპირატესობა.
შევქმნათ პირველი პარამეტრი ტიპის Choice Parameter, მეორე - Active Choices Reactive Reference Parameter. არჩევანის ტიპის პარამეტრში, ჩვენ ხელით დავამატებთ არჩევანის ველში იმ საცავების სახელებს, სადაც ინახება ჩვენი მიკროსერვისების კოდი.

თუ აუდიტორიას მოეწონება ეს სტატია, შემდეგ სტატიაში მე აღვწერ ჯენკინსში ამოცანების კონფიგურაციის პროცესს, აღწერის გამოყენებით კოდის საშუალებით (Configuration as code), ე.ი. ჩვენ არ დაგვჭირდება საცავის სახელების ხელით შეყვანა და პარამეტრების შექმნა, ყველაფერი ავტომატურად მოხდება (ჩვენი კოდი მიიღებს საცავების ჩამონათვალს SCM-დან და შექმნის პარამეტრს ამ სიით).

მეორე პარამეტრის მნიშვნელობები შეივსება დინამიურად, იმისდა მიხედვით, თუ რა მნიშვნელობას იღებს პირველი პარამეტრი (test1 ან test2), რადგან თითოეულ საცავს აქვს ვალდებულებების საკუთარი სია.

Active Choices რეაქტიული მითითების პარამეტრი აქვს შემდეგი ველები შესავსებად:

სახელი - პარამეტრის სახელი.
Script – კოდი, რომელიც შესრულდება ყოველ ჯერზე, როდესაც შეიცვლება პარამეტრის მნიშვნელობა Referenced პარამეტრის ველიდან (ჩვენს შემთხვევაში, როცა ვირჩევთ test1-სა და test2-ს შორის).
აღწერა - პარამეტრის მოკლე აღწერა.
არჩევანის ტიპი – სკრიპტის მიერ დაბრუნებული ობიექტის ტიპი (ჩვენს შემთხვევაში დავაბრუნებთ html კოდს).
მითითებული პარამეტრი – პარამეტრის დასახელება, რომლის მნიშვნელობაც შეიცვლება, შესრულდება კოდი Script განყოფილებიდან.

მოდით პირდაპირ გავაგრძელოთ ამ პარამეტრის ყველაზე მნიშვნელოვანი ველის შევსება. ჩვენ გვთავაზობენ ორი სახის იმპლემენტაციას ასარჩევად: გამოყენება გროვის სკრიპტი ან Scriptler Script.
ჩვენ ვირჩევთ პირველს, რადგან Scriptler არის მხოლოდ დანამატი, რომელიც ინახავს თქვენ მიერ ადრე დაწერილ სკრიპტებს და საშუალებას გაძლევთ გამოიყენოთ ისინი სხვა ამოცანებში ხელახლა კოპირების ჩასმის გარეშე.

Groovy კოდი არჩეული საცავიდან ყველა ვალდებულების მისაღებად:

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-ს და იღებს ყველა ვალდებულების id და commit შეტყობინებას მოცემული მიკროსერვისისთვის.
როგორც უკვე აღვნიშნეთ, ამ კოდმა უნდა დააბრუნოს html, რომელიც გამოჩნდება გვერდზე აშენება პარამეტრებით Jenkins-ში, ამიტომ Bitbucket-დან მიღებულ ყველა მნიშვნელობას ვახვევთ სიაში და ვამატებთ მათ ასარჩევად.

ყველა ნაბიჯის დასრულების შემდეგ უნდა მივიღოთ ასეთი ლამაზი გვერდი აშენება პარამეტრებით.

თუ თქვენ აირჩიეთ test1 მიკროსერვისი:

თუ თქვენ აირჩიეთ test2 მიკროსერვისი:

დამეთანხმებით, რომ მომხმარებლისთვის ბევრად უფრო მოსახერხებელი იქნება თქვენს ამოცანასთან ამ გზით ინტერაქცია, ვიდრე url-ის ყოველ ჯერზე კოპირება და საჭირო commit id-ის ძიება.

PS ეს სტატია გთავაზობთ ძალიან გამარტივებულ მაგალითს, რომელიც შეიძლება არ იყოს პრაქტიკული გამოყენება ამ ფორმით, რადგან ასამბლეებს აქვთ მრავალი განსხვავებული პარამეტრი, მაგრამ ამ სტატიის მიზანი იყო იმის ჩვენება, თუ როგორ მუშაობს ინსტრუმენტი და არა სამუშაო გადაწყვეტის მიწოდება.

PSS როგორც ადრე დავწერე, თუ ეს სტატია სასარგებლოა, მაშინ შემდეგი იქნება ჯენკინსის ამოცანების დინამიური კონფიგურაცია კოდის საშუალებით.

წყარო: www.habr.com

შესავალი

დავალება

Შესაყვანი მონაცემები

პარამეტრების განსაზღვრა

ისე

როგორც უნდა იყოს

ახალი კომენტარის დამატება პასუხის გასაუქმებლად

ახალი კომენტარის დამატება