1. AWS S3 란
AWS Simple Storage Service(S3)
데이터를 버킷 내의 객체로 저장하는 객체 스토리지 서비스
- 웹 사이트 및 모바일 애플리케이션 등에서 원하는 양의 데이터를 저장하고 보호할 수 있다.
- 데이터에 대한 액세스를 최적화, 구조화 및 구성할 수 있는 관리 기능을 제공한다.
버킷
AWS S3 에 저장된 객체에 대한 컨테이너
- 버킷에 저장할 수 있는 객체 수에는 제한이 없다
-버킷 이름은 버킷 이름 지정 규칙 을 따라야 한다.
객체
S3 에 저장되는 기본 객체
-
객체는 객체 데이터와 메타 데이터로 구성된다.
- 메타 데이터 : 객체를 설명하는 이름-값 쌍의 집합 (ex. 마지막으로 수정한 날짜와 같은 기본 메타데이터, content-type 같은 표준 HTTP 메타데이터)
- 표준 HTTP 메타 데이터: -
객체는 키(이름), 버전 ID 를 통해 식별된다.
-
웹 서비스 엔드포인트, 버킷 이름, 키, 버전의 조합을 통해 고유하게 주소를 지정할 수 있다.
ex) 미국 서부 리전에서 생성된DOC-EXAMPLE-BUCKET라는 버킷에 저장된photos/puppy.jpg라는 객체의 URL 은https://DOC-EXAMPLE-BUCKET.s3.us-west-2.amazonaws.com/photos/puppy.jpg
즉https://[버킷 이름].s3.[리전 이름].amazonaws.com/[키]
버전 관리
S3 버전 관리를 사용하여 동일한 버킷 내에서 여러개의 객체 변형을 가질 수 있으며, 검색 및 복원이 가능하다.
S3 액세스 포인트
데이터에 액세스 할 수 있는 네트워크 엔드 포인트
- 액세스 포인트는 버킷에 저장된 객체를 가져오거나, 객체를 넣기 위한 작업을 수행하기 위해 버킷에 연결된다.
리전
버킷을 저장할 지리적 AWS 지역을 의미
- 계정에 대해 사용되는 AWS 리전에서만 Amazon S3에 액세스하고 해당 기능을 사용할 수 있다.
2. AWS S3 버킷 생성
https://docs.aws.amazon.com/ko_kr/AmazonS3/latest/userguide/create-bucket-overview.html
3. AWS S3 액세스
3-1) package 설치
multer-s3
- 파일 업로드를 위해 사용되는 multipart/form-data 를 다루기 위한 Node.js 의 미들 웨어- 파일을 받아서 request 에 file 을 추가하여 넘겨준다.
AWS-SDK: AWS를 프로그래밍적으로 제어하기 편리하도록 제공되는 라이브러리들을 의미한다. REST API 를 wrapping 하는 형태다.
npm install aws-sdk multer-s3
3-2) S3 설정 파일 생성
// s3.json
{
"accessKeyId": "엑세스 키",
"secretAccessKey": "시크릿 엑세스 키",
"region": "ap-northeast-2"
}//imgAPI.ts
import multerS3 from 'multer-s3';
import aws from 'aws-sdk';
// aws config 파일 읽기
aws.config.loadFromPath('s3.json');
// s3 객체 생성
const s3 = new aws.S3();
// multer 에 대한 설정값
const awsUpload = multer({
storage: multerS3({
s3: s3,
bucket: 'bevelog-bucket', // 객체를 업로드할 버킷 이름
acl: 'public-read', // Access control for the file
key: function (req, file, cb) { // 객체의 키로 고유한 식별자 이기 때문에 겹치면 안됨
cb(null, Math.floor(Math.random() * 1000).toString() + Date.now() + '.' + file.originalname.split('.').pop());
}
}),
});
3-3) 이미지 업로드
router.post('/images/:username/thumbnail', awsUpload.single('thumbnail'), (req, response) => {
// 코드 중략
})multer.single(fileName) : fileName 으로 명시된 이름의 파일을 전달받아 req.file 에 저장해 다음(next()) 로 넘겨주는 역할을 한다.
req.file 을 조회해 보면 location 속성에 버킷에 저장된 객체의 URL 이 담긴다.
여기까지만 해도 버킷에 이미지가 업로드된 것을 확인할 수 있다.
추후 S3 버킷에 저장된 이미지를 다운로드에 클라이언트에 전달해주기 위해, THUMBNAIL_IMAGES 테이블을 생성하고 버킷에 저장된 객체를 가져오기 위한 정보들을 저장해줘야한다.
따라서 THUMBNNAIL_IMAGES table 에 insert 할 정보는
- id : req.file.key
- fk_user_name : req.params.username
- path : req.file.location
- file_size : req.file.size
INSERT INTO public."THUMBNAIL_IMAGES" ('id','fk_user_name', 'path', 'file_size')
VALUES (`${req.file.key}`, `${req.params.username}`, `${req.file.location}`, `${req.file.size}`)