在云端Ubuntu机器上用Apache部署Django网站
只是自己的学习复习笔记。。。很多内容是基于其他资料的,写下备忘。
终于毕业了,最近在unpaid实习,作为全职入职前的一个过渡。刚好要用到之前网页应用开发课上学的知识,发现好多都记不清了,在这里复习一下吧。
目标:在AWS上的Ubuntu机器上,创建Django项目,并用Apache做成web server。
1. 安装Django
更新apt-get:
$ sudo apt-get update
顺便记录一下自己总是记不清的 apt-get update 与 upgrade 的区别:update命令会更新所有可供下载的package条目以及它们的版本,而upgrade会根据现有的条目及版本升级更新所有你已经安装的package。因此,当你想要更新自己所安装的所有package时,一般先运行update命令,再运行upgrade命令。但感觉upgrade还是根据需要具体更新某个package比较好,所以update才是我们最经常需要用到的命令。
安装python及pip:
$ sudo apt-get install python
$ sudo apt-get install python-pip
查看python版本:
$ python --version
Python 2.7.12
正确显示版本号,说明Python安装成功。也可以选择安装Python3,同样有Django. 本文用Python2举例了。
用pip安装Django:
$ sudo pip install django
安装完成后,可以查看Django版本
$ django-admin version
1.11.6
正确显示版本号,说明安装成功。
2. 创建Django project以及其下的网页App
这一步是可选的。如果已经在本地环境创建好Django project, 也可以直接把源码上传,或者用Git来做version control来同步本地与云端服务器代码。
首先创建Django project:
$ django-admin startproject mysite
在mysite中创建一个新app:
~$ cd mysite/
~/mysite$ python manage.py startapp myapp
在 mysite/settings.py中加入该app:
INSTALLED_APPS = [
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.sites','django.contrib.messages',
'django.contrib.staticfiles',
'myapp',
]
更改myapp/urls.py从而添加app的url:
fromdjango.conf.urls import url
from . import views
urlpatterns=[
url(r'^$', views.index, name='index'),
]
这里加入的一条url使得root url (r'^$') 会运行views中名为的index函数。r表示regular expression,后面的单引号中的内容表示正则表达式match的内容,^和$分别表示行开头和行结尾,具体如果不清楚请进一步学习正则表达式regex。后面的name是在html template中链接此url的名称,目的是为了更加简单的match到这个url, 也可选择不定义name而使用整个url字符串来链接此url。
同时,还需要更改mysite/urls.py使得网站的某些url能match到myapp中:
from django.conf.urls import include,url
from django.contrib import admin
urlpatterns=[
url(r'^myapp/',include('myapp.urls')),
url(r'^admin/',admin.site.urls),
]
此时以mysite/myapp/ 为开头的url会被match到myapp/urls.py中,并根据其中的url进一步进行匹配。
由于我们将mysite/myapp/这个url匹配到了index这个函数中,此时需要在views.py中定义该index函数来实现功能:
from django.http import HttpResponse
def index(request):
return HttpResponse('Hello World')
该函数会生成并返回一条内容为“Hello World”的Http response。
最后,运行该server:
~/mysite$ python manage.py runserver
这时Django会默认在:8000端口运行该网站。现在,当该网站host/myapp:8000 的url收到访问时,会收到该条Http回复。还可以添加参数来确定自己想在什么端口运行该程序,以及允许哪些IP访问:
~/mysite$ python manage.py runserver 0.0.0.0:80
这样会在80端口(HTTP)运行该网站,并接受任何IP地址的访问。
3. 安装并运行Apache, 并链接Apache与Django
利用Apache与mod_wsgi来搭建服务器是Django官方推荐的一种部署方式。
首先安装Apache:
$ sudo apt-get install apache2
Apache是目前最为广泛应用的开源HTTP网站服务器软件,世界上有超过60%的服务器是以Apache为基础搭建的。
接着安装mod_wsgi:
$ sudo apt-get install libapache2-mod-wsgi
mod_wsgi是Python的一个module,它是提供基于Python的网站在Apache运行的接口。注意这里是Python2的安装包,Python3对应的包是libapache2-mod-wsgi-py3。
接下来我们需要写一个wsgi.py脚本来作为链接Apache与Django的桥梁。为了方便版本管理,我们在mysite/mysite/目录下新建一个名为apache/的文件夹。原来的目录结构是这样的:
mysite/
manage.py
mysite/
__init__.py
settings.py
urls.py
myapp/
models.py
views.py
新建后是这样的:
mysite/
manage.py
mysite/
__init__.py
settings.py
urls.py
apache/
__init__.py
override.py
wsgi.py
myapp/
models.py
views.py
为什么说这样方便版本管理呢?只用在Git中ignore掉apache这个文件夹,它便会被Git忽略,因为此文件夹只需在Apache服务器上存在,并不是该Django项目的一部分。
接着,分别添加几个Python文件的内容。__init__.py中不需要任何内容,有它只是为了让python把当前目录识别为一个package。
override.py中需要覆盖部分Django project中settings.py中的设定,在ALLOWED_HOST中加入该server的域名。此处DEBUG选项设置为了True,在完成开发后应当改为False:
# override.py
from mysite.settings import *
DEBUG=True
ALLOWED_HOSTS=[
'mydomain.com',
]
添加wsgi.py中的设定:
import os, sys
# Calculate the path based on the location of the WSGI script.
apache_configuration = os.path.dirname(__file__)
project = os.path.dirname(apache_configuration)
workspace = os.path.dirname(project)
sys.path.append(workspace)
sys.path.append(project)
# Add the path to 3rd party django application and to django itself.
sys.path.append('/home/myuser')
os.environ['DJANGO_SETTINGS_MODULE'] = 'webapps.apache.override'
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()
注意把myuser改成自己的系统用户名就行。
设定好各个.py文件的内容后,把apache/文件夹的归属权转让给Apache的默认用户www-data,使得Apache可以访问此文件夹:
$ sudo chown www-data:www-data apache/
修改Apache的设定:
$ sudo vim /etc/apache2/sites-enabled/000-default.conf
在文件中<VirtualHost*:80> 标签中加入以下内容:
WSGIScriptAlias /mypath/ /home/myuser/mysite/apache/wsgi.py
<Directory "/home/myuser/mysite/mysite/apache/">
Require all granted
</Directory>
WSGIScriptAlias会让你的网站在根url下的/mypath/路径运行。也就是说,现在当你访问 http://mydomain.com/mypath/ 时就会访问到你的Django根url。如果想让网站的根url直接对应Django App, 可以将‘/mypath/’直接替换为'/'。
修改完后,需要重启apache服务:
$ sudo service apache2 restart
到此为止,就可以通过“http://mydomain.com/mypath/”正式访问你的Django App啦!
参考资源:
https://www.sitepoint.com/deploying-a-django-app-with-mod_wsgi-on-ubuntu-14-04/
https://askubuntu.com/questions/94102/what-is-the-difference-between-apt-get-update-and-upgrade
https://docs.djangoproject.com/en/1.11/howto/deployment/wsgi/modwsgi/
https://stackoverflow.com/questions/35674590/what-is-the-difference-between-wsgi-python-wsgi-wsgi-server-and-mod-wsgi