django部署

原创
2016/02/17 09:00
阅读数 102

之前有篇文档写到,django 的 apache 部署很恶心,我没太明白什么意思,实际自己操作时,才深有体会,恶心的意思是:明明感觉很简单,看别人的文档也挺短,但如果新手可能要弄1、2天才行,而且最关键的是毫无成就感。原因是变数太多:

    文档的时效性
    平台环境
    软件环境
    目标的目录配置
    主机域名等的设置

        ...

  这些的不同,造成软件的部署过程总是磕磕绊绊。为了降低挫折感,本文通过分步骤试验逐渐实现最终目标。

参考文档:

    django+wsgi 我是照着这篇首次成功的

    apache 配置文档

    apache2 ubuntu环境配置

软件环境:

    ubuntu 12.04 64位
    python 2.7.3
    django 1.5.1
    apache 2.2
    mod_wsgi 3.3

目标:

    在 ~/firstdj 中建立一个django项目
    使用 apache wsgi 方式提供web服务
    通过 http://firstdj/ 访问hello页面

准备:安装需要的软件

  这个比较简单,没什么特别注意的。

     # 安装 apache2

    $ sudo apt-get -y install apache2-mpm-worker apache2-dev

     # 安装 python

    $ sudo apt-get -y install python python-dev python-setuptools

     # 安装 python 的辅助软件

    $ sudo easy_install virtualenv virtualenvwrapper pip

实验一、使用apache2提供静态页面

目的:

        验证 apache2的安装
        配置虚拟主机

apache 预备知识

    可执行程序 /usr/sbin/apache2

    配置文件目录 /etc/apache2/

    网站(web)文件目录 /var/www

        这个可以配置,修改 /etc/apache2/sites-available/default 这个文件的下面的字段 DocumentRoot /var/www ,比如你改到/var/temp 那么就把这行改成:

            DocumentRoot /var/temp

    配置文件并不是在httpd.conf里面,而是apache2.conf,而这里面并没有配置所有的东西,如端口是在ports.conf这个文件里面,而网站的根目录是在

        /etc/apache2/sites-available/default

    这个文件中。 虽然也有httpd.conf这个文件,但是httpd.conf里面是空的,其实你可以在这里面加一些配置,因为apache2.conf里面会把httpd.conf加到它的文件里面。

操作思路

        修改主机名字为 firstdj ,作为域名
        禁用系统默认的 default 虚拟站点
        建立一个最简化的虚拟主机,使用 http://firstdj/ 访问。

具体步骤

    修改主机名

          通过修改/etc/hostname把主机名改为 firstdj ,为了清晰,进入root账户)。

        $ sudo su
        # echo "firstdj" > /etc/hostname
        # echo -e "\n127.0.0.1 firstdj.local firstdj\n" >> /etc/hosts
        # hostname -F /etc/hostname

          默认这个时候已经能够在 http://firstdj/ 访问了。如果你能够看到 It works! 页面,说明 apache2 安装正常。否则检查 apache2 是否在运行:

        $ sudo su
        # service apache2 status      # 查看状态
        # service apache2 start       # 启动
        # service apache2 stop        # 停止
        # service apache2 reload      # 重新应用配置文件
        # service apache2 restart     # 重新启动进程

    配置虚拟主机

          虽然这时候能够访问 http://firstdj/ ,但实际上是ubuntu系统本身安装后给的默认配置

        $ cd /etc/apache2                  # 进入 apache2 的配置目录
        $ ls ./sites-enabled               # 查看当前生效的站点
                返回 000-default , 这是ubuntu默认启动的站点

        $ sudo su
        # a2dissite default                # 取消默认站点 default 
                这时候sites-enabled目录下没有文件
        # service apache2 reload           # 使配置生效

          现在刷新一下 http://firstdj/ ,应该已经不能访问了。现在 /etc/apache2/sites-available/ 目录下,建立一个名为 firstdj 的文件,为了清晰,我尽量进行了删减,具体内容如下:

            <VirtualHost *:80>
                ServerName firstdj
                DocumentRoot /var/www
            </VirtualHost>

          配置文件建立完毕,我们让它生效。

        $ sudo su
        # a2ensite firstdj                 # 激活 firstdj 站点
        # ls /etc/apache2/sites-enabled/   # 查看当前生效的站点
                返回 firstdj ,表示只有firstdj站点有效

        # apachectl configtest             # 检查一下 apache2 配置文件语法
                返回结果:
                apache2: Could not reliably determine the server's 
                         fully qualified domain name, using 
                         127.0.0.1 for ServerName
                Syntax OK

        # echo -e "\nServerName firstdj\n" >> /etc/apache2/apache2.conf
                在 apache2.conf 中增加主机名后解决报错问题

        # apachectl configtest             # 这次结果应该只有 Syntax OK

        # service apache2 reload

          现在又能够正常访问 http://firstdj/ 。

实验二、安装配置 wsgi 模块

