Jenkins + Docker To-Do 프로젝트 구축기

📝 GitHub → Jenkins → Docker 자동배포 구축기

-풀스택 To-Do List 프로젝트-

한글 인코딩이 안되서 깨졌지만 배포는 성공 ㅋㅋ

https://github.com/raisedeveloper/Svelte-todo-app-docker_compose/

1. 프로젝트 개요

이번 프로젝트는 프론트엔드(Svelte), 백엔드(PHP), 데이터베이스(MySQL)로 구성된 풀스택 To-Do List 애플리케이션을
Docker Compose로 통합 배포하고,
GitHub Webhook + Jenkins를 연동해 Push 시 자동으로 빌드 & 배포가 트리거되는 파이프라인을 구축한 사례입니다.

XAMPP 같은 로컬 서버 없이,
Docker 기반 개발 & 운영 환경을 통일하고
Jenkins를 통해 Push → 빌드 & 배포까지 자동화된 DevOps 환경을 구현했습니다.

 

2. 전체 흐름도

GitHub Push
    ↓ (Webhook Trigger)
Jenkins 빌드 트리거
    ↓ (SCM Polling & Git Pull)
Docker Compose Build & Up
    ↓
배포 완료

 

✨ 핵심 포인트:

• GitHub → Webhook → Jenkins 자동 트리거
• Jenkins Freestyle Job으로 빌드/배포 자동화
• Docker Compose로 서비스 일괄 배포

3. 구축 스택

• GitHub Webhook + ngrok 터널링 (로컬 개발환경 연동)
• Jenkins Freestyle Job 자동화
• Git SCM Polling 기반 변경사항 감지
• Docker Compose로 프론트엔드/백엔드/DB 통합 배포

 

4. Jenkins 자동배포 설정

✅ Jenkins Freestyle Job 구성:

1. Source Code Management
   • GitHub 레포지토리 연결
2. Build Triggers
   • GitHub hook trigger for GITScm polling 활성화
3. Build Steps
   • Execute Shell:

docker-compose down || true
docker-compose build
docker-compose up -d

 

✅ 결과:

• GitHub에서 Push하면 Jenkins가 자동으로 빌드/배포를 수행
• Docker Compose로 통합된 서비스 배포 자동화

 

5. 실제 배포 과정 (콘솔 출력 예시)

Cloning repository https://github.com/raisedeveloper/Svelte-todo-app-docker_compose
Checking out Revision (커밋 해시)
[BUILD] Docker 이미지 빌드 중...
[DEPLOY] Docker 컨테이너 실행 중...
Finished: SUCCESS

6. 마무리 (배운점)

이번 프로젝트를 통해

• GitHub → Jenkins → Docker 배포 자동화의 전체 흐름
• Webhook 기반 트리거 방식
• Freestyle Job으로 간단하게 구축하는 CI/CD
  를 직접 구축해보며 실무형 DevOps 환경을 경험할 수 있었습니다.

완벽한 자동화는 아니어도, Push 시 바로 반영되는 배포 파이프라인을 직접 만드는 것 자체가 큰 수확이었습니다.