📌 Jenkins + Spring Boot 자동 배포 실습 정리

📅 2025-05-28

📝 학습 내용

✅ 1. Jenkins 설치 (Amazon Linux / CentOS 기준)

sudo wget -O /etc/yum.repos.d/jenkins.repo <https://pkg.jenkins.io/redhat-stable/jenkins.repo>
sudo rpm --import <https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key>
sudo yum upgrade -y
sudo yum install -y fontconfig jenkins

---

✅ 2. Jenkins 포트 변경 (8080 → 9090)

sudo vi /lib/systemd/system/jenkins.service
# 70~72줄: 8080 → 9090 수정

sudo systemctl daemon-reload
sudo systemctl start jenkins
sudo systemctl status jenkins

• 브라우저 접속: http://[EC2-IP]:9090
• 초기 관리자 비밀번호:

cat /var/lib/jenkins/secrets/initialAdminPassword

---

✅ 3. /tmp 공간 부족 문제 해결 (Jenkins 경고 제거)

sudo vi /etc/fstab

추가:

tmpfs   /tmp    tmpfs   size=5g,mode=1777   0   0

sudo mount -a
# 적용되지 않으면 재부팅
sudo reboot

---

✅ 4. Jenkins 툴 설정

☑️ JDK (수동 등록)

alternatives --config java
# 예: /usr/lib/jvm/java-21-amazon-corretto.x86_64/

Jenkins > Global Tool Configuration > JDK
→ 자동 설치 ❌ 해제, 위 경로를 JAVA_HOME에 수동 입력

☑️ Gradle (자동 설치)

• Version: 8.14
• Spring Boot 레포지토리의 gradle-wrapper.properties 확인 후 일치시킴

---

✅ 5. 필수 플러그인 설치

• Gradle Plugin
• GitHub Integration
• Post Build Task

---

✅ 6. GitHub 연동 설정

1. GitHub → Settings > Developer Settings > Personal Access Token (classic)
2. Jenkins > Credentials → Add → Kind: Secret Text → 토큰 붙여넣기
3. Jenkins > Configure System > GitHub Servers → 등록

---

✅ 7. Freestyle 프로젝트 생성 및 설정

• Jenkins 대시보드 → New Item → Freestyle project
• GitHub Project 체크 → GitHub 주소 입력
• 소스코드 관리: Git → URL 입력
• Build Steps: Invoke Gradle Script
  • Gradle Version: 8.14
  • Tasks:

clean build

---

✅ 8. 빌드 및 트러블슈팅

• Console Output에서 빌드 로그 확인
• 문제 사례: gradlew가 하위 폴더에 있어 빌드 실패
• 해결: 구조 수정 또는 Jenkins 설정 변경 → 재빌드 성공

---

✅ 9. 빌드 후 자동 배포 (Post-build Task)

Jenkins > 구성 > 빌드 후 조치 → Post build task → 아래 스크립트 등록

#!/bin/bash
JAVA_COMMAND="java -jar"
JAR_PATH="/var/lib/jenkins/workspace/DEPLOY_TEST_SPRINGONLY/build/libs/demo-0.0.1-SNAPSHOT.jar"
TARGET_PID=$(pgrep -f "$JAVA_COMMAND $JAR_PATH")

if [ -z "$TARGET_PID" ]; then
    echo "해당 프로세스가 이미 종료되었습니다."
else
    echo "프로세스 $TARGET_PID 종료 중..."
    kill -9 "$TARGET_PID"
    if ps -p "$TARGET_PID" > /dev/null; then
        echo "종료 실패"
    else
        echo "종료 성공"
    fi
fi

# 애플리케이션 실행 (로그 파일 분리 저장)
nohup java -jar $JAR_PATH > /var/log/springboot-app.log 2>&1 &

📁 참고: /var/log/springboot-app.log 에 로그 저장됨

---

✅ 보안 설정 권장사항

• Jenkins 초기 비밀번호 및 관리자 계정은 강력한 패스워드로 설정
• EC2 인바운드 규칙에서 9090 포트는 본인 IP로 제한 권장
• GitHub 토큰은 꼭 Secret text로 저장하고, 절대 공개 저장소에 노출되지 않도록 주의

---

🔌 포트 정리

포트	용도	설명
8080	Spring Boot 애플리케이션	사용자 접근 (서비스 포트)
9090	Jenkins 웹 UI	운영자 접속용 CI 관리 포트

---

🔗 참고 링크

• Jenkins 설치 가이드 (CentOS)
• GitHub Classic Token 생성
• Gradle 버전 확인

---

😎 느낀 점

• 단순히 Jenkins만 설치하는 게 아니라, CI/CD에 필요한 환경 전체를 고려해야 한다는 걸 체감했다.
• Gradle 자동 설치, GitHub 토큰 인증, 로그 경로 관리 등 운영자 입장에서 놓치기 쉬운 디테일을 배울 수 있었다.
• 특히 Post-build 스크립트를 통한 자동 배포는 정말 뿌듯했다!

---

🧾 요약

• Jenkins 설치 및 포트 변경 → GitHub 연동 → Gradle 빌드 → 자동 재배포까지 실습 완료
• Jenkins는 9090, Spring Boot는 8080 포트 사용
• 자동 배포 시 기존 프로세스 종료 후 새로운 JAR 실행
• 로그 파일 관리, 보안 설정까지 포함된 실습 완료

---