操作思路

        安装 wsgi 模块
        配置一个简单的虚拟主机

具体步骤

    安装 mod_wsgi

          我为了省事,采用源安装,如果需要3.4版本,可以采用源码安装,参考这里。

        wsgi主站
        编译安装wsgi

        $ sudo apt-get install libapache2-mod-wsgi   #安装 mod_wsgi

        $ sudo dpkg -l libapache2-mod-wsgi           #查看wsgi的版本
               结果: libapache2-mod 3.3-4build1

        $ a2enmod wsgi                               #验证模块安装正常 
                Module wsgi already enabled

    验证 wsgi

          为了验证wsgi的正常使用,准备手工建一个最简单的wsgi应用,实际就是一个py脚本。

        在 /var/www/目录下,建立一个名为 main.wsgi 文件,内容如下:

           def application(environ, start_response):  
                status = '200 OK'  
                output = 'Hello World!\n试试中文'  
                response_headers = [('Content-type', 'text/plain'),  
                    ('Content-Length', str(len(output)))]  
                start_response(status, response_headers)  
                return [output]

        在 /etc/apache2/sites-available/firstdj 中增加一行,同时可以取消 DocumentRoot 配置,修改后内容如下:

           <VirtualHost *:80>
                ServerName firstdj

                WSGIScriptAlias / /var/www/main.wsgi

           </VirtualHost>

        应用配置

        $ sudo service apache2 reload

        现在刷新 http://firstdj 能够返回

            Hello World!

        说明 wsgi 解析正常

实验三、直接安装django

  在实际生产环境,通常会使用 virtualenv 来支持多版本的python应用,但是同样也增了 wsgi 的配置复杂性,所以先进行最简单的试验。

目的:

        在本机安装 django
        配置 apache + wsgi

操作思路

        在系统范围安装 django (不使用 VirtualEnv)
        使用 wsgi 解析 django
        跑通 django book 的 helloworld 例子.

具体步骤

    安装 django

        $ sudo pip install django

    系统默认会把 django 安装到 /usr/local/lib/python2.7/dist-packages 目录中

    在 ~/目录建立一个 django 项目

        $ cd ~                                  # 进入home目录
        $ django-admin.py startproject firstdj  # 建立一个 firstdj 项目
        $ cd ~/firstdj
        $ python manage.py runserver            # 启动django测试服务器

    访问 http://127.0.0.1:8000/ ,能够看到 django 的 It Worked! 页面,说明django安装正常。

    配置 wsgi 解析 django

     1. 修改 django 项目的 ~/firstdj/firstdj/wsgi.py 文件

        去掉注释后,默认的 wsgi.py 文件内容为:

            import os

            os.environ.setdefault("DJANGO_SETTINGS_MODULE", "firstdj.settings")
            from django.core.wsgi import get_wsgi_application
            application = get_wsgi_application()

        增加 firstdj 项目的路径到系统路径,修改后完整的 wsgi.py 文件内容如下:

            import os

            import sys
            root_path = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
            sys.path.insert(0, os.path.abspath(os.path.join(root_path, 'firstdj')))
            sys.path.insert(0, root_path)

            os.environ.setdefault("DJANGO_SETTINGS_MODULE", "firstdj.settings")
            from django.core.wsgi import get_wsgi_application
            application = get_wsgi_application()

     2. 修改 apache2 的配置文件 /etc/apache2/sites-available/firstdj

        更换文件中的 main.wsgi 为刚才修改的 wsgi.py , 修改后的内容是:

            <VirtualHost *:80>
                ServerName firstdj
                WSGIScriptAlias / /home/bl/firstdj/firstdj/wsgi.py
            </VirtualHost>

     3. 重新应用 apache2 配置文件

             $ sudo service apache2 reload

    访问 http://firstdj/ ,能够看到 django 的 It Worked! 页面,说明django安装正常。

    建立一个 django 的 hello world

    1. 新建 ~/firstdj/firstdj/views.py 文件,内容如下:

        # -*- coding: UTF-8 -*-
        from django.http import HttpResponse

        def hello(request):
            return HttpResponse("This is django Hello World")

    2. 修改 ~/firstdj/firstdj/urls.py 文件,增加 hello的映射,去掉注释后内容如下:

        from django.conf.urls import patterns, include, url

        urlpatterns = patterns('',

            url(r'^$', 'firstdj.views.hello'),

        )

    3. 验证 hello world 正常

        $ cd ~/firstdj/
        $ python manage.py runserver

        访问 http://127.0.0.1:8000/ ,能够看到 This is django Hello World 页面,说明 hello 配置正常。

    4. 重新应用 apache2 配置文件

        $ sudo service apache2 reload

        访问 http://firstdj/ ,能够看到 django 的 This is django Hello World 页面,说明django 被 wsgi 正常解析了。

实验四、通过 virtualenv 使用 django

  在刚才成功的基础上,使用 virtualenv 的方式使用 django,核心的问题是修改 ~/firstdj/firstdj/wsgi.py 文件,指定正确的。

