Django-Celery 开源项目教程
1. 项目的目录结构及介绍
Django-Celery 项目的目录结构如下:
django-celery/
├── django_celery/
│ ├── __init__.py
│ ├── apps.py
│ ├── celery.py
│ ├── models.py
│ ├── tasks.py
│ ├── urls.py
│ ├── views.py
│ └── ...
├── manage.py
├── README.rst
├── requirements.txt
└── ...
目录结构介绍
django_celery/
: 项目的主目录,包含了所有的应用代码。__init__.py
: 使目录成为一个 Python 包。apps.py
: 应用的配置文件。celery.py
: Celery 的配置和启动文件。models.py
: 数据库模型定义。tasks.py
: 定义 Celery 任务。urls.py
: URL 路由配置。views.py
: 视图函数定义。
manage.py
: Django 项目的管理脚本。README.rst
: 项目说明文档。requirements.txt
: 项目依赖的 Python 包列表。
2. 项目的启动文件介绍
manage.py
manage.py
是 Django 项目的管理脚本,用于启动开发服务器、运行迁移、创建超级用户等操作。常用命令如下:
python manage.py runserver # 启动开发服务器
python manage.py migrate # 运行数据库迁移
python manage.py createsuperuser # 创建超级用户
celery.py
celery.py
是 Celery 的配置和启动文件,通常位于 django_celery
目录下。示例内容如下:
from __future__ import absolute_import, unicode_literals
import os
from celery import Celery
# 设置默认的 Django 设置模块
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'django_celery.settings')
app = Celery('django_celery')
# 使用配置文件中的设置
app.config_from_object('django.conf:settings', namespace='CELERY')
# 自动发现并加载任务
app.autodiscover_tasks()
3. 项目的配置文件介绍
settings.py
settings.py
是 Django 项目的主配置文件,包含了数据库、静态文件、中间件、应用等的配置。以下是一些关键配置项:
# 数据库配置
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
}
}
# Celery 配置
CELERY_BROKER_URL = 'redis://localhost:6379/0'
CELERY_RESULT_BACKEND = 'redis://localhost:6379/0'
CELERY_ACCEPT_CONTENT = ['json']
CELERY_TASK_SERIALIZER = 'json'
CELERY_RESULT_SERIALIZER = 'json'
CELERY_TIMEZONE = 'UTC'
requirements.txt
requirements.txt
列出了项目依赖的 Python 包及其版本。示例内容如下:
Django==3.2
celery==5.1
redis==3.5
通过这些配置文件,可以确保项目在不同的环境中正常运行。