记一次在 Linux 上创建 Django 应用的过程

0 环境与目标

0.1 环境

• 服务器端
  • 操作系统： Ubuntu 14.04.2 LTS
  • 运行时： Python 3.4.0
• 客户机端
  • 浏览器： Firefox 37.0.1
  • 数据库客户端： Navicat Premium 11.1.10

0.2 目标

在服务器端开始一个 Django 工程，采用 PostgreSQL 数据库。

0.3 要点

• Django 安装
• PostgreSQL 安装
• Django 初始化数据库
• 启动Django 服务

1 实施

1.1 Django 准备

1.1.1 安装 Django

这里安装最新的 Django

$sudo pip3 install django

如果是在原有基础上升级安装 Django，则输入一下命令

$sudo pip3 install django --upgrade

pip 会将旧版本的 Django 卸载后安装最新版。
注意，这里使用的命令是 sudo pip3 而不是简单的使用 pip，是因为没有在 virtualenv 环境下安装，所有操作都是在操作系统实环境下完成的，而 Ubuntu 缺省的 Python 环境是 Python 2，很多系统基础软件都是基于这个版本的 Python 开发，强行改为缺省使用 Python 3 会遇到各种蛋疼的情况（不要问我为什么知道）。之所以采用这种方式，是因为这里只是我个人用来练习的项目，没有生产意义，偷懒没有严格做隔离控制。在生产上做开发部署，经常会有多版本并行使用的需求，需要根据实际情况配置开发和生产环境，这里不做详细讨论。

1.1.2 创建 Django 工程

这里先创建一个名为 teamtea 的项目

$cd workspace/django
$django-admin starproject teamtea

没错，现在可以直接使用 Django 的工程管理命令 django-admin 了。
这里将工程创建好之后先放在一边，稍后进行配置。

1.2 PostgreSQL 准备

1.2.1 安装 PostgreSQL

Ubuntu 官方源的 PostgreSQL 总是会慢一个小版本，版本控表示不愉快，于是按照官方网站上的说明安装了最新版。
首先将 PostgreSQL 官方源添加到 apt 源列表。在 /etc/apt/source.list.d/ 目录下创建 pgdg.list 文件，文件内容为

deb http://apt.postgresql.org/pub/repos/apt/ trusty-pgdg main

这里是针对 Ubuntu 14.04 的源，其他版本的系统可以在文档中找到相关的源。
然后导入源的签名。

$wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -

至此就将 PostgreSQL 的官方源添加到源列表中了。接下来更新包列表，安装需要用到的 postgresql-9.4 和 postgresql-server-dev-9.4 两个包。

$sudo apt-get update
$sudo apt-get install postgresql-9.4 postgresql-server-dev-9.4

至此完成了 PostgreSQL 9.4 的基本安装。
同样需要注意的是，这里的数据库版本选择纯粹因为个人喜好，实际开发和生产过程中应按需选择版本。

1.2.2 配置访问权限

安装完 PostgreSQL 之后会自动在系统中创建名为 postgres 的用户，即是 PostgreSQL administrator 用户，对 PostgreSQL 的操作最好都由这个用户来进行，尽量避免使用 root 用户。为了使用这个用户，首先需要修改它的密码。

$sudo passwd postgres

postgres用户密码和访问

以上是操作系统中的 postgres 用户的操作，而我们知道数据库管理系统也有用户的概念，PostgreSQL 的管理员用户也是 postgres，为了能够使用它管理数据库，同样需要设置密码。首先登录到 postgres 用户下，

$su postgres

然后进入 PostgreSQL 的管理程序 psql，此时是不需要密码的，因为访问控制项缺省为 peer 即只允许本地操作系统上的 postgres 用户访问。

$psql

此时命令提示符变为 postgres=#，说明进入了 psql 环境，设置密码，

postgres=# \password

然后退出 psql 环境，

postgres=# \q

之后修改 postgres 用户的访问控制项，编辑 /etc/postgresql/9.4/main/pg_hba.conf 文件，将

