[Jenkins] 파이프라인(Pipeline) 문법

파이프라인의 종류

• 표준은 Declarative Pipeline

구분	Declarative Pipeline	Scripted Pipeline
문법	구조화된 DSL (추천 방식)	Groovy 기반 자유도 높음
가독성	높음	낮음
유형	선연형 (Declarative)	명령형 (Imperative)
파일 형식	Jenkinsfile	Jenkinsfile
대표 구문	pipeline { ... }	node { ... }

 

 

Declarative Pipeline 기본 구조

pipeline {
    agent any       // 실행할 노드 (any: 모든 노드에서 실행 가능)

    environment {   // 환경 변수 설정
        JAVA_HOME = '/usr/lib/jvm/java-11'
        PATH = "${JAVA_HOME}/bin:${env.PATH}"
    }

    options {       // 빌드 옵션
        timeout(time: 30, unit: 'MINUTES')
        buildDiscarder(logRotator(numToKeepStr: '10'))
    }

    stages {        // 빌드 단계 정의
        stage('Checkout') {
            steps {
                echo "Git 저장소에서 소스코드 가져오기"
                checkout scm
            }
        }

        stage('Build') {
            steps {
                echo "빌드 중..."
                sh 'mvn clean package -DskipTests'
            }
        }

        stage('Test') {
            steps {
                echo "테스트 실행"
                sh 'mvn test'
            }
        }

        stage('Deploy') {
            steps {
                echo "서버에 배포 중..."
                sh './deploy.sh'
            }
        }
    }

    post {          // 빌드 후 처리
        always {
            echo "빌드 종료 후 항상 실행"
        }
        success {
            echo "✅ 빌드 성공"
        }
        failure {
            echo "❌ 빌드 실패"
        }
    }
}

 

 

주요 구문

• pipeline {} : Declarative 파이프라인의 루트 블록
• agent any : 파이프라인 실행할 Jenkins 노드 지정 (label, docker, none 등 가능)
• stages {} / stage('name') : 여러 단계 정의 (빌드, 테스트, 배포 등)
• steps {} : 각 단계에서 수행할 명령어 목록
• environment {} : 파이프라인 전역 환경 변수 설정
• options {} : 타임아웃, 빌드 유지 개수 등 파이프라인 옵션 지정
• post {} : 빌드 성공, 실패, 항상 실행 시 처리 로직 지정
• when {} : 조건부 실행

 

자주 사용하는 고급문법

• 특정 브랜치에서만 실행하기

stage('Deploy') {
    when {
        branch 'main'
    }
    steps {
        echo "배포 실행"
    }
}

 

• 사용자 입력 대기

stage('Approval') {
    steps {
        input message: '배포를 진행하시겠습니까?', ok: '배포 진행'
    }
}

 

• 병렬 실행 (parallel)

stage('Parallel Test') {
    parallel {
        stage('Unit Tests') {
            steps {
                sh 'mvn test'
            }
        }
        stage('Integration Tests') {
            steps {
                sh 'mvn verify'
            }
        }
    }
}

 

• 매트릭스 빌드 (Matrix)

matrix {
    axes {
        axis {
            name 'JAVA_VERSION'
            values '8', '11'
        }
        axis {
            name 'OS'
            values 'ubuntu', 'centos'
        }
    }
    stages {
        stage('Build') {
            steps {
                echo "Building on ${OS} with Java ${JAVA_VERSION}"
            }
        }
    }
}

 

• 파일 존재 여부 조건 실행

stage('Optional Step') {
    when {
        expression { fileExists('Dockerfile') }
    }
    steps {
        echo "Dockerfile 존재 — Docker 빌드 실행"
        sh 'docker build -t myapp .'
    }
}

 

 

Scripted Pipeline 예시 (Groovy 기반)

• Scripted 방식은 Groovy 문법을 거의 그대로 사용할 수 있어 복잡한 조건문, 반복문, 에러처리 로직을 세밀하게 제어 가능

node {
    stage('Checkout') {
        checkout scm
    }

    stage('Build') {
        try {
            sh 'mvn clean package'
        } catch (err) {
            echo "Build failed: ${err}"
            currentBuild.result = 'FAILURE'
        }
    }

    stage('Deploy') {
        if (env.BRANCH_NAME == 'main') {
            sh './deploy.sh'
        } else {
            echo "배포 스킵 (브랜치: ${env.BRANCH_NAME})"
        }
    }
}

 

 

Jenkins 환경 변수

• env.BUILD_NUMBER - 빌드 번호
• env.BRANCH_NAME - 현재 브랜치 이름
• env.JOB_NAME - Jenkins Job 이름
• env.WORKSPACE - Jenkins 작업 디렉토리 경로
• env.GIT_COMMIT - 현재 GIT 커밋 해시
• env.BUILD_URL - Jenkins 빌드 URL
• params.PARAM_NAME - 사용자 정의 파라미터 접근 시 사용