🥇Креирање динамички параметри во задачата на Jenkins, или како да ја направите вашата задача лесна за користење

Добар ден, хебрејски!

Денес би сакал да споделам еден од начините за користење Приклучок Active Choices направете ја задачата во Џенкинс најобединета и најпријатна за корисниците.

Вовед

Таквата кратенка како DevOps веќе не е нешто ново за ИТ заедницата. За многу луѓе, фразата „направи DevOps“ е поврзана со некакво магично копче, кога ќе се кликне, кодот на апликацијата автоматски се претвора во распоредена и тестирана апликација (сè е всушност покомплицирано, но ние се апстрахираме од сите процеси).

Така, добивме наредба да направиме такво магично копче за да можат администраторите да ја распоредат апликацијата со еден клик. Постојат различни видови на имплементација на оваа задача: од пишување бот за кој било од инстант-месинџерите до развој на посебна апликација. Сепак, сето ова ја има истата цел - да го направи започнувањето на изградбата и распоредувањето на апликацијата што е можно потранспарентно и практично.

Во нашиот случај ќе користиме Џенкинс.

Создавање динамични параметри во работата Џенкинс или како да ја направите вашата задача прифатлива за корисниците

Задача

Создадете погодна работа на Џенкинс што ќе започне со изградба и (или) распоредување на избраната микросервис од одредена верзија.

Внесени податоци

Имаме неколку складишта кои го содржат изворниот код на различни микросервиси.

Дефинирање на параметри

Следниве параметри треба да се добијат како влез во нашата работа:

URL-то на складиштето со кодот за микросервис што сакаме да го изградиме и распоредиме при извршување на работата.
ID на заложбата од која ќе се појави изградбата.

КАКО ШТО Е

Најлесен начин да се постигне оваа задача е да се создадат два параметри од типот String.

Во овој случај, корисникот ќе треба рачно да ја внесе патеката до складиштето и идентификаторот за извршување, што, гледате, не е сосема погодно.

КАКО ДА БИДЕТЕ

Сега ајде да пробаме друг тип на параметри за да ги разгледаме сите негови предности.
Ајде да го создадеме првиот параметар со типот Избор параметар, вториот - Active Choices Реактивен референтен параметар. Во параметарот со тип Избор, во полето Избори рачно ќе ги додадеме имињата на складиштата каде што е зачуван кодот на нашите микросервиси.

Ако на публиката и се допадне овој напис, тогаш во следната статија ќе го опишам процесот на конфигурирање на задачите во Џенкинс, користејќи опис преку код (Конфигурација како код), т.е. нема да треба рачно да внесуваме имиња на складишта и да создаваме параметри, сè ќе се случи автоматски (нашиот код ќе добие список со складишта од SCM и ќе создаде параметар со оваа листа).

Вредностите на вториот параметар ќе се пополнуваат динамично, во зависност од тоа која вредност ја зема првиот параметар (тест1 или тест2), бидејќи секое складиште има своја листа на обврски.

Active Choices Реактивен референтен параметар ги има следните полиња за пополнување:

Име – име на параметар.
Скрипта – код кој ќе се извршува секогаш кога ќе се смени вредноста на параметарот од полето Referenced parameter (во нашиот случај, кога избираме помеѓу test1 и test2).
Опис – краток опис на параметарот.
Тип на избор – видот на објектот што го враќа скриптата (во нашиот случај ќе го вратиме html кодот).
Референциран параметар – името на параметарот, кога ќе се смени вредноста, ќе се изврши кодот од делот Script.

Ајде да продолжиме директно со пополнување на најважното поле во овој параметар. Понудени ни се два вида на имплементација за избор: користење Скрипта Groovy или Скриптлер Скрипта.
Го избираме првото, бидејќи 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) како влез и испраќа барање до Bitbucket (метод getCommitsForMicroservice) користејќи го своето API и ја добива пораката за идентификација и заложба за сите обврски за дадена микросервис.
Како што споменавме порано, овој код треба да врати html што ќе биде прикажан на страницата Изградба со параметри во Џенкинс, така што ги завиткуваме сите примени вредности од Bitbucket во список и ги додаваме за да изберете.

Откако ќе ги завршиме сите чекори, треба да добиеме толку убава страница Изградба со параметри.

Ако сте ја избрале микросервисот test1:

Ако сте ја избрале микросервисот test2:

Согласете се дека на корисникот ќе му биде многу поудобно да комуницира со вашата задача на овој начин отколку да го копирате URL-то секој пат и да го барате потребниот commit id.

PS Оваа статија дава многу поедноставен пример, кој можеби нема да биде од практична употреба во оваа форма, бидејќи склоповите имаат многу повеќе различни параметри, но целта на овој напис беше да покаже како работи алатката, а не да обезбеди работно решение.

ПСС Како што напишав порано, ако овој напис е корисен, тогаш следниот ќе биде за динамична конфигурација на задачите на Џенкинс преку код.

Извор: www.habr.com