[6주차] 박시현 / [Chore] CI/CD 구축

[lilloo04]

1. 무슨 이유로 코드를 변경했나요?

EC2에 Spring Boot 애플리케이션을 자동 배포할 수 있도록 하기 위해 GitHub Actions를 활용한 CI/CD 파이프라인을 구축했습니다. 수동으로 EC2에 접속하여 JAR을 빌드하고 Docker를 실행하던 과정을 자동화함으로써, 배포 안정성과 속도를 높이고자 했습니다.

deploy.yml GitHub Actions 워크플로를 작성하여 main 브랜치에 push 시 EC2로 코드 전송 및 Docker 컨테이너 재실행이 자동으로 되도록 설정했습니다.

application.properties 파일은 EC2 환경 변수(Secrets)를 기반으로 동적으로 생성되도록 처리하여, 민감 정보를 GitHub에 직접 올리지 않도록 했습니다.

2. 어떤 위험이나 장애를 발견했나요?

배포 자동화 과정에서 다양한 이슈가 발생했으며, 각각 다음과 같이 해결했습니다:

• [초기 오류] Gradle 테스트 실패로 빌드 중단

  • 해결: ./gradlew build -x test로 테스트 제외 후 배포 진행 (로컬에서만 테스트 실행하도록 분리 예정)

• [Docker 오류] JAR 파일 경로 오류로 이미지 빌드 실패

  • 해결: Dockerfile에서 COPY build/libs/blog-0.0.1-SNAPSHOT.jar app.jar로 명시적 경로 지정

• [EC2 파일 복사 실패] .scp 명령어가 빈 압축파일을 보내거나 디렉토리 경로 접근 권한 문제 발생

  • 해결: zip으로 프로젝트 전체를 묶어 압축 전송하고, EC2 내부에서 unzip 후 Docker 빌드 수행

• [환경 변수 미지정 오류] ${jwt.secret} 등의 값이 application.properties에 정의되지 않아 런타임 실패

• 해결: GitHub Secrets와 EC2 환경 변수를 활용해 application.properties를 배포 시점에 동적으로 생성

3. 관련 스크린샷을 첨부해주세요.