django-storages로 AWS S3 정리하고 파일 저장 연동하기

자, Django 웹앱에 파일 저장 기능을 추가하려는데 AWS S3를 써볼까 고민 중이시라면 제 이야기에 귀 기울여 보세요! 저도 얼마 전까지 똑같은 고민을 했었거든요. 사진, 동영상 이런 것들 다 어디다 저장해야 할지, 용량도 걱정되고… 그런데 Django-Storages라는 멋진 라이브러리를 알게 된 후로는 정말 세상 편해졌어요. 이 글에서는 제가 직접 겪으면서 배운 Django-Storages와 AWS S3 연동 방법을 쉽고 친근하게 설명해 드릴게요.

처음엔 막막했어요. AWS S3? Django? 이름만 들어도 어려워 보이잖아요. 하지만 막상 해보니 생각보다 간단하더라고요. 핵심은 DEFAULT_FILE_STORAGE 설정을 바꾸는 거예요. 마치 레고 블록을 바꿔 끼우는 것처럼, 기존 저장 방식 대신 S3를 사용하도록 설정만 바꿔주면 끝! 이 부분은 꼭 기억해두세요. 설정을 바꾸면 Django가 파일을 자동으로 S3에 저장하고 불러오게 됩니다. 마법 같죠?

먼저, pip install django-storages boto3 명령어로 필요한 패키지를 설치해야 해요. 설치는 엄청 쉬워요. 터미널 창 열고 이 명령어만 치면 끝! 저도 처음엔 긴장했는데, 생각보다 훨씬 간단해서 놀랐어요. 그리고 settings.py 파일을 열어서 AWS 접근키, 시크릿키, 버킷 이름 등을 설정해야 합니다. 이때 중요한 점! AWS 접근키와 시크릿키는 절대 코드에 직접 적지 마세요! 보안상 환경변수를 이용하는 게 좋습니다. 저는 처음에 코드에 직접 적었다가 깜짝 놀랐어요. 절대 하지 마세요!

settings.py에 이런 식으로 설정을 추가했어요. 저는 ap-northeast-2 리전을 사용하는데, 여러분은 자신의 리전으로 바꿔야 해요. 혹시 리전이 뭔지 모르겠다면 AWS 콘솔에서 확인해보세요. 쉽게 찾을 수 있을 거예요.

import os

AWS_ACCESS_KEY_ID = os.environ.get('AWS_ACCESS_KEY_ID')
AWS_SECRET_ACCESS_KEY = os.environ.get('AWS_SECRET_ACCESS_KEY')
AWS_STORAGE_BUCKET_NAME = os.environ.get('AWS_STORAGE_BUCKET_NAME')
AWS_S3_REGION_NAME = os.environ.get('AWS_S3_REGION_NAME', 'ap-northeast-2')

DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
STATICFILES_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage' # static files도 S3에 저장 (선택)
MEDIA_URL = f'https://{AWS_STORAGE_BUCKET_NAME}.s3.{AWS_S3_REGION_NAME}.amazonaws.com/'

그리고 MEDIA_URL 설정은 꼭! 제대로 해야 합니다. 이 설정이 잘못되면 파일을 불러올 수 없어요. 저도 이 부분에서 한참 헤맸답니다. 이 부분은 제가 가장 많이 실수했던 부분이니 꼭 확인해보세요!

이제 모델에 파일 필드를 추가하고 사용해 보면 됩니다. 예를 들어, MyModel이라는 모델에 파일을 저장하는 필드를 추가하고 싶다면, 다음과 같이 코드를 작성하면 됩니다.

from django.db import models

class MyModel(models.Model):
    my_file = models.FileField(upload_to='my_files/')

파일 업로드는 instance = MyModel(my_file=request.FILES['my_file']) 와 같이 간단하게 할 수 있고요, file_url = instance.my_file.url을 통해 파일 URL에 접근할 수 있습니다. 정말 간단하죠?

마지막으로 팁 하나 드리자면, S3 버킷의 권한 설정을 잘 해야 합니다. 아무나 접근할 수 있도록 public access를 열어두면 보안에 문제가 생길 수 있으니 주의하세요. 저는 처음에 public access를 열어뒀다가 깜짝 놀랐어요. 꼭 필요한 경우에만 제한적으로 허용해야 합니다. 그리고 대용량 파일 업로드에는 boto3의 다중 파트 업로드 기능을 사용하는 것이 좋습니다. 이 기능을 사용하면 업로드 속도가 훨씬 빨라져요.

Django-Storages를 사용하면 AWS S3와의 연동이 정말 쉬워요. 처음에는 어려울 것 같았지만, 막상 해보니 생각보다 훨씬 간단하고 편리했습니다. 이 글이 여러분의 Django 웹앱 개발에 도움이 되길 바랍니다! 궁금한 점 있으면 언제든지 물어보세요!