이 위키는 프로젝트의 클라우드 인프라, CI/CD, IaC, 보안 및 운영 관련 전반적인 내용을 체계적으로 문서화한 공간입니다.

각 섹션은 실제 인프라 구성 및 운영 시 참고할 수 있도록 다이어그램, 주요 도구, 정책 등을 포함하고 있습니다.

• 클라우드 플랫폼: AWS (Amazon Web Services) 기반
  • 높은 시장 점유율(1위), 글로벌 리전 최다
  • 범용성과 확장성 측면에서 가장 적합
• 주요 서비스
  • EC2 (인스턴스)
  • S3 (스토리지)
  • IAM (권한 관리)
• 인스턴스 타입 선정
  • T3, T3a, T4g 계열 비교 후 최종 T3 인스턴스 선택
    • T4g (ARM 기반) 성능·비용 효율 우수했으나, 일부 라이브러리 호환성 문제 고려
    • x86 기반 T3가 현재 시스템과의 호환성 및 안정성 측면에서 최적
• 초기 인프라 구축 전략
  • 단일 EC2 인스턴스에 서버 통합 구성
  • 점진적으로 분리 및 확장 가능한 구조 설계

---

• 도구: GitHub Actions
• 목표
  • 자동화된 빌드, 테스트, 품질 검증
  • 휴먼 에러 차단 및 개발 생산성 향상
• CI 파이프라인 구성
  1. Checkout
  2. 정적 분석 (Lint)
  3. 단위 테스트 (Unit Test)
  4. (선택) 통합 테스트 (Integration Test)
  5. 커버리지 80% 이상 권장
• 브랜치 전략
  • feature/* → develop → main
  • 긴급 수정 시 hotfix/* 활용
• 결과 활용
  • GitHub PR 자동 코멘트
  • 실패 시 Slack/Email 알림
  • README.md 빌드 상태 배지 표시

---

• 현재 상태: 수동 배포 기반
• 향후 계획
  • GitHub Actions 워크플로우 확장
  • 자동화된 서버 배포 스크립트 적용
  • 무중단 배포(Blue/Green, Rolling Update) 전략 검토
• 보안 정책
  • SSH 키 관리 강화
  • 서버 접근 최소화 (Bastion Host 도입 예정)
  • 환경별 구성 파일 분리 관리 (.env)

---

항목	AWS	GCP	Azure
시장 점유율	1등	3등	2등
글로벌 리전	가장 많음	적지만 빠르게 확장 중	많음
강점	인프라 최강, 서비스 다양성	Kubernetes, 데이터 분석, 머신러닝	기업 시스템 통합, 하이브리드
단점	비용, 복잡한 세팅	대형 엔터프라이즈 운영 경험 부족	UI 불편, 제품 간 일관성 부족
추천 대상	대규모 서비스, 스타트업 성장기	스타트업 초기, 데이터 분석	대기업, 금융, 공공기관

AWS는 범용성, 안정성, 글로벌 인프라 측면에서 가장 적합하다고 판단하여 최종 선택하였습니다.

단계	담당자	주요 역할	비고
사전 준비	클라우드 담당자 + 전체	- 코드 병합 확인 - 환경 변수 최신화 - 서버 상태 점검 - 백업 생성	배포 시작 전 1시간 동안 준비
프론트엔드 배포	noah (FE)	- 로컬 빌드(npm run build) - scp로 서버 업로드 - Nginx 리로드 - 브라우저로 정상 동작 확인	다운타임 없음 (정적 파일 교체)
백엔드 배포	sophie (BE)	- 로컬 빌드(./gradlew build) - scp로 서버 업로드 - SpringBoot 서비스 중단 → 교체 → 재시작 - /health API 헬스 체크 - 주요 API 테스트	약 30초 다운타임 예상
AI 서버 배포	evan (AI)	- FastAPI 코드 준비 - 모델 및 소스 업로드 - FastAPI 서비스 중단 → 교체 → 재시작 - /health API 헬스 체크 - AI API 테스트	약 1분 다운타임 예상
전체 통합 점검	전체	- 주요 기능 직접 점검(회원가입, 로그인, 검색 등) - 통합 API 정상 호출 여부 확인	10분간 집중 점검
로그 모니터링 및 롤백 준비	클라우드 담당자	- 시스템 로그, 서비스 로그 실시간 확인 (tail, journalctl) - 문제 발생 시 롤백 절차 준비 (symlink 복구)	30분간 집중 관찰