Files
korea-research/docs/arch/ADR-003-AWS_S3_UPLOAD_STRATEGY.md
2025-05-27 16:34:20 +09:00

1.6 KiB

ADR-003: AWS S3 파일 업로드 전략

Context

로컬 스토리지를 이용해 파일을 업로드하는 기본 전략 (참고: ADR-002-FILE_UPLOAD_POLICY.md) 이외에 AWS S3 로 파일을 올리고 CloudFront 를 통해 파일이 제공되는 새로운 전략이 필요했다.

Decision

AWS S3 파일 업로드 기능 제공을 위해 새로운 전략을 구현한다. 새로운 전략은 기존과 동일한 파일 업로드 서비스 인터페이스를 이용하며, Public, Private 공개범위를 가진다.

공개범위에 따른 INLINE, ATTACHMENT 응답 해더는 구현 가능한 범위 내에서 한정적으로 제공한다.

Status

Accepted

Consequence

aws maven 서브 모듈이 추가되었다. S3 파일 업로드 전략과 CloudFront 도메인으로 파일을 참조하는 전략을 담고 있다. (훗날 새로운 AWS 기능이 필요하면 이 모듈에 추가될 것이다.)

S3 업로드가 필요하다면 aws 모듈을 종속성에 추가해주면 된다.

<dependency>
    <groupId>app.module</groupId>
    <artifactId>aws</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>

aws 모듈의 aws.properties 와 aws-{spring.active.profile}.properties 에 S3와 CloudFront 를 이용하기 위한 설정 정보를 기입해야 한다.

Content-Disposition 은 INLINE 참조 방식만 제공한다.

공개 범위 Content-Disposition URL
Public INLINE ${app.aws.s3.domain}/파일경로/파일명.확장자
ATTACHMENT /content-disposition/attachment/{파일아이디}