AWS S3를 활용한 파일 저장 및 관리

오늘날 클라우드 스토리지 서비스는 데이터의 저장과 관리에서 필수적인 역할을 하고 있습니다. 특히 Amazon Web Services(AWS)의 S3(Simple Storage Service)는 대량의 데이터를 안전하고 효율적으로 저장할 수 있는 최적의 솔루션으로 각광받고 있습니다. 본 포스팅에서는 AWS S3의 기능과 사용법에 대해 자세히 알아보도록 하겠습니다.

AWS S3란 무엇인가?

AWS S3는 데이터를 객체 단위로 관리하는 오브젝트 스토리지 서비스입니다. 이를 통해 사용자는 대규모의 이미지, 비디오, 문서 등을 안전하게 저장하고 손쉽게 접근할 수 있습니다. S3는 특히 높은 내구성과 가용성을 제공하여, 데이터 손실의 위험을 최소화하고 안전하게 파일을 관리할 수 있도록 도와줍니다.

S3의 주요 특징

• 무한한 저장력: S3는 사용자가 필요로 하는 만큼 데이터를 저장할 수 있으며, 파일 크기에 대한 제한이 존재하지 않아 유연한 데이터 관리가 가능합니다.
• 높은 내구성과 가용성: S3에 저장된 파일은 여러 복제본으로 관리되어 물리적인 문제 발생 시에도 데이터의 무결성을 유지할 수 있습니다.
• 암호화 및 보안: 데이터는 전송 중 및 저장 중 모두 암호화되어 안전하게 보호됩니다.
• 편리한 데이터 관리: 데이터의 라이프사이클을 자동으로 관리하고 아카이빙하는 다양한 기능이 지원되어, 사용자는 더욱 효율적으로 데이터를 관리할 수 있습니다.

AWS S3 사용 준비하기

AWS S3를 이용하기 위해서는 먼저 AWS 콘솔에 접근하여 몇 가지 설정을 마쳐야 합니다. 다음은 S3 버킷 생성과 IAM 사용자 설정 과정입니다.

1. 버킷 생성하기

AWS Management Console에 로그인한 후, S3 서비스를 선택하고 “버킷 만들기”를 클릭합니다. 원하는 버킷 이름과 지역을 정한 뒤, 기본 설정으로 진행하여 버킷을 생성합니다. 사용자가 필요한 경우, 버킷 이름에 맞는 정책을 설정할 수 있습니다.

2. IAM 사용자 생성 및 권한 설정하기

다음으로 IAM 서비스로 이동하여 ‘사용자 추가’를 클릭합니다. 사용자 이름을 입력하고, 정책 연결에서 ‘AmazonS3FullAccess’를 선택하여 S3 작업에 필요한 접근 권한을 부여합니다. 이후 액세스 키와 비밀 키를 발급받아 안전하게 저장합니다.

AWS S3와 통신하기

이제 AWS S3에 파일을 저장하고 관리하기 위한 코드를 작성할 차례입니다. 일반적으로 Java와 Spring Boot를 이용한 설정 과정을 살펴보겠습니다.

Java 프로젝트에 S3 의존성 추가하기

Gradle을 사용하는 경우, 다음과 같이 의존성을 추가합니다:

implementation 'org.springframework.cloud:spring-cloud-starter-aws:2.2.6.RELEASE'

Configuration 클래스 설정하기

다음은 AWS 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 AmazonS3 s3Client() {
    BasicAWSCredentials awsCreds = new BasicAWSCredentials(accessKey, secretKey);
    return AmazonS3ClientBuilder.standard()
        .withRegion(Regions.fromName(region))
        .withCredentials(new AWSStaticCredentialsProvider(awsCreds))
        .build();
  }
}

파일 업로드 및 다운로드 구현하기

S3에 파일을 업로드하고 다운로드하는 기능을 구현하기 위해 다음과 같은 서비스 클래스를 작성할 수 있습니다.

파일 업로드 서비스 구현하기

@Service
@RequiredArgsConstructor
public class S3UploadService {
  private final AmazonS3 amazonS3;
  @Value("${cloud.aws.s3.bucket}")
  private String bucket;
  public String saveFile(MultipartFile multipartFile) throws IOException {
    String originalFilename = multipartFile.getOriginalFilename();
    ObjectMetadata metadata = new ObjectMetadata();
    metadata.setContentLength(multipartFile.getSize());
    metadata.setContentType(multipartFile.getContentType());
    amazonS3.putObject(bucket, originalFilename, multipartFile.getInputStream(), metadata);
    return amazonS3.getUrl(bucket, originalFilename).toString();
  }
}

파일 다운로드 서비스 구현하기

파일을 다운로드하는 API 엔드포인트를 구현할 수 있습니다:

@GetMapping("/s3/download/{fileName}")
public ResponseEntity download(@PathVariable String fileName) {
  S3Object s3object = amazonS3.getObject(bucket, fileName);
  S3ObjectInputStream inputStream = s3object.getObjectContent();
  byte[] content = IOUtils.toByteArray(inputStream);
  return ResponseEntity.ok().body(content);
}

S3의 비용 구조 이해하기

AWS S3의 사용 요금은 저장된 데이터의 양과 그 데이터를 요청하는 빈도를 기준으로 계산됩니다. 파일을 저장하는 양이 많고, 자주 호출하는 경우 비용이 증가합니다. 따라서, 효과적인 비용 관리를 위해 사용자는 데이터의 사용 패턴을 분석하고 최적의 저장소 클래스를 선택해야 합니다.

결론

AWS S3는 현대의 데이터 저장 및 관리 솔루션 중에서 뛰어난 성능을 제공하는 플랫폼입니다. 무한한 저장 용량과 높은 가용성, 보안성을 고려할 때, 다양한 프로젝트에서 S3를 활용한 파일 저장 방식은 이상적이라고 할 수 있습니다. 본 포스팅을 통해 S3의 활용방안과 기본적인 사용법을 이해하시길 바랍니다.

질문 FAQ