阿里云高性能服務器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。