기본 콘텐츠로 건너뛰기

Django의 static vs media의 차이점과 배포 시 주의점

자, Django 프로젝트를 진행하다 보면 늘상 마주치는 골칫거리 중 하나죠? 바로 static 파일과 media 파일 관리입니다. CSS, JavaScript, 이미지 같은 static 파일과 사용자가 직접 업로드하는 사진이나 문서 같은 media 파일… 둘 다 중요한데, 헷갈리기 쉽고, 특히 배포할 때 문제가 툭툭 튀어나와서 정말 곤혹스러울 때가 많아요. 저도 처음엔 엄청 헤맸거든요. 그래서 제 경험을 바탕으로, 여러분이 덜 헤매도록 쉽게 정리해 드릴게요!

먼저, 핵심 개념부터 확실히 짚고 넘어가야죠. static 파일은 말 그대로 정적인 콘텐츠입니다. 웹사이트의 디자인이나 기능을 위해 필요한 파일들이고, 프로젝트 개발 과정에서 미리 준비해 놓는 거죠. CSS 파일이나 이미지 파일 같은 것들이 대표적이에요. Django는 STATIC_URL 설정을 이용해서 이 파일들을 관리합니다. 반면 media 파일은 사용자가 업로드하는 이미지, 문서, 동영상 같은 동적인 콘텐츠입니다. 웹사이트가 운영되는 동안 계속해서 변할 수 있죠. Django는 MEDIA_URL과 MEDIA_ROOT 설정으로 이 파일들을 관리하고요. 이 부분, 헷갈리시면 안 됩니다! static은 개발자가 미리 준비하고, media는 사용자가 만들어내는 거라고 생각하면 쉬워요.

자, 그럼 실제 코드를 보면서 더 자세히 알아볼까요? settings.py 파일을 봅시다. 여기서 STATIC_URL, STATICFILES_DIRS, MEDIA_URL, MEDIA_ROOT를 설정하는데, 저는 보통 프로젝트 루트에 static 폴더와 media 폴더를 만들어서 사용해요. 그리고 중요한 게 있는데, 배포할 때 static 파일들을 한 곳에 모아야 한다는 거예요. 그래서 STATIC_ROOT 설정도 해줘야 합니다. 이 부분 놓치면 배포하고 나서 404 에러 뜨면서 멘붕 오는 거 순식간이죠. 경험담입니다…ㅠㅠ

STATIC_URL = '/static/'
STATICFILES_DIRS = [
    BASE_DIR / "static",
]
MEDIA_URL = '/media/'
MEDIA_ROOT = BASE_DIR / "media"

STATIC_ROOT = BASE_DIR / "collected_static"

그리고 urls.py에도 설정을 추가해야 해요. static() 함수를 이용해서 static 파일과 media 파일 경로를 연결해 주는 거죠. 이 부분도 빼먹으면 안 돼요!

from django.conf import settings
from django.conf.urls.static import static
# ... 다른 코드 ...

urlpatterns = [
    # ... 다른 URL patterns ...
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

템플릿 파일에서는 {% static '파일경로' %} 와 {% media '파일경로' %} 태그를 사용해서 파일들을 불러오면 됩니다. 예를 들어, base.html에서 이미지를 표시하려면 이렇게 하면 되겠죠. 아, 그리고 static 태그는 static 파일용, media 태그는 media 파일용이라는 거 잊지 마세요!

<img src="{% static 'images/logo.png' %}" alt="Logo">
<img src="{% media 'uploads/user_image.jpg' %}" alt="User Image">

배포 전에 꼭 python manage.py collectstatic 명령어를 실행해서 STATIC_ROOT에 static 파일들을 모아주는 것도 잊지 마세요! 이거 안 하면 배포 후에 static 파일이 안 보이는 황당한 상황을 맞이하게 될 수도 있어요. 그리고 웹 서버(Nginx나 Apache)에서도 STATIC_ROOT와 MEDIA_ROOT에 대한 접근 권한을 잘 설정해줘야 합니다. 특히 MEDIA_ROOT는 사용자가 파일을 업로드할 수 있도록 쓰기 권한을 주는 게 필수적이에요. 이 부분 설정 잘못하면 404 에러 뜨는 건 기본이고, 심지어 보안 문제까지 발생할 수 있으니, 정말 신경 써서 설정해야 합니다. 그리고 STATIC_URL과 MEDIA_URL이 서로 겹치지 않도록 주의해야 한다는 것도 꼭 기억하세요!

마지막으로, 사용자 업로드 파일에는 악성 코드가 숨어있을 수 있으니, 항상 업로드 파일 검증 및 보안 조치를 철저히 해야 한다는 점을 강조하고 싶어요. 이 부분은 정말 중요한 보안 사항이니까 절대 소홀히 해서는 안 됩니다.

이렇게 static과 media 파일 관리를 제대로 하면 Django 프로젝트 배포가 훨씬 수월해집니다. 하지만 실제 배포 환경은 각각 다르기 때문에, 웹 서버의 설명서를 참고해서 설정을 꼼꼼하게 확인하고, 배포 전에 충분히 테스트하는 것을 잊지 마세요! 저도 처음엔 엄청 헤맸지만, 이제는 꽤 익숙해졌답니다. 여러분도 충분히 할 수 있어요! 화이팅!

라벨:

댓글

댓글 쓰기

이 블로그의 인기 게시물

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) 는 네트워크 지연을 시뮬레이션하기 위해 넣...
댓글 쓰기
자세한 내용 보기