📌 [Docker CI/CD 시리즈 3편] Jenkins로 자동 배포 파이프라인 구축하기

📅 2025-06-05

📝 학습 내용

1️⃣ Jenkins란?

Jenkins는 오픈소스 기반의 지속적 통합/지속적 배포(CI/CD) 자동화 도구입니다.

• 소스 코드 변경 → 테스트 → 빌드 → 배포까지 자동화
• 플러그인을 통한 확장성 우수
• 다양한 빌드 트리거, 스케줄링 지원

2️⃣ Jenkins 도커 컨테이너로 실행하기

jenkins:
  image: jenkins
  build:
    context: ./JENKINS
  container_name: jenkins-container
  ports:
    - "9090:8080"     # 웹 UI 접속
    - "50000:50000"   # 에이전트 통신 포트
  volumes:
    - jenkins-data:/var/jenkins_home
    - /var/run/docker.sock:/var/run/docker.sock
  networks:
    - custom-network

3️⃣ 초기 비밀번호 확인 및 설정

docker exec -it jenkins-container sh
cat /var/jenkins_home/secrets/initialAdminPassword

• 웹 접속: http://localhost:9090
• 위 명령으로 출력된 초기 비밀번호 입력
• 권장 플러그인 설치 진행

4️⃣ GitHub 토큰 및 SSH Key 등록

✔️ GitHub Personal Access Token 등록

• Jenkins > 관리 > Credentials > Global → Add Credentials
  • Kind: Secret text
  • ID: github-token
  • Secret: GitHub 발급 토큰

✔️ EC2 SSH Key 등록

• Kind: SSH Username with private key
• ID: ec2-ssh-key
• Username: ec2-user
• Private key: .pem 파일 내용 복붙 (DEPLOY_SERVER.pem)

5️⃣ GitHub Integration Plugin & SSH Agent 설치

• Jenkins 관리 > 플러그인 관리 → 설치
  • GitHub Integration Plugin
  • SSH Agent Plugin

---

6️⃣ Jenkins Pipeline 구성

새로운 파이프라인 생성 (예: DEPLOY_TEST)

• Pipeline > Definition: Pipeline script
• GitHub 저장소 예시:
  • https://github.com/Jaewoong-Hwang/DOCKER.git

📜 Pipeline 코드 예시:

pipeline {
    agent any

    environment {
        GITHUB_REPO = 'https://github.com/STD-INFO-COMPUTING-WEB-2024-07-30/09_DEPLOYMENT.git'
        TARGET_DIR = '05_DOCKER_COMPOSE_DEPLOY'
        EC2_HOST = '43.202.192.42'
        EC2_USER = 'ec2-user'
    }

    stages {
        stage('Clone and Deploy on EC2') {
            steps {
                withCredentials([sshUserPrivateKey(credentialsId: 'ec2-ssh-key', keyFileVariable: 'SSH_KEY')]) {
                    sh """
                        chmod 600 ${SSH_KEY}
                        ssh -i ${SSH_KEY} -o StrictHostKeyChecking=no ${EC2_USER}@${EC2_HOST} "
                            rm -rf DOCKER && \
                            git clone https://github.com/Jaewoong-Hwang/DOCKER.git && \
                            cd DOCKER/05_DOCKER_COMPOSE_DEPLOY && \
                            sudo docker-compose down || true && \
                            sudo docker rm -f $(sudo docker ps -aq) 2>/dev/null || true && \
                            sudo docker rmi -f $(sudo docker images -q) 2>/dev/null || true && \
                            sudo docker-compose build --no-cache && \
                            sudo docker-compose up -d --scale jenkins=0
                        "
                    """
                }
            }
        }
    }

    post {
        success {
            echo '✅ Deployment to EC2 completed successfully!'
        }
        failure {
            echo '❌ Deployment to EC2 failed!'
        }
    }
}

---

🔥 정리

• Jenkins는 GitHub, EC2, Docker와 쉽게 연동 가능
• CI/CD를 위한 자동화 스크립트를 파이프라인으로 구성해 반복 작업 제거
• SSH key, GitHub token, Plugin 설치가 사전 준비로 필수
• Jenkins 컨테이너 하나로도 강력한 CI/CD 운영 가능

🔗 참고 자료

• Jenkins 공식 문서
• Pipeline Syntax Generator
• Jenkins + Docker 가이드

---