在Apache上部署Django项目
在Apache上部署Django项目
0.概述
Django是一个基于Python的web开发框架，在实际生产环境中部署的时候，还需要用Apache容器来部署。这里记录下如何在Debian系统中用Aapche和mod_wsgi模块来部署Django项目。
1.系统信息
$ uname -a
Linux iZ284ov0vfwZ 3.2.0-4-amd64 #1 SMP Debian 3.2.81-1 x86_64 GNU/Linux
$ lsb_release -a
No LSB modules are available.
Distributor ID: Debian
Description: Debian GNU/Linux 7.11 (wheezy)
Release: 7.11
Codename: wheezy
$ sudo apachectl -v
Server version: Apache/2.2.22 (Debian)
Server built: Aug 18 2015 09:49:50我用的是Debian发行版，Apache的配置与别的发行版有较大不同，这里以Debian为例进行说明，别的发行版需要进行一定的修改。
2. 安装Django和Apache
Django可以通过如下命令安装:
sudo pip install Django==1.9.0 #设置版本号为1.9.0Apache通过不同发行版的包管理命令安装。在debian下，是:
sudo apt-get install apache23. 安装mod_wsgi模块
mod_wsgi可以通过pip安装，但是需要提前在系统安装apache-dev包，但是在Debian发行版上，这个包名叫apache2-prefork-dev，详情参考这里。通过如下命令安装
sudo apt-get install apache2-prefork-dev此外，还需要安装python-dev包，如果要使用python3,则需要安装python3-dev包：
sudo apt-get install python-dev
# 如果要使用python3，则安装如下包
#sudo apt-get install python3-dev然后pip 安装mod_wsgi:
sudo pip install mod_wsgi此外也可以自己编译mod_wsgi：首先从这里下载文件包，然后解压，编译。假设版本是4.5.3，全部命令如下:
wget https://github.com/GrahamDumpleton/mod_wsgi/archive/4.5.3.tar.gz
tar -xvf 4.5.3.tar.gz
cd mod_wsgi-4.5.3
./configure
make
sudo make install如果要使用python3,则./configure那条命令改为./configure --with-python=/usr/bin/python3.4。
如果没有报错，那么mod_wsgi就编译好了!
编译好后，会在apache的模块目录/usr/lib/apache2/modules/生成mod_wsgi.so文件。
4.Apache配置文件目录结构
Apache的配置文件目录是/etc/apache2，该目录下的文件结构如下：
.
|-- apache2.conf
|-- conf-available
|-- conf-enabled
|-- envvars
|-- magic
|-- mods-available
|-- mods-enabled
|-- ports.conf
|-- sites-available
`-- sites-enabled其中apache2.conf是主配置文件，里面包括系统的设置，如Timeout的时长、Log的等级和格式等。ports.conf文件配置了监听的端口号，以及是否启用SSL。envvars和magic里面设置了一些环境变量相关的东西，我没怎么看过。
剩下的6个目录两两一对，availabel文件夹里面是所有的配置，而enabled目录里面则是启用的配置。而conf、mods和sites可以分别通过命令a2enconf、a2enmod、a2ensite来启用，启用后会在enabled目录下生成一个软链接，指向available目录下的同名文件。
在apache2.conf这个文件最后，是一些IncludeOptional 语句，用来将conf-enabled、mods-enabled、sites-enabled目录下的配置文件包含到主配置文件中。这样的好处是每个配置文件配置一个条目，比较清晰明了,易于查错。
5. 启用wsgi模块
我们需要在mods-available目录下新建mod_wsgi的load文件，具体操作如下:
cd /etc/apache2/mod-available
sudo echo " LoadModule wsgi_module /usr/lib/apache2/modules/mod_wsgi.so" >> wsgi.load
sudo a2enmod wsgi # 启用wgsi配置
sudo service apache2 restart # 重启Apache2服务6. 托管Django站点
假设Django项目的wsgi.py文件的路径是/home/yunfeng/Dev/git/mysite/mysite/wsgi.py，我们需要下面几步来完成Apache对Django项目的托管：
1. 修改Django项目中的wsgi.py和settings.py文件
修改wsgi.py文件，增加如代码中说明的那几行：
"""
WSGI config for travel_record project.
It exposes the WSGI callable as a module-level variable named ``application``.
For more information on this file, see
https://docs.djangoproject.com/en/1.9/howto/deployment/wsgi/
"""
import os
## 增加下面这几行
import sys
from os.path import dirname, abspath
from django.core.wsgi import get_wsgi_application
PROJECT_DIR = dirname(dirname(abspath(__file__)))
sys.path.insert(0, PROJECT_DIR)
#os.environ.setdefault("DJANGO_SETTINGS_MODULE", "travel_record.settings")
os.environ["DJANGO_SETTINGS_MODULE"] = "travel_record.settings"
## 增加结束
application = get_wsgi_application()增加的这几行代码做了2件事：1.将Django项目的的路径加入到系统路径中，使得Apache服务器可以找到wsgi.py文件；2. 修改os.environ的值，使得多个Django项目同时被Apache托管的时候不会出现串扰的问题。
接下来修改settings.py文件，主要修改的地方有3个：
- 将
DEBUG=True改为DEBUG=False - 将
ALLOWEND_HOSTS里面写上服务器的访问域名或IP地址 - 将
TEMPALTES中的DIRS改写成指向模板目录的绝对路径 Django项目里面需要修改的就这2个文件，下面的内容都是在/etc/apache2目录下进行操作。
2. 在/etc/apache2/sites-available目录下增加网站的配置文件
参照该目录下的000-default.conf和Django的教程，写出配置文件mysite.conf如下：
<VirtualHost *:8000>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
WSGIScriptAlias / /home/yunfeng/Dev/git/mysite/mysite/wsgi.py
Alias /static/ /home/yunfeng/Dev/git/mysite/mysite/static/
Alias /media/ /home/yunfeng/Dev/git/mysite/mysite/media/
<Directory /home/yunfeng/Dev/git/mysite/mysite>
<Files wsgi.py>
Order deny,allow
Allow from all
</Files>
</Directory>
<Directory /home/yunfeng/Dev/git/mysite/mysite/static/>
Order deny,allow
Allow from all
</Directory>
<Directory /home/yunfeng/Dev/git/mysite/mysite/static/>
Order deny,allow
Allow from all
</Directory>
</VirtualHost>整个配置文件是包含在VirtualHost的尖括号里面的一些设置，尖括号开始的地方，*:8000表示你希望的项目监听的端口号。
ErrorLog和CustomLog设置错误日志和访问日志的路径和格式。
WSGIScriptAlias设置wsgi文件的路径，Alias语句托管网站的static和media目录。
然后是<Directory>标签，用来设置文件和目录的访问权限。注意对于版本小于2.4的Apache，需要将<Directory>标签中的Order deny,allow和Allow from all改为Require all granted。
修改完后，执行下面的命令启用这个网站:
sudo a2ensite mysite.conf3. 修改/etc/apache2目录下的ports.conf文件
增加针对新建站点的端口号的监听：
Listen 80
#增加下面这条语句
Listen 8000执行完这3个步骤后，就可以重启Apache服务器，访问站点了：
sudo service apache2 restart访问站点，如果出现错误的话，可以在Django项目的settings.py中启用DEBUG模式，查看输出，进行相应的修改。