파일과 업로드를 위한 오브젝트 스토리지.
프로젝트용 S3 호환 스토리지: 버킷 추가 방법, 애플리케이션에 제공되는 S3_* 변수, 저장 용량과 작업 요금을 안내합니다.
오브젝트 스토리지는 사용자 업로드, 생성된 보고서, 미디어, 자체 백업 등의 파일을 애플리케이션 밖에 보관합니다. AWS SDK, Laravel의 s3 디스크, django-storages, boto3, rclone 등 S3 프로토콜을 지원하는 모든 라이브러리나 도구에서 사용할 수 있습니다.
스토리지 추가
애플리케이션의 개요 → 서비스 → 오브젝트 스토리지 → 스토리지 추가로 이동합니다. 버킷 이름(영문 소문자, 숫자, 하이픈 사용, 영문자로 시작)을 입력하고 확인합니다. 버킷은 곧바로 준비됩니다.
프로젝트당 버킷은 최대 3개입니다.
애플리케이션에 제공되는 변수
접속 정보는 프로젝트 변수에 자동으로 추가되며, 애플리케이션은 다음 배포 때 이를 읽습니다.
| 변수 | 내용 |
|---|---|
S3_ENDPOINT | 스토리지 주소 |
S3_REGION | S3 클라이언트에서 사용할 리전 |
S3_BUCKET | 버킷 이름 |
S3_KEY | 액세스 키 |
S3_SECRET | 시크릿 키 |
키는 이 버킷에서만 작동합니다. 프로젝트의 두 번째 버킷은 이름이 앞에 붙은 변수를 받습니다. <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET 등입니다.
같은 이름의 변수를 직접 만들어 두었다면 그대로 유지됩니다. 애플리케이션 일부가 다른 곳의 스토리지를 계속 사용해야 할 때 유용합니다. 환경 변수를 참고하세요.
예: Laravel
config/filesystems.php에서 s3 디스크가 이 변수를 사용하도록 설정합니다.
's3' => [
'driver' => 's3',
'key' => env('S3_KEY'),
'secret' => env('S3_SECRET'),
'region' => env('S3_REGION'),
'bucket' => env('S3_BUCKET'),
'endpoint' => env('S3_ENDPOINT'),
'use_path_style_endpoint' => true,
],그다음 변수 탭에서 FILESYSTEM_DISK=s3를 설정합니다.
예: Node.js
import { S3Client } from '@aws-sdk/client-s3'
const s3 = new S3Client({
endpoint: process.env.S3_ENDPOINT,
region: process.env.S3_REGION,
credentials: { accessKeyId: process.env.S3_KEY, secretAccessKey: process.env.S3_SECRET },
})요금
| 요금 | |
|---|---|
| 저장 용량 | 월 GB당 US$0.025 |
| 트래픽 | 무료 — 스토리지에서 다운로드하는 데 비용이 들지 않습니다 |
| 쓰기 | 작업 100만 건당 US$6.00 |
| 읽기 | 작업 100만 건당 US$0.50 |
저장 용량은 매일 측정해 월 평균으로 계산하므로, 파일을 반달 동안 보관하면 요금도 절반입니다. 한 달(달력 기준) 사용량은 프로젝트의 다음 결제에 한 줄로 합산되며, 별도 구독은 없습니다.
파일 옮겨 오기
Amazon S3, Google Cloud Storage, 다른 S3 호환 스토리지 또는 서버 폴더에 있는 파일을 버킷으로 옮길 수 있습니다. 한 번에 옮기거나 중단 없이 점진적으로 옮길 수 있습니다. 오브젝트 스토리지로 파일 옮기기를 참고하세요.
버킷 삭제
버킷을 삭제하면 그 안의 모든 파일이 삭제되며 복원할 수 없고, 버킷의 변수도 프로젝트에서 제거됩니다. 버킷 삭제는 계정 소유자와 애플리케이션 관리자만 할 수 있습니다.