目的:

        配置 virtualenv 环境下的 django + apache + wsgi
        virtualenvwrapper 方式下的配置

操作思路

        删除系统级的 django
        在 ~/firstdj/ 目录下,配置 virtualenv
        使 http://firstdj/ 生效
        使用 virtualenvwrapper 方式

具体步骤

    删除系统 django

        $ sudo pip uninstall django

    在 ~/firstdj/ 目录下建立 venv 环境

        $ cd ~/firstdj/
        $ virtualenv venv

    现在 ~/firstdj/ 目录下的结构是:

/home/bl/firstdj
    |---venv
    |    |---local
    |    |---include
    |    |---lib
    |    |    |---python2.7
    |    |    |        |---site-packages
    |    |    |        |            |---pip-1.3.1-py2.7.egg
    |    |    |        |            |                  |---EGG-INFO
    |    |    |        |            |                  |---pip
    |    |    |        |            |                  |    |---commands
    |    |    |        |            |                  |    |---backwardcompat
    |    |    |        |            |                  |    |---vcs
    |    |    |        |---distutils
    |    |---bin
    |---firstdj

    在新建的 venv 环境下安装 django

        $ cd ~/firstdj/
        $ ~/firstdj/venv/bin/pip install django

    把新建的 venv 环境下的python 包路径(~/firstdj/venv/lib/python2.7/site-packages/) 加入系统路径中。

     1. 在 ~/firstdj/firstdj/wsgi.py 文件中增加一行,修改后内容如下:

        import os
        import sys

        root_path = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
        sys.path.insert(0, os.path.abspath(os.path.join(root_path, 'firstdj')))
        sys.path.insert(0, root_path)

        sys.path.insert(0, os.path.abspath(os.path.join(root_path, 'venv/lib/python2.7/site-packages/')))

        os.environ.setdefault("DJANGO_SETTINGS_MODULE", "firstdj.settings")
        from django.core.wsgi import get_wsgi_application
        application = get_wsgi_application()

    2. 重新应用 apache2 配置

        $ sudo service apache2 reload

    现在访问 http://firstdj/ ,又能够看到 django 的 This is django Hello World 页面。

    最后一步就是在 virtualenvwrapper 环境下配置 wsgi , 和普通 virtualenv 的环境的唯一不同是virtualenvwrapper 的python 安装包路径默认在 ~/.virtualenvs 目录下,比如以环境名 ELC 为例,它的安装包路径是:

        /.virtualenvs/ELC/lib/python2.7/site-packages

    相应的修改 ~/firstdj/firstdj/wsgi.py 文件,修改后内容如下:

        import os
        import sys

        root_path = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
        sys.path.insert(0, os.path.abspath(os.path.join(root_path, 'firstdj')))
        sys.path.insert(0, root_path)

        sys.path.insert(0, '/home/bl/.virtualenvs/ELC/lib/python2.7/site-packages/')

        os.environ.setdefault("DJANGO_SETTINGS_MODULE", "firstdj.settings")
        from django.core.wsgi import get_wsgi_application
        application = get_wsgi_application()

          再次重新应用 apache2 配置后,访问 http://firstdj/ ,又能够看到 django 的 This is django Hello World 页面。

    增加django的静态链接

          为了能够访问 django 的静态文件,比如各种模版,还需要在 /etc/apache2/sites-available/firstdj 中设置一些别名,最终完整的 apache2 虚拟站点通常是这个样子:

    <VirtualHost *:80>
        ServerAdmin root@firstdj
        ServerName firstdj

        Alias /site_media/ /home/bl/firstdj/site_media/
        Alias /robots.txt /home/bl/firstdj/site_media/robots.txt
        Alias /favicon.ico /home/bl/firstdj/site_media/favicon.ico
        Alias /static/ /home/bl/.virtualenvs/ELC/lib/python2.7/site-packages/django/contrib/admin/static/

        CustomLog "|/usr/sbin/rotatelogs /home/bl/firstdj/logs/access.log.%Y%m%d-%H%M%S 5M" combined
        ErrorLog "|/usr/sbin/rotatelogs /home/bl/firstdj/logs/error.log.%Y%m%d-%H%M%S 5M"
        LogLevel warn

        WSGIDaemonProcess firstdj user=bl group=bl processes=1 threads=15 maximum-requests=10000 python-path=/home/bl/.virtualenvs/ELC/lib/python2.7/site-packages/ 
        WSGIProcessGroup firstdj
        WSGIScriptAlias / /home/bl/firstdj/firstdj/wsgi.py

        <Directory /home/bl/firstdj/firstdj/site_media>
            Order deny,allow
            Allow from all
            Options -Indexes FollowSymLinks
        </Directory>

    </VirtualHost>
展开阅读全文
打赏
1
1 收藏
分享
加载中
更多评论
打赏
0 评论
1 收藏
1
分享
返回顶部
顶部