Jenkins 완전 가이드

1. Jenkins란?

Jenkins는 빌드, 테스트, 배포를 자동화하는 오픈소스 CI/CD 서버입니다. 2011년 Hudson에서 포크되어 현재까지 가장 널리 쓰이는 자동화 서버로, 방대한 플러그인 생태계가 강점입니다.

2. 설치 (Docker)

services:
  jenkins:
    image: jenkins/jenkins:lts-jdk17
    ports:
      - "8080:8080"   # 웹 UI
      - "50000:50000" # Agent(JNLP) 연결 포트
    volumes:
      - jenkins-data:/var/jenkins_home
      - /var/run/docker.sock:/var/run/docker.sock  # 컨테이너 안에서 docker 명령 사용 시

volumes:
  jenkins-data:yaml

docker compose up -d

# 초기 관리자 비밀번호 확인
docker compose exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
# http://localhost:8080 접속 → 비밀번호 입력 → "Install suggested plugins"bash

3. Freestyle Job vs Pipeline

4. Jenkinsfile 기초

// Jenkinsfile — Declarative Pipeline
pipeline {
  agent any

  environment {
    NODE_ENV = 'production'
  }

  stages {
    stage('Checkout') {
      steps { checkout scm }
    }
    stage('Install') {
      steps { sh 'npm ci' }
    }
    stage('Test') {
      steps { sh 'npm test -- --ci' }
      post {
        always { junit 'reports/junit.xml' }
      }
    }
    stage('Build') {
      steps { sh 'npm run build' }
    }
    stage('Deploy') {
      when { branch 'main' }
      steps { sh './deploy.sh production' }
    }
  }

  post {
    success { echo '✅ 파이프라인 성공' }
    failure { slackSend channel: '#ci', message: "❌ 빌드 실패: ${env.BUILD_URL}" }
  }
}groovy

5. Credentials & 파라미터

// Manage Jenkins → Credentials 에 등록된 값을 파이프라인에서 사용
pipeline {
  agent any
  environment {
    DOCKERHUB = credentials('dockerhub-creds')  // username/password 쌍
    API_KEY   = credentials('api-key-secret')   // secret text
  }
  parameters {
    choice(name: 'ENV', choices: ['staging', 'production'], description: '배포 환경')
    booleanParam(name: 'SKIP_TESTS', defaultValue: false, description: '테스트 스킵 여부')
  }
  stages {
    stage('Login') {
      steps {
        sh 'echo $DOCKERHUB_PSW | docker login -u $DOCKERHUB_USR --password-stdin'
      }
    }
    stage('Test') {
      when { expression { !params.SKIP_TESTS } }
      steps { sh 'npm test' }
    }
    stage('Deploy') {
      steps { sh "./deploy.sh ${params.ENV}" }
    }
  }
}groovy

6. Multibranch Pipeline & Webhook

Multibranch Pipeline은 저장소의 모든 브랜치/PR을 자동으로 스캔해 각각의 Jenkinsfile로 개별 파이프라인을 생성합니다.

// New Item → Multibranch Pipeline
Branch Sources: GitHub
Repository: https://github.com/org/repo
Discover branches: All branches
Discover pull requests: Merging the pull request with the current target branch
Scan repository triggers: Periodically (또는 Webhook)

# GitHub → Settings → Webhooks
Payload URL: http://jenkins.example.com/github-webhook/
Content type: application/json
Events: Push, Pull requestbash

7. Agent & 분산 빌드

Controller에 직접 빌드를 실행하면 부하와 보안 위험이 커집니다. 실제 빌드는 별도 Agent에서 실행하는 것이 표준입니다.

// Jenkinsfile에서 특정 라벨의 Agent 지정
pipeline {
  agent { label 'linux && docker' }
  stages {
    stage('Build') {
      steps { sh 'make build' }
    }
  }
}

// Kubernetes 기반 동적 Agent (Kubernetes 플러그인)
pipeline {
  agent {
    kubernetes {
      yaml '''
        apiVersion: v1
        kind: Pod
        spec:
          containers:
          - name: node
            image: node:20
            command: ["cat"]
            tty: true
      '''
    }
  }
  stages {
    stage('Build') {
      steps { container('node') { sh 'npm ci && npm run build' } }
    }
  }
}groovy

8. Docker/Kubernetes 배포 연동

// 이미지 빌드 & 레지스트리 푸시 & K8s 롤아웃
pipeline {
  agent any
  environment {
    IMAGE = "registry.example.com/myapp:${env.BUILD_NUMBER}"
    KUBECONFIG = credentials('kubeconfig-prod')
  }
  stages {
    stage('Docker Build') {
      steps { sh 'docker build -t $IMAGE .' }
    }
    stage('Push') {
      steps {
        sh 'echo $DOCKERHUB_PSW | docker login -u $DOCKERHUB_USR --password-stdin'
        sh 'docker push $IMAGE'
      }
    }
    stage('Deploy to K8s') {
      steps {
        sh 'kubectl set image deployment/myapp app=$IMAGE --kubeconfig=$KUBECONFIG'
        sh 'kubectl rollout status deployment/myapp --kubeconfig=$KUBECONFIG'
      }
    }
  }
}groovy

Kubernetes 리소스와 롤링 업데이트 개념은 Kubernetes 기초 가이드를 참고하세요.

9. 다음 단계