阿里云高性能服务器2折起:点我购买
在经历了无数的大坑后,终于按照网上一个比较简单的教程把自己的Blog做好了。后来在部署的时候又发现了无数的坑,于是有了这篇django部署教程,希望看到这篇教程的同学能少入坑,顺顺利利的部署成功自己的Blog。
希望同学们能认认真真看完此教程,我会尽我所能把每一步都讲的明白(虽然我也是个小白),下面让我们开始这坑爹而又有趣的部署之旅吧:
一、前提和环境
首先,本教程是假设你已经有了一个django项目且能在本机正常运行的外加一个可以正常使用的ubuntu。其次你可以不懂linux,因为照着教程走,不会有太大的问题,但最好有一点python和django基础。
环境:
python 3.4 (一般ubuntu自带py2和py3)
ubuntu-14.10-desktop、ubuntu-14.04-server(可以在win7下使用虚拟机)
django 1.7.1
apache 2.4.7
坑一:务必保持你的开发环境和我上述三个一样,否则可能会出现莫名其妙的问题,这是一个大坑。
二、入坑
virtualenv和django配置
1、首先ctrl+alt+t进入终端,然后我们安装python3-pip,pip类似ubuntu的apt-get可以方便的安装各种python库:
sudo apt-get install python3-pip
坑二:ubuntu默认安装py2和py3,终端输入“python”是py2环境,输入“python3”是py3环境。在ubuntu中如果想使用py3的pip请使用:“pip3”命令。“pip”命令为py2的,这点请注意。
2、安装python的虚拟环境virtualenv,virtualenv是一个可以虚拟多个python环境的东东,比如我的a网站是py2+django1.7开发,b网站是py3+django1.8开发。他们两个想共存于一台电脑上就要用到这个东东:
sudo pip3 install virtualenv
3、创建虚拟环境,此命令会创建一个名为venv的文件夹,位置就在你终端所显示的位置,里面包含了一个python环境。可以把它理解成类似与windows上的一个虚拟机系统,只不过他只是python的。
virtualenv venv
4、激活虚拟环境,相当于开启虚拟机系统,激活后,在这个激活的终端内执行的任何python命令都不会影响真实环境。注意如果你现在没有在venv的上级目录下,下面的命令是会报错的。可以用source后面跟完整的venv的路径。
source venv/bin/activate
5、安装django,到这里,就离最终成功迈出了关键的一步了,终于开始安装我们的主角django了,这里我安装的版本是1.7.1,安装前请再次确认你所开发的或者下载别人的django网站的版本和你安装的保持一致。
pip install -v django==1.7.1
小知识:在这里,我们使用pip而不是pip3的原因是虚拟环境里只有py3的存在,所以我们输入“python”和“pip”所关联的都会是py3的。你可以自己实验下在虚拟环境中输入是不会报错的,而在真实的环境里则会是显示py2。
6、安装所必须的python包,这里请根据你自己所开发的网站需要的包用“pip”进行安装,下面命令是我的blog所需要用到的包:
pip install django-ckeditor
pip install django-haystack
pip install whoosh
pip install jieba
pip install django-pagination-py3==1.1.1
坑三:安装分页插件pagination的时候,如果你是py3,请使用pip install django-pagination-py3==1.1.1命令安装,网上很多文章针对的都是py2的,当你用网上的命令安装这个插件后,在py3下是不会有效果的。
7、安装git,因为我是在server上面部署的,没有图形界面,所以我用git来下载我开发好的网站去部署就需要用到git了。git部分这里不再讲解,原因很简单,因为博主也不是很会啊!其实只要会上传到github然后会下载下来对于此文章来说就够了。如果你不是用的server版那就直接复制粘贴就更方便啦。(复制粘贴的请无视7和8条)
sudo apt-get install git
8、下载所需要的网站,这里我给出一个我的blog的源码,当然这也只是我做实验用的,你完全可以下载下来去学习,修改它。前提是你明白这是一个十分简陋的博客,仅供开发学习使用。
git clone https://github.com/juventusryp/test.git
坑四:如果你是新手刚开始学习django,下载下来后,请使用“mv test my_blog_2"更改文件夹名字,会省去你很多麻烦。
9、初始化数据库,删除根目录下的数据库文件:db.sqlite3和article目录下的migrations文件夹。命令是“sudo rm -rf”加文件名。
然后运行下面的命令初始化数据库:
python manage.py migrate
初始化完毕后,建立后台管理员:
python manage.py createsuperuser
10、至此,一个网站应该是可以正常浏览了,请使用“python manage.py runserver”测试看是否可以正常浏览,如果正常,那么恭喜你,下面再只需要几步,就可以把你的网站部署到服务器上让大家都看到了。
二、部署部分
1、进入ubuntu,安装apache2和mod_wsgi:
sudo apt-get install apache2 libapache2-mod-wsgi-py3
坑五:此处如果你是py2开发的话去掉上述命令最后的“-py3”,否则最好加上。
2、查看apache2版本:
apachectl -v
看看是否是2.4.7版本
3、新建一个网站,这里是创建一个网站的配置文件,具体不再阐述,请自行学习apache的相关文档。
sudo vim /etc/apache2/sites-available/sitename.conf
我的sitename.conf如下,此文件仅作参考,请自行修改里面的相关路径和网址:
<VirtualHost *:80>
# The ServerName directive sets the request scheme, hostname and port that
# the server uses to identify itself. This is used when creating
# redirection URLs. In the context of virtual hosts, the ServerName
# specifies what hostname must appear in the request's Host: header to
# match this virtual host. For the default virtual host (this file) this
# value is not decisive as it is used as a last resort host regardless.
# However, you must set it for any further virtual host explicitly.
#ServerName www.example.com
ServerName localhost:80
ServerAlias otherdomain.com
ServerAdmin xxx@qq.com
Alias /media/ /home/user/my_blog_2/media/
Alias /static/ /home/user/my_blog_2/static/
<Directory /home/user/my_blog_2/media>
Require all granted
</Directory>
<Directory /home/user/my_blog_2/static>
Require all granted
</Directory>
WSGIDaemonProcess http://127.0.0.1:80 python-path=/home/user/my_blog_2:/home/user/venv/lib/python3.4/site-packages
WSGIProcessGroup http://127.0.0.1:80
WSGIScriptAlias / /home/user/my_blog_2/my_blog_2/wsgi.py
<Directory /home/ryp/my_blog_2/my_blog_2>
<Files wsgi.py>
Require all granted
</Files>
</Directory>
# Available loglevels: trace8, ..., trace1, debug, info, notice, warn,
# error, crit, alert, emerg.
# It is also possible to configure the loglevel for particular
# modules, e.g.
#LogLevel info ssl:warn
ErrorLog ${APACHE_LOG_DIR}/error-my_blog_2.log
CustomLog ${APACHE_LOG_DIR}/access-my_blog_2.log combined
# For most configuration files from conf-available/, which are
# enabled or disabled at a global level, it is possible to
# include a line for only one particular virtual host. For example the
# following line enables the CGI configuration for this host only
# after it has been globally disabled with "a2disconf".
#Include conf-available/serve-cgi-bin.conf
</VirtualHost>
# vim: syntax=apache ts=4 sw=4 sts=4 sr noet
坑六; 如果在服务器上使用了虚拟环境,配置文档里加上下面三行应该才可以,这里网上很多文章都没有说清楚,当初坑了博主相当长时间。
WSGIDaemonProcess http://127.0.0.1:80 python-path=/home/user/my_blog_2:/home/user/venv/lib/python3.4/site-packages
WSGIProcessGroup http://127.0.0.1:80
WSGIScriptAlias / /home/user/my_blog_2/my_blog_2/wsgi.py
4、修改wsgi文件,我的路径就是/home/user/my_blog_2/my_blog_2/wsgi.py 请找到你的路径修改如下:
"""
WSGI config for my_blog_2 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.7/howto/deployment/wsgi/
"""
import os
from os.path import join,dirname,abspath
PROJECT_DIR = dirname(dirname(abspath(__file__)))
import sys
sys.path.insert(0,PROJECT_DIR)
os.environ["DJANGO_SETTINGS_MODULE"] = "my_blog_2.settings"
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()
是不是已经有点看不下去了?不要急,到最后一步了,坚持一下。完成下面的,我们的部署坑之路就算走完了。
5、设置权限,linux下对权限很敏感,建议大家先对这块有所了解。博主就不是很懂,所以很多地方都是根据log来一步一步调试的。
在 Linux 服务器上,用户上传目录还要设置给 www-data 用户的写权限,下面的方法比较好,不影响原来的用户的编辑。
假如上传目录为 my_blog_2/media/uploads 文件夹,进入media文件夹,将 uploads 用户组改为www-data,并且赋予该组写权限:
cd media/
sudo chgrp -R www-data uploads
sudo chmod -R g+w uploads
如果你使用的是sqlite3数据库,还会提示 Attempt to write a readonly database,同样要给www-data写数据库的权限
进入项目目录的上一级,比如project目录为 /home/user/my_blog_2, 那就进入 /home/user 执行下面的命令(和修改上传文件夹类似)
sudo chgrp www-data my_blog_2
sudo chmod g+w my_blog_2
sudo chgrp www-data my_blog_2/db.sqlite3 # 更改为你的数据库名称
sudo chmod g+w my_blog_2/db.sqlite3
坑七:如果你是用我的test的网站学习,应该还会有些小问题,比如在写好文章发布的时候会报错,那是因为有个插件的权限问题,请打开debug模式,修改那个插件所在文件夹的权限即可。
6、纳尼!不是说已经可以正常访问了吗,怎么还有!博主保证下面一定是最后一步
切换到目录:/etc/apache2/sites-available/ 运行:
sudo service apache2 reload
sudo a2dissite 000-default && sudo a2ensite sitename.conf
sudo service apache2 restart
如果一切顺利,你的网站就可以通过域名(当然前提是请解析到你的服务器)或者ip来访问了
PS:如果你有任何不懂的地方,欢迎给我留言,我会尽力解答。
其实博主也真的是个小白,希望能有更多的小白来一起交流python,交流django。