기본 콘텐츠로 건너뛰기

Django에서 S3를 미디어 파일 저장소로 설정하는 방법

Django에서 S3를 미디어 파일 저장소로 설정하는 방법

안녕하세요! 오늘은 Django 프로젝트에서 AWS S3를 미디어 파일 저장소로 설정하는 방법에 대해 알아보겠습니다. 이 설정을 통해 정적 파일과 미디어 파일을 효율적으로 관리할 수 있습니다.

왜 S3를 사용할까요?

AWS S3를 사용하는 주요 이점은 다음과 같습니다:

  1. 확장성: 트래픽이 증가해도 안정적으로 서비스 가능
  2. 비용 효율성: 사용한 만큼만 지불
  3. 고가용성: 99.99%의 가용성 보장
  4. 보안: AWS의 강력한 보안 시스템 활용
  5. CDN 연동: CloudFront와 쉽게 연동 가능

프로젝트 설정

먼저 필요한 패키지들을 설치합니다:

pip install django-storages boto3

AWS 설정

  1. AWS 계정 생성 (없는 경우)
  2. IAM 사용자 생성 및 S3 접근 권한 부여
  3. Access Key와 Secret Key 발급

Django 설정

settings.py에 다음과 같이 설정을 추가합니다:

# AWS 설정
AWS_ACCESS_KEY_ID = 'your-access-key-id'
AWS_SECRET_ACCESS_KEY = 'your-secret-access-key'
AWS_STORAGE_BUCKET_NAME = 'your-bucket-name'
AWS_S3_REGION_NAME = 'ap-northeast-2'  # 서울 리전
AWS_S3_CUSTOM_DOMAIN = f'{AWS_STORAGE_BUCKET_NAME}.s3.{AWS_S3_REGION_NAME}.amazonaws.com'
AWS_S3_OBJECT_PARAMETERS = {
    'CacheControl': 'max-age=86400',
}

# S3를 기본 스토리지로 설정
DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
STATICFILES_STORAGE = 'storages.backends.s3boto3.S3StaticStorage'

# 미디어 파일 URL 설정
MEDIA_URL = f'https://{AWS_S3_CUSTOM_DOMAIN}/media/'
STATIC_URL = f'https://{AWS_S3_CUSTOM_DOMAIN}/static/'

S3 버킷 설정

1. 버킷 생성

  1. AWS S3 콘솔에 접속
  2. "버킷 만들기" 클릭
  3. 버킷 이름 입력 (전역적으로 유일해야 함)
  4. 리전 선택 (ap-northeast-2)
  5. 버킷 설정:
    • 버전 관리: 활성화
    • 서버 액세스 로깅: 활성화
    • 객체 수준 로깅: 활성화

2. CORS 설정

버킷의 권한 탭에서 CORS 설정을 추가합니다:

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "GET",
            "PUT",
            "POST",
            "DELETE",
            "HEAD"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": []
    }
]

3. 버킷 정책 설정

