Jenkins pipeline tutorials - 4. Jenkins Job 생성하기

개요

아래 스펙의 jenkins를 설치하는것을 목적으로 합니다.

jenkins(host container)를 docker image를 사용하여 구동합니다.
jenkins login을 github auth와 연동합니다.
UI로 blueocean을 사용합니다.
Jenkins job item 으로 pipeline job(organization, multi branch) 을 사용합니다.
Groovy 언어로 작성된 Jenkinsfile 을 사용합니다.
메일발송으로 emailext plugin를 사용합니다.
jenkins job을 docker agent를 사용하여 구동합니다.(위의 host container와 구분되는 runner container 입니다)

1. Install Jenkins
- 1-1. docker 설치
- 1-2. jenkins container 실행
- 1-3. jenkins web 접속
2. Install github authentication plugin
- 2-1. plugin 설치
- 2-2. plugin 설정
3. Webhook settings
4. Jenkins Job 생성하기
- 4-1. Pipeline Organization job 생성하기
- 4-2. tag automatic trigger 문제
- 4-3. tag automatic trigger 문제해결
(미작성)
- 1. jenkins concurrency

과정

4. Jenkins Job 생성하기

4-1. Pipeline Organization job 생성하기

이제 jenkins job을 생성할차례입니다.
pipeline organization job 을 추가합니다.
organization 전체를 주기적으로 스캔하고, jenkinsfile이 있는 repository에 자동으로 명시된 task를 수행합니다.
먼저, 등록할 Organization 에 Owner 권한이 있는 계정이 필요합니다.
new item > GitHub Organization
Projects > Github Organization > Credentials - username and password 선택
Behaviors > Add > discovery tags 추가
Orphaned Item Strategy > Discard old items > Days to keep old items
저장 용량이 부담스러울것 같아 30일을 지정했습니다.(자유)
Save 클릭
이제 Organization에 가보면 hook이 자동으로 생성된것을 확인할수있습니다.
https://github.com/organizations/ORGANIZATION-NAME/settings/hooks
미리 Jenkinsfile을 넣어놓았던 repository는 CI job 실행까지 완료했네요.
ref: https://support.cloudbees.com/hc/en-us/articles/115003015711-GitHub-Webhook-Organization-Folder

4-2. tag automatic trigger 문제

위의 설정에는 한가지 문제가 있습니다. tag를 push해도 jenkins는 job을 수행하지않습니다.
위의 사항을 테스트해보기위해, Jenkinsfile을 아래와 같이 두고 tag를 push해봅니다.
- 아래 jenkinsfile의 의도는 tag를 push햇을때 when { tag '*' } 아래부분을 추가로 수행시키는것입니다.

#!/usr/bin/env groovy

pipeline {
    agent {
        docker { image 'centos/python-36-centos7:1' }
    }

    stages {
        stage('printenv') {
            steps {
                sh 'printenv'
                sh 'python --version'
            }
        }

        stage('minimal test') {
            steps {
                echo 'minimal test'
            }
        }

        stage('full test') {
            when { anyOf { branch 'master'; branch 'PR-*' } }
            steps {
                echo 'full test'
            }
        }

        stage('deploy') {
            when { tag '*' }
            steps {
                echo 'deploy'
            }
        }
    }

    post {
        always {
            echo 'done...'
        }
        success {
            echo 'success'
        }
        failure {
            echo 'failure'
        }
    }
}

tag push
push 결과로 Jenkins 작업이 돌아가지 않습니다.
의도대로라면 아래의 캡쳐처럼 tag branch의 job이 돌아가야합니다.
Plugin issue를 찾아보니, tags에 의해 빌드가 일어나지않는것이 의도된 설계라고합니다.
Ref: No automatic builds for tags - Pileline: Organization, Multibranch
이는 최초 jenknis 가 오래된 tag를 모두 빌드해버리면서, CI 서버에 부하가 걸리는것을 방지하는 설계입니다.
이를 해결하기위해서는 build strategy plugin 설정이 필요합니다.
Ref: https://wiki.jenkins.io/display/JENKINS/GitHub+Branch+Source+Plugin

4-3. tag automatic trigger 문제해결

basic branch build strategies plugin을 설치해서 위의 문제를 해결합니다.
manage jenkins > plugin manager > available > basic branch build strategies 설치

item > configure > Project를 보면 Build strategies가 새로 생긴걸 확인할 수 있습니다.
Change requests(PR을 의미합니다), Tags를 추가합니다.
참고: 이때 Tags에서 ignore tags older than - 7 옵션은 생성된지 7일이 지난 tag는 최초 tag indexing 단계에서 job을 일으키지 않는다는 옵션입니다.
Ref: https://github.com/jenkinsci/basic-branch-build-strategies-plugin/blob/master/docs/user.adoc
이번에는 tag push event가 재대로 jenkins job을 유발하는것을 확인할 수 있습니다.
deploy stage 를 실행했습니다.