local   all             postgres                                peer

修改为

local   all             postgres                                md5

重新载入配置文件使修改生效，

$pg_ctlcluster 9.4 main reload

注意 Debian 系的 Linux 采用的是 pg_ctlcluster 命令，而非 pg_ctl 命令。
此时再次尝试使用 psql 就需要输入密码了。

为了能使客户机上的 Navicat 登录管理 PostgreSQL，需要开启对网络端口的监听，编辑 /etc/postgresql/9.4/main/postgresql.conf 文件，将

#listen_addresses = ‘localhost‘ 

修改为

listen_addresses = ‘*‘ 

注意，这里去掉了行首的注释。同样，重新载入配置文件使修改生效。

1.2.3 创建应用用户和数据库

现在可以通过 Navicat 连接管理 PostgreSQL 数据库了，在图形化界面下很容易创建用户和数据库，这里创建与应用同名的用户和数据库就好了，全部命名为 teamtea。

同样需要添加访问权限，编辑 /etc/postgresql/9.4/main/pg_hba.conf 文件，添加一行

local   teamtea             teamtea                                md5

这里限制了用户 teamtea 只能访问名为 teamtea 的数据库，这对应用来说是足够的，对整个数据库系统来说也是安全的。
完成上述工作后，就可以退出 postgres 用户了。

以下为草稿

1.3 配置 Django，启动服务

1.3.1 配置 Django

现在可以开始配置我们的 Django 工程 teamtea 了，进入工程目录，编辑文件 /teamtea/settings.py 文件，将数据库配置项修改为

DATABASES = {
    ‘default‘: {
        ‘ENGINE‘: ‘django.db.backends.postgresql_psycopg2‘,
        ‘NAME‘: ‘teamtea‘,
        ‘USER‘: ‘teamtea‘,
        ‘PASSWORD‘: ‘teamtea‘,
        ‘HOST‘: ‘localhost‘,
        ‘PORT‘: ‘5432‘,
    }
}

关于数据库配置项可以参考官方文档。

这里同时将工程的时区设置为 UTC+8 即北京时间，将时区配置项修改为

TIME_ZONE = ‘Asia/Shanghai‘

1.3.2 初始化项目

现在可以对工程进行初始化了，需要说明的是，从 Django 1.7 开始已经将原有的数据库同步命令 syncdb 标记为 deprecation 了，并将在 1.9 中完全删除该命令，取代它的是 migrate 命令，

python3 manage.py migrate

这里需要说明的是，因为 Django 是通过 pip3 安装在 Python 3 的实环境下的，在执行 manage.py 脚本之前需要指定运行环境为 Python 3，否则会找不到 Django，使用 virtualenv 会有所改善。

1.3.3 启动服务

现在可以启动 Django 内置的简单测试用 web 服务器来测试整个工程是否可以运转起来了，

python3 manage.py runserver 0.0.0.0:8000

这里需要指定 IP 和端口号，否则只能在本地访问。
现在打开用户机的浏览器，访问 http://IP:8000 就可以看到调试用的页面了，说明程序运行正常。
终止服务只需要 Ctrl-C 终止进程就行了。

2 总结

2.1 过程小结

整个过程还是因为不熟悉走了不少弯路，尤其是在我的短板数据库这一块，对 PostgreSQL 还需要加强学习啊。

2.2 还可以做的工作

作为学习用的工程搭建过程，这边文章描写的步骤勉强是够用的，但是还显得很简陋，还有很多工作可以做，例如使用 virtualenv 管理开发环境，避免直接在实环境下进行开发。还可以使用 git 来进行版本控制，这既是在学习阶段也是很有必要的，它能帮助记下每次可以正常运行的代码，防止某次改动后程序无法运行而又毫无头绪的尴尬情形。
当然，部署 web 应用还可以使用 uwsgi + nginx 的方式，不过这更复杂，对 Django 的学习来说意义不大，可以当做另外一个主题去研究了。