시작하기

Python 애플리케이션: Django, Flask, FastAPI.

Django, Flask, FastAPI 프로젝트를 감지하고 시작하는 방식, 찾는 진입점, 정적 파일, 마이그레이션, Celery 실행을 안내합니다.

2 분 소요

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이 있어야 하며, 그 파일 그대로 빌드합니다.

아직 해결되지 않았나요?

채팅으로 문의하세요. 하루 중 언제든 AI 어시스턴트가 바로 답하고, 필요하면 엔지니어가 참여합니다.

지원팀에 문의