버킷의 권한 탭에서 버킷 정책을 추가합니다:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "PublicReadGetObject",
            "Effect": "Allow",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::your-bucket-name/*"
        }
    ]
}

커스텀 스토리지 클래스

특별한 요구사항이 있는 경우 커스텀 스토리지 클래스를 만들 수 있습니다:

# storage_backends.py
from storages.backends.s3boto3 import S3Boto3Storage

class MediaStorage(S3Boto3Storage):
    location = 'media'
    file_overwrite = False

class StaticStorage(S3Boto3Storage):
    location = 'static'
    file_overwrite = True

그리고 settings.py를 수정합니다:

DEFAULT_FILE_STORAGE = 'your_app.storage_backends.MediaStorage'
STATICFILES_STORAGE = 'your_app.storage_backends.StaticStorage'

파일 업로드 예제

1. 모델 설정

# models.py
from django.db import models

class Document(models.Model):
    title = models.CharField(max_length=100)
    file = models.FileField(upload_to='documents/')
    uploaded_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.title

class Image(models.Model):
    title = models.CharField(max_length=100)
    image = models.ImageField(upload_to='images/')
    uploaded_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.title

2. 폼 설정

# forms.py
from django import forms
from .models import Document, Image

class DocumentForm(forms.ModelForm):
    class Meta:
        model = Document
        fields = ('title', 'file',)

class ImageForm(forms.ModelForm):
    class Meta:
        model = Image
        fields = ('title', 'image',)

3. 뷰 설정

# views.py
from django.shortcuts import render, redirect
from .forms import DocumentForm, ImageForm
from django.contrib import messages

def upload_document(request):
    if request.method == 'POST':
        form = DocumentForm(request.POST, request.FILES)
        if form.is_valid():
            form.save()
            messages.success(request, '문서가 성공적으로 업로드되었습니다.')
            return redirect('document_list')
    else:
        form = DocumentForm()
    return render(request, 'upload_document.html', {'form': form})

def upload_image(request):
    if request.method == 'POST':
        form = ImageForm(request.POST, request.FILES)
        if form.is_valid():
            form.save()
            messages.success(request, '이미지가 성공적으로 업로드되었습니다.')
            return redirect('image_list')
    else:
        form = ImageForm()
    return render(request, 'upload_image.html', {'form': form})

파일 다운로드 예제

# views.py
from django.http import HttpResponse
from django.shortcuts import get_object_or_404
from .models import Document

def download_document(request, document_id):
    document = get_object_or_404(Document, id=document_id)
    response = HttpResponse(document.file, content_type='application/force-download')
    response['Content-Disposition'] = f'attachment; filename="{document.file.name}"'
    return response

성능 최적화

1. CloudFront 연동

# settings.py
AWS_S3_CUSTOM_DOMAIN = 'your-cloudfront-domain.cloudfront.net'

2. 캐시 설정

# settings.py
AWS_S3_OBJECT_PARAMETERS = {
    'CacheControl': 'max-age=86400',
    'Expires': 'Thu, 31 Dec 2099 20:00:00 GMT',
}

보안 설정

1. IAM 정책

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:DeleteObject"
            ],
            "Resource": "arn:aws:s3:::your-bucket-name/*"
        }
    ]
}

2. 환경 변수 사용

# settings.py
import os

AWS_ACCESS_KEY_ID = os.environ.get('AWS_ACCESS_KEY_ID')
AWS_SECRET_ACCESS_KEY = os.environ.get('AWS_SECRET_ACCESS_KEY')

모니터링 및 로깅

1. CloudWatch 설정

# settings.py
AWS_S3_USE_SSL = True
AWS_S3_VERIFY = True

2. 로깅 설정

# settings.py
LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        's3': {
            'level': 'DEBUG',
            'class': 'logging.handlers.S3Handler',
            'bucket': AWS_STORAGE_BUCKET_NAME,
            'key': 'logs/django.log',
        },
    },
    'loggers': {
        'django': {
            'handlers': ['s3'],
            'level': 'DEBUG',
            'propagate': True,
        },
    },
}

주의사항

  1. 비용 관리: S3 사용량을 모니터링하고 비용을 관리하세요.
  2. 보안: Access Key와 Secret Key를 안전하게 관리하세요.
  3. 버전 관리: 중요한 파일은 버전 관리를 활성화하세요.
  4. 백업: 정기적으로 S3 버킷의 백업을 확인하세요.

결론

AWS S3를 Django의 미디어 파일 저장소로 사용하면 확장성 있고 안정적인 파일 저장 시스템을 구축할 수 있습니다. 이 글에서 소개한 설정과 예제들을 참고하여 자신의 프로젝트에 맞는 S3 스토리지를 구현해보세요. 추가적인 질문이나 궁금한 점이 있으시면 댓글로 남겨주세요!

라벨:

댓글

댓글 쓰기

이 블로그의 인기 게시물

Django에서 트랜잭션 관리하기

Django에서 트랜잭션 관리하기 안녕하세요! 오늘은 Django에서 데이터베이스 트랜잭션을 효과적으로 관리하는 방법에 대해 알아보겠습니다. 1. 트랜잭션의 중요성 트랜잭션은 데이터베이스의 일관성과 무결성을 보장하는 중요한 개념입니다. Django에서는 여러 가지 방법으로 트랜잭션을 관리할 수 있습니다. 1.1 기본 개념 원자성(Atomicity) : 트랜잭션은 모두 실행되거나 모두 실행되지 않아야 합니다. 일관성(Consistency) : 트랜잭션 전후로 데이터베이스의 일관성이 유지되어야 합니다. 격리성(Isolation) : 동시에 실행되는 트랜잭션들이 서로 영향을 주지 않아야 합니다. 지속성(Durability) : 완료된 트랜잭션의 결과는 영구적으로 저장되어야 합니다. 2. Django의 트랜잭션 관리 2.1 기본 설정 # settings.py DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql', 'NAME': 'mydatabase', 'USER': 'myuser', 'PASSWORD': 'mypassword', 'HOST': 'localhost', 'PORT': '5432', 'ATOMIC_REQUESTS': True, # 모든 뷰를 트랜잭션으로 래핑 } } 2.2 데코레이터 사용 from django.db import transaction @transaction.atomic def create_order(user, items): order = Order.objects.create(user=...
댓글 쓰기
자세한 내용 보기

AWS S3 + CloudFront로 정적 파일 서빙 완전 가이드

AWS S3 + CloudFront로 정적 파일 서빙 완전 가이드 안녕하세요! 오늘은 AWS S3와 CloudFront를 사용하여 정적 파일을 효율적으로 서빙하는 방법에 대해 알아보겠습니다. 왜 S3와 CloudFront를 사용할까요? 높은 가용성 : AWS의 글로벌 인프라를 활용 빠른 전송 속도 : CloudFront의 CDN 기능으로 전 세계 사용자에게 빠른 전송 비용 효율성 : 사용한 만큼만 지불 보안 : AWS의 보안 기능 활용 확장성 : 트래픽 증가에 자동 대응 1. S3 버킷 설정 1.1 버킷 생성 및 설정 import boto3 def create_s3_bucket(): s3 = boto3.client('s3') # 버킷 생성 bucket_name = 'your-static-files-bucket' s3.create_bucket( Bucket=bucket_name, CreateBucketConfiguration={ 'LocationConstraint': 'ap-northeast-2' } ) # 버킷 정책 설정 bucket_policy = { "Version": "2012-10-17", "Statement": [ { "Sid": "PublicReadGetObject", "Effect": "Allow", "Principal": "*", "Action": "s3:GetObje...
댓글 쓰기
자세한 내용 보기

Python에서 asyncio 완전 정복 (await, async, gather 등)

어휴, 요즘 파이썬으로 비동기 프로그래밍 하는 재미에 푹 빠졌어요! 특히 asyncio 는 정말 마법 같더라고요. 처음엔 좀 낯설었는데, 익숙해지니까 속도 향상이 눈에 띄게 느껴져서 완전 반해버렸습니다. 이 글에선 제가 asyncio 를 배우면서 깨달은 점들을 풀어놓을게요. 혹시 비동기 프로그래밍이 뭔지 잘 모르시겠다면, 간단히 말해 여러 작업을 동시에 처리해서 프로그램 속도를 엄청나게 높이는 기술이라고 생각하시면 돼요. 마치 여러 요리사가 동시에 음식을 만들어서 손님에게 빨리 제공하는 것과 비슷하죠! 일단 async 와 await 라는 녀석들이 핵심인데요, async 는 함수 앞에 붙여서 "얘는 비동기 함수야!"라고 선언하는 거예요. 그리고 await 는 다른 비동기 함수가 끝날 때까지 기다리라고 지시하는 역할을 하죠. 예를 들어, 네트워크에서 데이터를 가져오는 함수가 있다면, await 를 사용해서 데이터가 다 가져올 때까지 기다렸다가 다음 작업을 진행할 수 있어요. 그 동안 다른 작업을 처리할 수 있으니, 마치 멀티태스킹을 하는 것처럼 느껴져요. 신기하지 않나요? 그리고 asyncio.gather 는 여러 비동기 함수를 동시에 실행하고 결과를 모아주는 아주 유용한 친구입니다. 제가 웹사이트 여러 개에서 데이터를 동시에 가져와야 할 때 정말 요긴하게 썼어요. 하나씩 순서대로 가져오는 것보다 훨씬 빠르더라고요! 마치 여러 개의 탭을 동시에 열어놓고 작업하는 것과 같다고 생각하시면 될 것 같아요. 실제로 제가 썼던 코드를 보여드릴게요. 세 개의 웹사이트에서 데이터를 가져오는 예제인데요. (아래 코드 삽입) 이 코드를 보시면, fetch_data 함수가 각 웹사이트에서 데이터를 가져오는 역할을 하고, asyncio.gather 가 이 함수들을 동시에 실행하도록 도와주는 것을 볼 수 있을 거예요. asyncio.sleep(2) 는 네트워크 지연을 시뮬레이션하기 위해 넣...
댓글 쓰기
자세한 내용 보기