AWS S3란??

프로필 사진, 레시피 사진, SNS 피드 사진 등을 업로드 하기 위해서 AWS S3를 사용하려고 한다.

📙AWS S3란?

• Amazon Web Service Simple Storage Service의 약자
• 파일, 데이터 및 다양한 유형의 미디어 등을 저장하고 관리하는데 사용되는 웹 기반 스토리지 시스템이다.

✏️S3의 특징

• 무제한 스토리지
• 높은 내구성과 가용성
• 보안 : SSL 암호화된 엔드포인트를 통해 데이터를 안전하게 전송
  💡SSL이란?
  인터넷 상에서 데이터를 안전하게 전송하기 위한 보안 프로토콜
  즉, 웹 브라우저와 웹 서버 간의 통신을 암호화하여 개인정보와 같은 민감한 정보를 보호한다.
• 다양한 스토리지 클래스를 제공하여 데이터 액세스 패턴에 따라 최적화된 비용으로 저장 가능

✏️S3의 구조

1. 버킷(Bucket)
   • 객체를 저장하는 최상위 디렉토리
   • 각 버킷은 고유한 이름을 가지며, 특정 AWS 리전에 생성된다.
2. 객체(Object)
   • 실제 저장되는 데이터 단위
   • 각 객체는 키(파일명), 값(데이터), 메타데이터 등으로 구성
   • 객체마다 접근 권한 설정이 가능하다.
   • 저장 가능한 객체의 개수는 무제한이다.

📙AWS S3를 이용한 파일 업로드

✏️설정

1. Spring Cloud AWS의 버전 설정

   <properties>
   			<spring-cloud-aws.version>3.1.1</spring-cloud-aws.version>
   		</properties>

2. Spring Cloud AWS의 의존성 관리

   <dependencyManagement>
   			<dependencies>
   				<dependency>
   					<groupId>io.awspring.cloud</groupId>
   					<artifactId>spring-cloud-aws-dependencies</artifactId>
   					<version>${spring-cloud-aws.version}</version>
   					<type>pom</type>
   					<scope>import</scope>
   				</dependency>
   			</dependencies>
   		</dependencyManagement>

3. Amazon S3 SDK 의존성 추가

   <dependencies>
       <dependency>
   				<groupId>software.amazon.awssdk</groupId>
   				<artifactId>s3</artifactId>
   				<version>2.21.46</version>
   		   </dependency>
   		</dependencies>

4. AWS S3 서비스 설정

   cloud.aws.s3.bucket=<S3 버킷 이름> 
   cloud.aws.region.auto=false // AWS 리전을 자동으로 감지하는 기능 비활성화 
   cloud.aws.stack.auto=false // AWS CloudFormation 스택에서 리소스를 자동으로 감지하는 기능 비활성화 
   cloud.aws.region.static=ap-northeast-2 // 사용할 AWS 리전을 설정 (ap-northeast-2 : 서울 리전)
   cloud.aws.credentials.access-key= // AWS 계정의 access key 설정
   cloud.aws.credentials.secret-key= // AWS 계정의 secret key 설정 
   spring.servlet.multipart.enabled=true // Spring의 Multipart 파일 업로드 기능 활성화 

✏️S3Config

• Amazon S3 클라이언트를 구성하는 설정

@Configuration
public class S3Config {
    @Value("${cloud.aws.credentials.access-key}")
    private String accessKey;

    @Value("${cloud.aws.credentials.secret-key}")
    private String secretKey;

    @Value("${cloud.aws.region.static}")
    private String region;

    @Bean
    public S3Client s3Client(){
        AwsBasicCredentials awsBasicCredentials = AwsBasicCredentials.create(accessKey, secretKey); // AWS 자격 증명 생성 

        return S3Client.builder() // S3 클라이언트 구성 
                .credentialsProvider(StaticCredentialsProvider.create(awsBasicCredentials)) // 생성된 자격 증명 제공
                .region(Region.of(region)) // 설정된 AWS 리전을 지정 
                .build(); // S3Client 인스턴스 생성
    }
}

✏️S3Service

@Service
public class S3Service {

    private final S3Client s3Client;

    @Value("${cloud.aws.s3.bucket}")
    private String bucketName;

    @Autowired
    public S3Service(S3Client s3Client) {
        this.s3Client = s3Client;
    }

    // MultipartFile을 받아 S3에 업로드하고, 업로드된 파일의 URL을 반환
    public String uploadFile(MultipartFile file) {
        String fileName = generateFileName(file);
        try {
            PutObjectRequest putObjectRequest = PutObjectRequest.builder()
                    .bucket(bucketName)
                    .key(fileName)
                    .acl("public-read") // 파일을 공개적으로 읽을 수 있도록 설정
                    .contentType(file.getContentType()) // 업로드하는 파일의 실제 MIME 타입을 설정
                    .contentDisposition("inline") // 브라우저에서 파일을 직접 표시
                    .build();

            s3Client.putObject(putObjectRequest, RequestBody.fromInputStream(file.getInputStream(), file.getSize()));

            return String.format("https://%s.s3.amazonaws.com/%s", bucketName, fileName);
        } catch (IOException e) {
            throw new RuntimeException("파일 업로드에 실패했습니다", e);
        }
    }

    // 파일 이름 생성
    private String generateFileName(MultipartFile file) {
        return UUID.randomUUID().toString() + "-" + file.getOriginalFilename();
    }
}

참고 자료
https://gaeggu.tistory.com/33
https://bigco-growth-diary.tistory.com/43