[BE] 배포 과정 설명

[2020147542]

github action을 활용한 배포 과정 설명

[2020147542]

배포 전반적인 과정

• main 브랜치로 Pull Request가 생성될 때 docker 이미지로 만들고 배포하는 GitHub Actions이 실행됨
• 코드 변경 → CI/CD 실행 → ECR 이미지 푸시 → EC2로 배포 → 실행 확인

1. 이미지 빌드 및 Amazon ECR로 푸시

Job: build-and-push

1. 리포지토리 가져오기
   • 코드베이스를 GitHub Actions 실행 환경으로 가져옵니다.
2. Java 환경 설정
   • JDK 17 설치 및 Gradle 명령 실행 준비를 합니다.
3. AWS 자격 증명 설정
   • AWS에 접근하기 위한 키와 리전 정보를 설정합니다.
4. ECR 로그인
   • AWS ECR(Amazon Elastic Container Registry)에 인증합니다.
5. Docker 이미지 빌드 및 푸시
   • Gradle의 jib 플러그인을 사용하여 Docker 이미지를 빌드하고 ECR에 푸시합니다.
   • 결과: ECR에 컨테이너 이미지가 저장됩니다.

2. EC2 서버에 배포 스크립트 실행

Job: run-images-on-ec2

1. EC2 접속
   • GitHub Secrets에 저장된 SSH 자격 증명을 사용하여 EC2 서버에 연결합니다.
2. 배포 스크립트 실행
   • EC2 서버에서 미리 작성된 deploy.sh 스크립트를 실행하여 애플리케이션을 배포합니다.

[2020147542]

EC2 폴더 구조

1. 컨테이너 구성 (docker-compose.yml)

1. Database 서비스
   • MySQL 컨테이너를 실행하며 데이터베이스 설정 및 유지를 담당합니다.
2. Application 서비스
   • ECR에서 가져온 애플리케이션 이미지를 실행하며, MySQL과 네트워크를 공유합니다.
3. 브리지 네트워크
   • 컨테이너 간 통신을 위한 네트워크를 설정합니다.

2. 배포 스크립트 단계

파일: deploy.sh

1. ECR에서 최신 이미지 가져오기
   • AWS ECR에서 가장 최신 이미지를 가져옵니다.
2. 기존 컨테이너 중단 및 삭제
   • docker compose down 명령으로 기존 컨테이너를 중지하고 삭제합니다.
3. 새로운 컨테이너 실행
   • docker compose up -d를 실행하여 새 컨테이너를 백그라운드에서 실행합니다.
4. 불필요한 이미지 및 컨테이너 정리
   • dangling 이미지와 멈춘 컨테이너를 삭제하여 디스크 공간을 확보합니다.
5. Health Check 수행
   • http://localhost:8080/health 로 컨테이너 상태를 확인하며, 최대 10번까지 재시도합니다.

[2020147542]

EC2 정보

• ip: 15.164.219.98
• username: ubuntu
• swagger url: http://15.164.219.98:8080/swagger-ui/index.html

[2020147542]

개발 서버에 데이터 추가

• 방법1) intelliJ로 http://15.164.219.98:3306 접속해서 직접 넣기