1. 환경 변수 (Environment Variables) 🌍

파이프라인에서 환경 변수는 정말 중요한 역할을 해. 빌드 번호, 브랜치 이름, 자격 증명 등 다양한 정보를 저장하고 참조하는 데 사용되지.

pipeline {
    agent any
    
    environment {
        // 전역 환경 변수 설정
        MAVEN_OPTS = '-Xmx2048m'
        VERSION = '1.0.0'
    }
    
    stages {
        stage('Build') {
            environment {
                // 스테이지 레벨 환경 변수
                DATABASE_URL = credentials('db-credentials')
            }
            steps {
                // 내장 환경 변수 사용
                echo "빌드 번호: ${env.BUILD_NUMBER}"
                echo "브랜치 이름: ${env.BRANCH_NAME}"
                echo "Jenkins URL: ${env.JENKINS_URL}"
                
                // 사용자 정의 환경 변수 사용
                echo "Maven 옵션: ${env.MAVEN_OPTS}"
                echo "버전: ${env.VERSION}"
                
                // 스테이지 레벨 환경 변수 사용
                sh "curl -u ${DATABASE_URL_USR}:${DATABASE_URL_PSW} ${DATABASE_URL}"
            }
        }
    }
}

Jenkins에서 제공하는 기본 환경 변수도 많이 있어. BUILD_NUMBER, JOB_NAME, WORKSPACE, BRANCH_NAME 등이 대표적이지. 이런 변수들을 활용하면 동적인 파이프라인을 구성할 수 있어!

2. 파라미터 (Parameters) 🎛️

파이프라인 실행 시 사용자가 입력할 수 있는 파라미터를 정의할 수 있어. 이를 통해 같은 파이프라인을 다양한 설정으로 실행할 수 있지.

pipeline {
    agent any
    
    parameters {
        string(name: 'DEPLOY_ENV', defaultValue: 'staging', description: '배포할 환경')
        choice(name: 'REGION', choices: ['us-east-1', 'eu-west-1', 'ap-northeast-2'], description: '배포 리전')
        booleanParam(name: 'RUN_TESTS', defaultValue: true, description: '테스트 실행 여부')
        password(name: 'DATABASE_PASSWORD', defaultValue: '', description: '데이터베이스 비밀번호')
    }
    
    stages {
        stage('Deploy') {
            steps {
                echo "배포 환경: ${params.DEPLOY_ENV}"
                echo "선택한 리전: ${params.REGION}"
                
                script {
                    if (params.RUN_TESTS) {
                        echo "테스트를 실행합니다."
                        // 테스트 실행 코드
                    } else {
                        echo "테스트를 건너뜁니다."
                    }
                }
                
                // 비밀번호 사용 (실제로는 이렇게 직접 출력하면 안 됨)
                sh "deploy-script.sh --password ${params.DATABASE_PASSWORD}"
            }
        }
    }
}

파라미터를 사용하면 같은 파이프라인을 재사용하면서 다양한 상황에 대응할 수 있어. 특히 여러 환경(개발, 테스트, 스테이징, 프로덕션)에 배포할 때 유용하지!

3. 조건부 실행 (Conditional Execution) 🔀

파이프라인의 특정 부분을 조건에 따라 실행하거나 건너뛰고 싶을 때 사용해. 브랜치, 환경, 파라미터 등 다양한 조건을 기준으로 설정할 수 있어.

pipeline {
    agent any
    
    stages {
        stage('Build') {
            steps {
                echo '항상 빌드합니다.'
            }
        }
        
        stage('Deploy to Staging') {
            when {
                branch 'develop'  // develop 브랜치일 때만 실행
            }
            steps {
                echo 'Staging 환경에 배포합니다.'
            }
        }
        
        stage('Deploy to Production') {
            when {
                allOf {
                    branch 'main'  // main 브랜치이고
                    expression { return params.DEPLOY_TO_PROD == true }  // 배포 파라미터가 true일 때
                }
            }
            steps {
                echo 'Production 환경에 배포합니다.'
            }
        }
        
        stage('Performance Tests') {
            when {
                expression { return env.PERFORMANCE_TESTS_ENABLED == 'true' }  // 환경 변수 기반 조건
            }
            steps {
                echo '성능 테스트를 실행합니다.'
            }
        }
    }
}

when 지시어는 선언적 파이프라인에서만 사용할 수 있어. 스크립트 파이프라인에서는 일반적인 Groovy if 문을 사용해야 해.

4. 병렬 실행 (Parallel Execution) ⚡

빌드 시간을 단축하기 위해 여러 작업을 동시에 실행할 수 있어. 특히 테스트가 많은 프로젝트에서 유용하지!

pipeline {
    agent any
    
    stages {
        stage('Build') {
            steps {
                echo '빌드 중...'
            }
        }
        
        stage('Tests') {
            parallel {
                stage('Unit Tests') {
                    steps {
                        echo '단위 테스트 실행 중...'
                        sh 'npm run test:unit'
                    }
                }
                stage('Integration Tests') {
                    steps {
                        echo '통합 테스트 실행 중...'
                        sh 'npm run test:integration'
                    }
                }
                stage('UI Tests') {
                    steps {
                        echo 'UI 테스트 실행 중...'
                        sh 'npm run test:ui'
                    }
                }
            }
        }
        
        stage('Deploy') {
            steps {
                echo '배포 중...'
            }
        }
    }
}

병렬 실행을 활용하면 빌드 시간을 크게 단축할 수 있어. 하지만 동시에 실행되는 작업 수가 많아지면 Jenkins 서버의 리소스 사용량도 증가한다는 점을 고려해야 해!

5. 공유 라이브러리 (Shared Libraries) 📚

여러 파이프라인에서 공통으로 사용되는 코드를 라이브러리로 만들어 재사용할 수 있어. 코드 중복을 줄이고 유지보수성을 높이는 데 큰 도움이 돼!

먼저 Jenkins에서 공유 라이브러리를 설정하고:

// Jenkins 관리 > 시스템 설정 > Global Pipeline Libraries에서 설정
// 라이브러리 이름: my-shared-lib
// 기본 버전: main
// 소스 코드 관리: Git
// 프로젝트 저장소: https://github.com/your-org/jenkins-shared-lib.git

그런 다음 파이프라인에서 사용:

@Library('my-shared-lib') _

pipeline {
    agent any
    
    stages {
        stage('Build') {
            steps {
                // 공유 라이브러리의 함수 호출
                script {
                    def buildUtils = new org.example.BuildUtils()
                    buildUtils.compileMaven()
                }
            }
        }
        
        stage('Deploy') {
            steps {
                // 공유 라이브러리의 전역 변수(vars) 사용
                deployToKubernetes(cluster: 'production', namespace: 'app')
            }
        }
    }
}

공유 라이브러리는 대규모 조직이나 여러 프로젝트를 관리하는 팀에게 특히 유용해. 표준화된 파이프라인 코드를 유지하고 모범 사례를 공유하는 데 도움이 되지!