변경 로그

SCF의 모든 주요 변경 사항이 이 파일에 문서화됩니다.

이 형식은 Keep a Changelog를 기반으로 하며, Semantic Versioning을 따릅니다.

[3.0.0] - 2025-12-10

호환성을 깨는 변경 (Breaking Changes)

CloudFront 필수화: cloudfront.enabled 옵션 제거 - 보안을 위해 CloudFront가 항상 활성화됨
S3 퍼블릭 액세스 제거: S3 버킷에 직접 접근 불가, CloudFront를 통해서만 접근 가능
S3 웹사이트 호스팅 제거: s3.websiteHosting 옵션 제거

추가됨

Origin Access Control (OAC): CloudFront에서 S3로의 안전한 접근을 위한 OAC 도입
CloudFront Function: 디렉토리 요청에 대한 index.html 라우팅을 위한 CloudFront Function 자동 생성
보안 강화: S3 버킷 정책이 CloudFront OAC만 허용하도록 변경

변경됨

CloudFront distribution이 OAC를 통해 S3에 접근
모든 요청이 CloudFront를 통해 처리되어 보안 및 성능 향상

마이그레이션 가이드

v2.x에서 업그레이드하는 경우:

cloudfront.enabled 옵션 제거 (더 이상 필요 없음)
s3.websiteHosting 옵션 제거 (더 이상 지원 안 함)
S3 URL 직접 접근 코드가 있다면 CloudFront URL로 변경

typescript

// 이전 (v2.x)
cloudfront: {
  enabled: true,  // ❌ 제거
  priceClass: 'PriceClass_100',
}

// 이후 (v3.0.0)
cloudfront: {
  // enabled 옵션 불필요 - 항상 활성화됨
  priceClass: 'PriceClass_100',
}

[3.0.1] - 2025-12-10

수정됨

S3 버킷 정책 마이그레이션: 기존 배포 업데이트 시에도 S3 버킷 정책이 CloudFront-only로 적용되도록 수정
자동 보안 마이그레이션: v2.x에서 업그레이드한 사용자의 S3 버킷이 첫 번째 deploy 시 자동으로 보안 설정됨

[2.1.0] - 2025-12-01

추가됨

S3 파일 정리: 증분 배포 시 로컬에서 삭제된 파일을 S3에서도 자동으로 삭제
배포 롤백: CloudFront 배포 실패 시 새로 생성된 S3 버킷 자동 정리
AWS API 재시도: 일시적인 네트워크 오류에 대한 지수 백오프 재시도 (최대 3회, 1초 → 2초 → 4초 지연)
타임아웃 연장: CloudFront 배포 타임아웃이 20분에서 30분으로 증가
즉시 상태 업데이트: remove 명령어가 각 리소스 삭제 후 즉시 상태 파일 업데이트

새 CLI 옵션

--no-rollback - CloudFront 배포가 실패해도 S3 버킷 유지
--no-cleanup - 증분 배포 시 S3 파일 정리 건너뛰기

변경됨

자동 재시도 메커니즘으로 배포 안정성 향상
부분 배포 실패 시 오류 복구 기능 강화

[2.0.2] - 2025-11-28

수정됨

Free Plan 호환성: Free pricing plan에서 distribution 업데이트 시 발생하던 에러 수정
Free plan distribution에서 priceClass 업데이트가 자동으로 스킵됨
Free plan은 모든 엣지 로케이션 사용 (PriceClass_All과 동일)

[2.0.1] - 2025-11-28

수정됨

Zod 스키마와 config 유틸리티에서 남아있던 TTL 참조 수정
TTL 검증 테스트 케이스 제거

변경됨

README에 v2.0.0 변경 로그 상세 내용 추가

[2.0.0] - 2025-11-28

호환성을 깨는 변경 (Breaking Changes)

TTL 설정 제거: CloudFront 설정에서 defaultTTL, maxTTL, minTTL 옵션이 제거되었습니다
AWS Managed Cache Policy 도입: CloudFront가 레거시 ForwardedValues 대신 CachingOptimized 관리형 캐시 정책을 사용합니다

추가됨

AWS Managed Cache Policy (CachingOptimized)를 통한 자동 캐시 관리
새 CloudFront distribution 생성 후 가격 정책 전환 안내 메시지

변경됨

CloudFront distribution이 캐시 관리를 위해 CachePolicyId를 사용
최신 AWS 모범 사례에 따른 CloudFront distribution 생성 개선

마이그레이션 가이드

v1.x에서 업그레이드하는 경우 scf.config.ts에서 TTL 필드를 제거하세요:

typescript

// 이전 (v1.x) - 더 이상 지원되지 않는 옵션
cloudfront: {
  enabled: true,
  defaultTTL: 3600,     // ❌ 제거
  maxTTL: 86400,        // ❌ 제거
  minTTL: 0,            // ❌ 제거
}

// 이후 (v2.0.0)
cloudfront: {
  enabled: true,
  // TTL은 이제 AWS에서 자동으로 관리됩니다
}

참고: v2.0.0 이상에서 TTL 설정을 유지하면 무시됩니다.

[1.1.0] - 2025-11-26

추가됨

SPA 모드: CloudFront에서 SPA(Single Page Application) 모드 기본 활성화
- cloudfront.spa 옵션 추가 (기본값: true)
- 403/404 에러를 자동으로 index.html로 리다이렉트
- React Router, Vue Router 등 클라이언트 사이드 라우팅 지원