20260310 [TIL] 클라우드 아키텍처 설계 & 배포

트러블슈팅

Docker 이미지 아키텍처 불일치

문제

• EC2에서 컨테이너 실행 시 exec format error 발생

원인

• 로컬 환경과 EC2 환경의 CPU 아키텍처가 달라 이미지 호환 문제가 발생

해결

• Docker 이미지 빌드 시 플랫폼 명시

RDS 연결 실패

문제

• 애플리케이션이 운영 환경에서 MySQL에 연결되지 않음

원인

• RDS 보안 그룹 설정 미흡
• Parameter Store 값 주입 오류
• DB URL 오타 또는 데이터베이스 미생성

해결

• RDS 인바운드 규칙에 EC2 보안 그룹 연결
• Parameter Store 값 재확인
• 애플리케이션 실행 프로필 및 DB 설정 점검

ALB Health Check 실패

문제

• Target Group 상태가 Healthy로 올라오지 않음

원인

• Health Check Path 설정 오류
• 애플리케이션 미기동
• 보안 그룹 및 포트 설정 오류

해결

• Health Check Path 확인
• 컨테이너 실행 상태 확인
• EC2 / ALB 보안 그룹 재점검

  ---

회고

이번 프로젝트를 통해 단순히 API를 만드는 수준을 넘어서 실제 운영을 고려한 클라우드 인프라 설계와 배포 자동화까지 경험할 수 있었습니다...

특히 아래 내용을 직접 구축해 보며 많은 것을 배웠습니다.

• 아키텍처 설계
• AWS 네트워크 구성
• 운영 환경 보안 관리
• Docker 기반 배포
• GitHub Actions 기반 CI/CD
• ALB / ASG 기반 고가용성 구성
• HTTPS 및 도메인 연결
• CloudFront CDN 적용

이 프로젝트를 통해 로컬에서만 동작하는 애플리케이션이 아니라,
실제로 외부 사용자가 접근 가능한 운영형 서비스를 만드는 경험을 할 수 있었습니다.
그리고 꼼꼼함과 기도의 영역이 어떤 것인지 알게 되었습니다.
아쉬운 건 과제하는 것에 급급하여 트러블 슈팅을 제대로 작성 못한 것이 아쉽습니다. TIL도 더 열심히 작성했어야 되는데!!!
그래도 도전까지 해낸 제 자신이 자랑스럽고 꼭 이 과정이 익숙해지도록 더 열심히 노력하고 싶습니다. 정말로...... 그래도 한 번 해 봤으니까 자신감도 생긴 것 같습니다. 팀 프로젝트까지 잘 해내고 싶습니다.