djangofluent/demo.django-fluent.org

django-fluent演示项目镜像

镜像概述

本镜像为django-fluent CMS的演示项目，展示了django-fluent的各类模块功能及推荐的代码布局，旨在为开发者提供学习参考和功能测试的示例。

核心功能

• 展示django-fluent的多种模块特性
• 支持Docker Compose、Kubernetes和本地开发三种部署方式
• 允许通过环境变量自定义应用配置（如数据库、缓存、邮件等）
• 提供SASS文件编译和LiveReload支持，方便前端开发调试

使用场景

• 开发人员学习django-fluent CMS的使用方法
• 测试django-fluent的功能特性
• 参考项目代码结构以构建自己的django-fluent应用

配置说明

可通过环境变量覆盖以下应用设置：

• ALLOWED_HOSTS：允许的主机名列表，或*表示所有
• CACHE_URL：缓存服务器地址（如memcached/redis）
• COMPRESS_ENABLED：是否启用django-compressor（True/False）
• CSRF_COOKIE_SECURE：是否启用CSRF Cookie安全（True/False）
• DATABASE_URL：数据库连接地址（如PostgreSQL）
• DJANGO_DEBUG：是否开启调试模式（True/False）
• DJANGO_SECRET_KEY：自定义密钥
• DJANGO_SETTINGS_MODULE：自定义设置模块，默认值为fluentdemo.settings.env.docker
• EMAIL_URL：SMTP服务器地址
• GEOPOSITION_GOOGLE_MAPS_API_KEY：Google Maps API密钥
• GOOGLE_ANALYTICS_PROPERTY_ID：Google Analytics ID
• SENTRY_DSN：Sentry实例地址
• SESSION_COOKIE_SECURE：是否启用Session Cookie安全（True/False）
• THUMBNAIL_REDIS_URL：缩略图用的Redis地址
• UWSGI_PROCESSES：uWSGI进程数
• UWSGI_THREADS：uWSGI线程数

部署示例

Docker Compose部署

构建并运行容器：

bash
docker-compose up

访问地址：http://localhost:8000/
发送的邮件可在：http://localhost:8025/ 查看

Kubernetes部署

运行容器：

bash
kubectl apply -f k8s-app.yml

添加NodePort服务：

bash
kubectl apply -f k8s-nodeport.yml
curl -v -H 'Host: demo.django-fluent.org' http://127.0.0.1:30000/en/

访问地址：http://localhost:30000/
卸载：

bash
kubectl delete -f k8s-nodeport.yml
kubectl delete -f k8s-app.yml

生产环境部署

构建镜像并运行：

bash
docker build -t fluentdemo .
docker run --rm -p 8080:8080 fluentdemo

访问地址：http://localhost:8080/

本地开发

前提条件

• Python >=2.7
• pip
• virtualenv（推荐virtualenvwrapper）

开发环境设置

bash
virtualenv env --prompt="(fluentdemo)"  # 或 mkvirtualenv fluentdemo
source env/bin/activate

cd src
make install
./manage.py migrate
./manage.py runserver

使用PostgreSQL数据库

默认使用SQLite，可切换为PostgreSQL：

bash
cp fluentdemo/settings/local.py.example fluentdemo/settings/local.py  # 启用调试
# 编辑fluentdemo/settings/local.py 定义DATABASES或导出DATABASE_URL

sudo su - postgres
createuser fluentdemo -P  # 默认密码testtest
createdb --template=template0 --encoding='UTF-8' --lc-collate='en_US.UTF-8' --lc-ctype='en_US.UTF-8' --owner=fluentdemo fluentdemo
exit

./manage.py migrate

编译SASS文件

开发时需编译SASS文件：

1. 安装NodeJS（或MacOS下用brew install libsass node）
2. 运行编译命令：

bash
npm run gulp

该命令会编译文件并监听变化，支持LiveReload（需安装浏览器插件）。

许可证

本项目采用Creative Commons Attribution 3.0 Unported License许可，django-fluent模块采用Apache License Version 2.0许可。