“How long will it take to fix that?” One person, who’d been at the company for years, said, “Three months.” A new person, who’d just come from a world of rapidly provisioned cloud microservices, said, “Three minutes.” They were both correct. That’s how change enters into this world – what is code

前言

我近年写过的Django项目基本都采用cookiecutter-django来启动

Cookiecutter Django is a framework for jumpstarting production-ready Django projects quickly.

cookiecutter-django将帮助你快速构建一个生产可用的项目骨架,通过初始化项目时回答几个问题,你将开箱得到许多常用的东西(往往遵循最佳实践),而避免配置

cookiecutter-djangopydanny构建,pydanny写过一本Django最佳实践相关的书《Two Scoops of Django》

cookiecutter-django介绍

cookiecutter-django相关的信息,项目readme里写的很清楚,我简单做些脚注

Features

Documentation

我倾向于使用docker,文档在Getting Up and Running Locally With Docker

建议有空多翻阅文档,文档里把开发和部署的大多数问题都谈论了

一些docker命令偏长,可以自行写个makefile

服务器的远程管理,推荐使用fabricansible比较重

optional-integrations

  • Serve static files from Amazon S3 or Whitenoise
    • 我偏向把文件存于本地,之后使用七牛云做镜像到本地,来分发(CDN),使用Whitenoise就不必使用nginx来处理静态文件了
    • 关于文件管理可以看下Caddy的插件filebrowser
  • Configuration for Celery
  • Integration with MailHog for local email testing
  • Integration with Sentry for error logging
    • 错误提醒及时(邮件通知),错误信息详细
    • 可以直接使用官方的云平台,不必自己搭建,目前国内可以正常使用

使用笔记

创建项目

我们使用cookiecutter替代django-admin startproject来初始化项目.

首先安装依赖pip3 install "cookiecutter>=1.4.0"

接着开始创建项目cookiecutter https://github.com/pydanny/cookiecutter-django,你讲被要求回答几个问题,关于项目的信息,以及你需要的组件,我的回答见: start_django_project.md

运行项目

我使用docker来运行项目,我们需要安装:

Build the Stack

docker-compose -f local.yml build

生产环境使用production.yml替代local.yml

第一次build需要一断时间

如果你添加了python库,需要重新build,不过所花时间要少很多

Run the Stack

docker-compose -f local.yml up

或者

1
2
3
export COMPOSE_FILE=local.yml
docker-compose up 
# docker-compose up -d # 后台运行

Execute Management Commands

1
2
docker-compose -f local.yml run --rm django python manage.py migrate
docker-compose -f local.yml run --rm django python manage.py createsuperuser # django django123

以上每个进程都跑在一个单独的容器中(无状态),进程结束即销毁,数据库使用公共的(由docker-compose up之前启动的)

其他

  • Mailhog跑在http://127.0.0.1:8025
  • 数据备份
    • 备份: docker-compose -f local.yml exec postgres backup
    • 列出: docker-compose -f local.yml exec postgres backups
    • 复制到本地: docker cp 9c5c3f055843:/backups/backup_2018_03_13T09_05_07.sql.gz .
    • 从本地恢复: docker-compose -f local.yml exec postgres restore backup_2018_03_13T09_05_07.sql.gz

一些个人意见

下边是一些围绕构建一个django项目,我个人所采取的一些策略

用户系统

使用django-allauth

用户账号相关的页面由后端做(django-allauth基本都做了,这部分逻辑考虑步骤可能会有安全问题),此外部分前后端分离

如果希望注册和登陆更灵活(提供REST接口),可以使用django-rest-auth。django-rest-auth做的主要工作是让django-allauth暴露出API。

关于User model

如果你对django自带的User model感到满意, 只是想额外增加field的话, 你可以扩展AbstractUser类,pydanny在《Two Scoops of Django》讨论过这块,提到有几种策略。扩展AbstractUser是第一种,目前cookiecutter-django用的也是这种

添加django-rest-auth

添加依赖之后,记得docker-compose -f local.yml build

django-rest-auth暴露出以下API

github登陆

记录一下,配置github登陆的流程

oauth github

开发者协同

  • git pull
  • docker build
  • 数据库分发备份

表单

  • 采集数据的表单,可以由后端来做,然后放在django admin里管理
    • admin + 表单十分迅速

参考