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

42 lines
1.6 KiB
Markdown

# **ADR-003:** AWS S3 파일 업로드 전략
## Context
로컬 스토리지를 이용해 파일을 업로드하는 기본 전략 (참고: [ADR-002-FILE_UPLOAD_POLICY.md](./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` 모듈을 종속성에 추가해주면 된다.
```xml
<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/{파일아이디}