Merge pull request #197 from boostcampwm-2024/feature-be-#85

Object Storage에 이미지를 업로드하는 API

Author: ezcolin2

.vscode/settings.json

@@ -20,6 +20,7 @@
     "test:e2e": "jest --config ./test/jest-e2e.json"
   },
   "dependencies": {
+    "@aws-sdk/client-s3": "^3.693.0",
     "@nestjs/common": "^10.0.0",
     "@nestjs/config": "^3.3.0",
     "@nestjs/core": "^10.0.0",
@@ -31,6 +32,7 @@
     "@nestjs/swagger": "^8.0.5",
     "@nestjs/typeorm": "^10.0.2",
     "@nestjs/websockets": "^10.4.8",
+    "@types/multer": "^1.4.12",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
     "lib0": "^0.2.98",

apps/backend/package.json

@@ -12,6 +12,7 @@ import { Node } from './node/node.entity';
 import { YjsModule } from './yjs/yjs.module';
 import * as path from 'path';
 import { ServeStaticModule } from '@nestjs/serve-static';
+import { UploadModule } from './upload/upload.module';
 
 @Module({
   imports: [
@@ -37,6 +38,7 @@ import { ServeStaticModule } from '@nestjs/serve-static';
     PageModule,
     EdgeModule,
     YjsModule,
+    UploadModule,
   ],
   controllers: [AppController],
   providers: [AppService],

apps/backend/src/app.module.ts

@@ -0,0 +1,7 @@
+import { BadRequestException } from '@nestjs/common';
+
+export class InvalidFileException extends BadRequestException {
+  constructor() {
+    super(`유효하지 않은 파일입니다.`);
+  }
+}

apps/backend/src/exception/upload.exception.ts

@@ -3,6 +3,7 @@ import { AppModule } from './app.module';
 import { HttpExceptionFilter } from './filter/http-exception.filter';
 import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger';
 import { IoAdapter } from '@nestjs/platform-socket.io';
+import * as express from 'express';
 
 import * as dotenv from 'dotenv';
 dotenv.config();
@@ -13,12 +14,13 @@ async function bootstrap() {
   app.useWebSocketAdapter(new IoAdapter(app));
   app.useGlobalFilters(new HttpExceptionFilter());
   app.setGlobalPrefix('api');
+  app.use(express.urlencoded({ extended: true }));
 
   const config = new DocumentBuilder()
     .setTitle('OctoDocs')
     .setDescription('OctoDocs API 명세서')
     .build();
-  console.log(process.env.origin);
+
   const documentFactory = () => SwaggerModule.createDocument(app, config);
   SwaggerModule.setup('api', app, documentFactory);
   app.enableCors({

apps/backend/src/main.ts

@@ -0,0 +1,18 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString } from 'class-validator';
+
+export class ImageUploadResponseDto {
+  @ApiProperty({
+    example: '이미지 업로드 성공',
+    description: 'api 요청 결과 메시지',
+  })
+  @IsString()
+  message: string;
+
+  @ApiProperty({
+    example: 'https://kr.object.ncloudstorage.com/octodocs-static/uploads/name',
+    description: '업로드된 이미지 url',
+  })
+  @IsString()
+  url: string;
+}

apps/backend/src/upload/dtos/imageUploadResponse.dto.ts

@@ -0,0 +1,20 @@
+import { S3Client } from '@aws-sdk/client-s3';
+import { Provider } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+
+export const S3_CLIENT = 'S3_CLIENT';
+
+export const s3ClientProvider: Provider = {
+  provide: S3_CLIENT,
+  useFactory: (configService: ConfigService) => {
+    return new S3Client({
+      region: configService.get('CLOUD_REGION'),
+      endpoint: configService.get('CLOUD_ENDPOINT'),
+      credentials: {
+        accessKeyId: configService.get('CLOUD_ACCESS_KEY_ID'),
+        secretAccessKey: configService.get('CLOUD_SECRET_ACCESS_KEY'),
+      },
+    });
+  },
+  inject: [ConfigService],
+};

apps/backend/src/upload/s3-client.provider.ts

@@ -0,0 +1,21 @@
+import { InvalidFileException } from '../exception/upload.exception';
+
+export const MAX_FILE_SIZE = 1024 * 1024 * 5; // 5MB
+
+export const imageFileFilter = (
+  req: any,
+  file: Express.Multer.File,
+  callback: (error: Error | null, acceptFile: boolean) => void,
+) => {
+  if (!file.originalname.match(/\.(jpg|jpeg|png|gif)$/)) {
+    return callback(new InvalidFileException(), false);
+  }
+  callback(null, true);
+};
+
+export const uploadOptions = {
+  fileFilter: imageFileFilter,
+  limits: {
+    fileSize: MAX_FILE_SIZE,
+  },
+};

apps/backend/src/upload/upload.config.ts

@@ -0,0 +1,31 @@
+import {
+  Controller,
+  Post,
+  UploadedFile,
+  UseInterceptors,
+} from '@nestjs/common';
+import { FileInterceptor } from '@nestjs/platform-express';
+import { UploadService } from './upload.service';
+import { uploadOptions } from './upload.config';
+import { ImageUploadResponseDto } from './dtos/imageUploadResponse.dto';
+
+export enum UploadResponseMessage {
+  UPLOAD_IMAGE_SUCCESS = '이미지 업로드 성공',
+}
+
+@Controller('upload')
+export class UploadController {
+  constructor(private readonly uploadService: UploadService) {}
+
+  @Post('image')
+  @UseInterceptors(FileInterceptor('file', uploadOptions))
+  async uploadImage(
+    @UploadedFile() file: Express.Multer.File,
+  ): Promise<ImageUploadResponseDto> {
+    const result = await this.uploadService.uploadImageToCloud(file);
+    return {
+      message: UploadResponseMessage.UPLOAD_IMAGE_SUCCESS,
+      url: result,
+    };
+  }
+}

apps/backend/src/upload/upload.controller.ts

@@ -0,0 +1,13 @@
+import { Module } from '@nestjs/common';
+import { UploadService } from './upload.service';
+import { UploadController } from './upload.controller';
+import { ConfigModule } from '@nestjs/config';
+import { s3ClientProvider } from './s3-client.provider';
+
+@Module({
+  imports: [ConfigModule],
+  controllers: [UploadController],
+  providers: [UploadService, s3ClientProvider],
+  exports: [UploadService],
+})
+export class UploadModule {}