Python 애플리케이션: Django, Flask, FastAPI.
Django, Flask, FastAPI 프로젝트를 감지하고 시작하는 방식, 찾는 진입점, 정적 파일, 마이그레이션, Celery 실행을 안내합니다.
requirements.txt, pyproject.toml, Pipfile 또는 manage.py가 있는 저장소는 Python 프로젝트입니다. Django, Flask, FastAPI를 인식해 운영용 서버로 시작하므로 서버를 직접 추가할 필요가 없습니다.
빌드와 실행 방식
- Python 3.11.
- 의존성 —
pip install -r requirements.txt또는pyproject.toml이면pip install .. - 서버 — Django와 Flask는 gunicorn, FastAPI는 uvicorn으로 실행합니다. 서버는 설치 과정에서 자동으로 추가됩니다.
Django
manage.py또는 요구 사항의django로 인식합니다.- 진입점은
manage.py의DJANGO_SETTINGS_MODULE에서 읽으며<project>.wsgi:application입니다. - 정적 파일 — 빌드 중
python manage.py collectstatic이 실행됩니다. 애플리케이션에서 WhiteNoise(미들웨어에 추가)로 제공하거나 오브젝트 스토리지에서 제공하세요. - 마이그레이션 — 권장 릴리스 명령은
python manage.py migrate --noinput입니다. 배포할 때마다 새 버전이 방문자를 받기 전에 실행되며, 실패하면 현재 버전이 계속 실행됩니다. - 도메인과
rivervo.app주소를ALLOWED_HOSTS에 추가하고(예: 변수로), HTTPS 폼을 위해CSRF_TRUSTED_ORIGINS를 설정하세요.
Flask와 FastAPI
애플리케이션을 만드는 파일(app.py, main.py, wsgi.py, application.py 또는 server.py)과 애플리케이션이 저장된 변수를 찾습니다.
# app.py
from flask import Flask
app = Flask(__name__) # → app:app으로 시작# main.py
from fastapi import FastAPI
app = FastAPI() # → main:app으로 시작애플리케이션을 다른 곳(애플리케이션 팩토리, 패키지)에서 만든다면 설정 → 빌드 설정 → 시작 명령을 지정하세요. 예:
gunicorn "myproject:create_app()" --bind 0.0.0.0:$PORT
uvicorn myproject.api:app --host 0.0.0.0 --port $PORT데이터베이스
프로젝트에 PostgreSQL 또는 MySQL을 추가하고 DATABASE_URL을 읽으세요. Django에서는 dj-database-url로, SQLAlchemy에서는 직접 읽습니다. 데이터베이스를 참고하세요.
Celery와 기타 워커
프로젝트에 Valkey를 추가하고 Celery가 REDIS_URL을 사용하도록 설정합니다. 워커는 다음과 같이 실행합니다.
- 프로세스 탭에서 백그라운드 워커로 —
celery -A myproject worker -l info - 또는 자체 리소스를 가진 별도의 백그라운드 워커 서비스로
- Celery beat는 백그라운드 워커를 하나 더 두어 실행하고(
celery -A myproject beat -l info), 주기적인 명령은 예약 명령이나 예약 작업으로 실행합니다.
프로젝트의 서비스를 참고하세요.
배포 후에도 남는 파일
배포할 때마다 저장소의 새 사본으로 시작합니다. 애플리케이션이 /data에 쓴 파일은 배포 사이에도 유지되고 매일 백업되지만, 다른 곳에 쓴 파일은 다음 배포 후 사라집니다. 사용자 업로드에는 오브젝트 스토리지를 사용하세요(Django는 S3_* 변수와 함께 django-storages 사용).
그 밖의 Python 프로젝트
이 프레임워크를 사용하지 않는 Python 프로젝트는 저장소에 자체 Dockerfile이 있어야 하며, 그 파일 그대로 빌드합니다.