django-scaffold是一个快速初始化django项目的脚手架。
当你新写django项目的时候很多东西都是重复的:
0. virtualenv nginx 等必要安装
1. supervisor gunicorn nginx配置
2. django settings里面必须的配置，log, mako, memcached等等
3. 常用库(必用库)的安装, 或者说必用功能的安装，例如静态文件加hash码，用mako增强template等等
说好的DRY呢？
这个项目就是为了让你可以clone之后，简单的运行几个脚本就可以完成这些繁琐的配置，直接进到需求中去。
目前django版本采用1.6.1, 添加了一些js，可以自行选择，不过像plupload(传文件，做头像的时候)就需要IE9+了。
脚手架只是让你更快的初始django项目，减少重复的操作，因此像数据库的用户名密码配置，建库建表以前怎么玩django还是怎么玩。
脚手架提供了这些东西:
dev master两个环境: dev平时开发可以直接用，master是指生产可用的一些配置, 当然你可以用master做开发. dev采用django manager runserser, DEBUG=True的开发环境 master采用supervisor, gunicorn, nginx, DEBUG=False
一些有用的脚本(两个环境分开)： 包括项目的重命名，依赖库安装脚本，运行端口重置，启停项目脚本等等
如果想要方便的使用这个项目，有些约定是需要遵守的
-
linux or unix
-
在你个人项目下建立projects文件夹，相对于/opt建立软连接
cd ~ && mkdir projects && cd projects && sudo ln -s $(pwd)/projects /opt -
将项目克隆到
/opt/projects下 -
脚本使用顺序
第一步,你需要重命名clone回来的项目，用这个脚本
rename_and_backup.py; 第二步, 你需要配置项目运行时的端口号reset_port.py; 第三步，安装各种依赖install.sh(这个脚本执行一次即可); 第四步，配置nginxconfig_dev_nginx.sh和config_dev_nginx.sh; 第五步, 创建数据库，并且syncdb. create database配置中的数据库名字DEFAULT CHARACTER SET utf8 ; 第六步, 运行项目run_dev.sh和run_master.sh.其中你可以看到有dev, master两个版本, dev采用django 默认的runserver来做，并且配置文件中DEBUG=True,master版本采用supervisor, gunicorn来做python容器，静态文件有nginx代理,如果是master你需要先collect静态文件 文件结构
$ tree -L 1
.
├── app
├── deploy
├── django-scaffold
├── LICENSE
├── manage.py
├── README.md
├── requirements.txt
├── static_dev
├── statics
├── templates
└── tools
django-scaffold 项目名，下面放基本的settings配置
templates html模板丢在这里
static_dev 开发是静态文件放这里(css/js等)
statics collectstatic最终的目标路径 nginx查找的目录
deploy部署相关的配置
tools各种有用的脚本
requirements pip依赖
app 就是普通的模块
/var/log/django-scaffold下有各种log
/run/下有gunicorn supervisor的pid
- mako支持: template可以随意使用python语法
- 静态文件collect后添加hash: 再也不用怕更新静态文件后缓存不变了(不适用云存储)
- supervisor, gunicorn, nginx部署配置: 生产环境配置就不用说了
- rename脚本，可以直接将django-scaffold改为你想要的名字: 脚手架
- reset_port脚本，可以将gunicorn, nginx, supervisor中django运行的端口改为你期望的端口号: 脚手架
- install脚本: 一键安装依赖, 可以根据这个脚本手动安装
- config_nginx脚本，当你修改代码的nginx配置时,执行此脚本可以更新nginx: 缓解nginx小白的一点点困惑
- run脚本，分为可以简化django启停命令，分为dev和master两种环境: 看看这个脚本吧
- memcached: 缓存就不用说了
- xadmin: admin很强大，但是如果做出一套系统给别人用，原生的admin实在是无力吐槽
- 单元测试时默认使用sqlite3: 让单元测试飞起来
- 使用邮箱做用户名, 可以选择开启或者关闭, 这个在项目初期最好就确定(before first syncdb)
- south: 并且提供了几个south的使用脚本
- 静态文件系统可以选择使用云存储，默认七牛(dev模式下回关闭云存储)
- 传文件采用plupload, 可以自己定制样式, 图片时可以在客户端部分进行resize, 支持预览(data-url IE9+)
. 支持中国社交网站的三方登录: 已经添加fork后的social auth库以及配置
. 切图片: 现在已经有了client端的解决方案, plupload, 后端可以用pillow
. 分页
. rest service
. 权限的一些东西
. 正式上线修改nginx域名的脚本
####USE_YUN_STORAGE 使用云存储 默认是采用pipeline即在某台linux上面做静态文件，nginx代理到此处, 这种方式会在静态文件上加hash
云存储默认有七牛，默认不加hash, 如果使用hash版本的话, manage command使用eccollect的这些
当添加了新的js时， 需要采用 python manage.py createstaticmanifest, 之后collect是使用 python manage.py eccollect
[ecstatic]
createstaticmanifest
eccollect
hashmedianames
####rename_and_backup.py 备份并且重命名脚本, 会将项目中所有的old name全部替换为new name,包括各种配置文件等.
cd /opt/projects/{your old project name}/tools
./rename_and_backup.py
输入文件名
脚本执行结束后会在 /opt/projects/{your new project name}有新的项目
####reset_port.py 端口重置脚本，因为一台机器上django的端口可能之前就被占用了, port.json显示了此项目使用的端口(不要修改这个json文件)
####install.sh 安装pip 配置豆瓣源 建立virtualenv 安装requirements 建立log文件夹
####config_dev_nginx 将dev版本的nginx丢到nginx配置环境，并且reload nginx
####config_master_nginx 将master版本的nginx丢到nginx配置环境，并且reload nginx
####run_dev.sh 使用django manage.py runserver 的方式运行测试环境，采用settings-dev.py这个配置文件
####run_master.sh supervisor, gunicorn, nginx的方式运行正式环境
dev log: `tail -f /var/log/django-scaffold/dev-stdout.log`
master log: `tail-f /var/log/django-scaffold/stderr.log`
nginx access log: `tail -f /var/log/django-scaffold/ngaccess.log`
nginx error log: `tail -f /var/log/django-scaffold/ngerror.log`