🥇Jenkins 작업에서 동적 매개변수 생성 또는 작업을 사용자 친화적으로 만드는 방법

안녕하세요, 하브 르!

오늘은 그 활용법 중 하나를 공유해볼까 합니다. 활성 선택 플러그인 에서 작업을 수행 젠킨스 가장 통일되고 사용자 친화적입니다.

소개

DevOps와 같은 약어는 더 이상 IT 커뮤니티에 새로운 것이 아닙니다. 많은 사람들에게 "DevOps 수행"이라는 문구는 일종의 마법 버튼과 연관되어 있습니다. 클릭하면 애플리케이션 코드가 자동으로 배포 및 테스트된 애플리케이션으로 전환됩니다(모든 것이 실제로는 더 복잡하지만 우리는 모든 프로세스에서 추상화하고 있습니다).

그래서 우리는 관리자가 클릭 한 번으로 애플리케이션을 배포할 수 있도록 이런 마법의 버튼을 만들어 달라는 주문을 받았습니다. 이 작업에는 인스턴트 메신저용 봇 작성부터 별도의 애플리케이션 개발까지 다양한 유형의 구현이 있습니다. 그럼에도 불구하고 이 모든 목표는 동일합니다. 즉, 애플리케이션의 빌드 및 배포를 최대한 투명하고 편리하게 시작하는 것입니다.

우리의 경우에는 젠킨스.

태스크

특정 버전의 선택된 마이크로서비스의 빌드 및/또는 배포를 시작하는 편리한 Jenkins 작업을 만듭니다.

입력 데이터

우리는 다양한 마이크로서비스의 소스 코드를 포함하는 여러 저장소를 보유하고 있습니다.

매개변수 정의

다음 매개변수가 작업에 대한 입력으로 수신되어야 합니다.

작업을 실행할 때 빌드하고 배포하려는 마이크로서비스 코드가 포함된 저장소의 URL입니다.
빌드가 발생할 커밋의 ID입니다.

그대로

이 작업을 수행하는 가장 쉬운 방법은 문자열 유형의 매개변수 두 개를 생성하는 것입니다.

이 경우 사용자는 리포지토리 경로와 커밋 ID를 수동으로 입력해야 하는데 이는 완전히 편리하지는 않습니다.

있는 그대로

이제 다른 유형의 매개변수를 사용해 모든 장점을 고려해 보겠습니다.
Choice 매개변수 유형으로 첫 번째 매개변수를 생성하고, 두 번째 매개변수는 Active Choices Reactive Reference 매개변수를 생성해 보겠습니다. Choice 유형의 매개변수에서 Choices 필드에 마이크로서비스 코드가 저장된 리포지토리 이름을 수동으로 추가합니다.

독자가 이 기사를 좋아한다면 다음 기사에서는 코드를 통한 설명(코드로 구성)을 사용하여 Jenkins에서 작업을 구성하는 프로세스를 설명하겠습니다. 수동으로 저장소 이름을 입력하고 매개변수를 생성할 필요가 없으며 모든 것이 자동으로 발생합니다(우리 코드는 SCM에서 저장소 목록을 수신하고 이 목록을 사용하여 매개변수를 생성합니다).

각 저장소에는 자체 커밋 목록이 있으므로 두 번째 매개변수의 값은 첫 번째 매개변수가 취하는 값(test1 또는 test2)에 따라 동적으로 채워집니다.

활성 선택 반응 참조 매개변수 다음 필드를 채워야 합니다.

성함 – 매개변수 이름.
스크립트 – 참조 매개변수 필드의 매개변수 값이 변경될 때마다 실행될 코드입니다(이 경우 test1과 test2 중 하나를 선택할 때).
상품 설명 – 매개변수에 대한 간략한 설명.
선택 유형 – 스크립트에 의해 반환된 개체 유형(이 경우 html 코드가 반환됩니다).
참조된 매개변수 – 매개변수의 이름, 값이 변경되면 스크립트 섹션의 코드가 실행됩니다.

이 매개변수에서 가장 중요한 필드를 직접 작성해 보겠습니다. 선택할 수 있는 두 가지 유형의 구현이 제공됩니다. 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)을 입력으로 받고 다음으로 요청을 보냅니다. 비트 버켓 (방법 getCommitsForMicroservice) API를 사용하여 특정 마이크로서비스에 대한 모든 커밋의 ID와 커밋 메시지를 가져옵니다.
앞서 언급했듯이 이 코드는 페이지에 표시될 html을 반환해야 합니다. 매개변수를 사용하여 빌드 Jenkins에서는 Bitbucket에서 수신한 모든 값을 목록에 래핑하고 선택 항목에 추가합니다.

모든 단계를 완료하면 이렇게 아름다운 페이지가 나타납니다. 매개변수를 사용하여 빌드.

test1 마이크로서비스를 선택한 경우:

test2 마이크로서비스를 선택한 경우:

매번 URL을 복사하고 필요한 커밋 ID를 찾는 것보다 이러한 방식으로 사용자가 작업과 상호 작용하는 것이 훨씬 더 편리하다는 데 동의하십시오.

PS 이 문서에서는 어셈블리에 더 많은 다양한 매개변수가 있기 때문에 이 형식에서는 실제로 사용되지 않을 수 있는 매우 간단한 예를 제공합니다. 그러나 이 문서의 목적은 도구 작동 방식을 보여주는 것이지 작동하는 솔루션을 제공하는 것이 아닙니다.

PSS 앞서 쓴 것처럼 이 기사가 도움이 되었다면 다음 기사는 다음 내용에 관한 것입니다. 코드를 통한 Jenkins 작업의 동적 구성.

출처 : habr.com

Jenkins 작업에서 동적 매개변수 생성 또는 작업을 사용자 친화적으로 만드는 방법

소개

태스크

입력 데이터

매개변수 정의

그대로

있는 그대로

코멘트를 추가 답장을 취소