Django14-部署
来源:互联网 发布:xls软件官方下载 编辑:程序博客网 时间:2024/06/03 19:27
Django 部署(Apache)
本文讲述部署的方法和常见的问题,并给出了在 BAE, SAE 等上面部署的实例。
如果不是在自己的服务器上部署,当开发完成后可以部署到 BAE, SAE, 也可以使用阿里云的服务器。
部署到BAE的例子:https://github.com/twz915/BAE_Django(实测,推荐)
部署到SAE的例子:https://github.com/twz915/django-sae(Fork smallcode同学的,没有测试过,SAE 有一定的免费份额)
Django + nginx + Gunicorn/uwsgi 部署方式,参见另一篇:Django 部署(nginx)
自己的服务器(比如用的阿里云服务器)请看下文:
如果是新手,个人推荐用ubuntu,除非你对linux非常熟悉,ubuntu服务器的优点:
一,开机apache2等都自动启动,不需要额外设置
二,安装软件非常方便 apt-get 搞定
三,安装ssh,git等也非常容易,几乎是傻瓜化
如果你在虚拟机或个人电脑中安装,也可以试试 Linux Mint, 它用起来更简单,和ubuntu兼容。
下面是ubuntu上的部署详细步骤:
1. 安装 apache2 和 mod_wsgi
sudo
apt-get
install
apache2
# Python 2
sudo
apt-get
install
libapache2-mod-wsgi
# Python 3
sudo
apt-get
install
libapache2-mod-wsgi-py3
2. 确认安装的apache2版本号
apachectl -
v
Server version: Apache/2.4.6 (ubuntu)
Server built: Dec 5 2013 18:32:22
3. 准备一个新网站
ubuntu的apache2配置文件在 /etc/apache2/ 下
备注:centos 用户 apache 名称为 httpd 在 /etc/httpd/ 中(可以参考文章下面置顶的评论)
新建一个网站配置文件
sudo
vi
/etc/apache2/sites-available/sitename
.conf
示例内容如下:
<VirtualHost *:80>
ServerName www.yourdomain.com
ServerAlias otherdomain.com
ServerAdmin tuweizhong@163.com
Alias
/media/
/home/tu/blog/media/
Alias
/static/
/home/tu/blog/static/
<Directory
/home/tu/blog/media
>
Require all granted
<
/Directory
>
<Directory
/home/tu/blog/static
>
Require all granted
<
/Directory
>
WSGIScriptAlias /
/home/tu/blog/blog/wsgi
.py
# WSGIDaemonProcess ziqiangxuetang.com python-path=/home/tu/blog:/home/tu/.virtualenvs/blog/lib/python2.7/site-packages
# WSGIProcessGroup ziqiangxuetang.com
<Directory
/home/tu/blog/blog
>
<Files wsgi.py>
Require all granted
<
/Files
>
<
/Directory
>
<
/VirtualHost
>
如果你的apache版本号是 2.2.x(第二步有方法判断)
用下面的代替 Require all granted
Order deny,allow
Allow from all
备注:把上面配置文件中这两句的备注去掉,可以使用 virtualenv 来部署网站,当然也可以只写一个 /home/tu/blog
# WSGIDaemonProcess ziqiangxuetang.com python-path=/home/tu/blog:/home/tu/.virtualenvs/blog/lib/python2.7/site-packages
# WSGIProcessGroup ziqiangxuetang.com
4. 修改wsgi.py文件
注意:上面如果写了 WSGIDaemonProcess 的话,这一步可以跳过,即可以不修改 wsgi.py 文件。
上面的配置中写的 WSGIScriptAlias / /home/tu/blog/blog/wsgi.py
就是把apache2和你的网站project联系起来了
import
os
from
os.path
import
join,dirname,abspath
PROJECT_DIR
=
dirname(dirname(abspath(__file__)))
#3
import
sys
# 4
sys.path.insert(
0
,PROJECT_DIR)
# 5
os.environ[
"DJANGO_SETTINGS_MODULE"
]
=
"blog.settings"
# 7
from
django.core.wsgi
import
get_wsgi_application
application
=
get_wsgi_application()
第 3,4,5 行为新加的内容,作用是让脚本找到django项目的位置,也可以在sitename.conf中做,用WSGIPythonPath,想了解的自行搜索, 第 7 行如果一台服务器有多个django project时一定要修改成上面那样,否则访问的时候会发生网站互相串的情况,即访问A网站到了B网站,一会儿正常,一会儿又不正常(当然也可以使用 mod_wsgi daemon 模式,点击这里查看)
5. 设置目录和文件权限
一般目录权限设置为 755,文件权限设置为 644
假如项目位置在 /home/tu/zqxt (在zqxt 下面有一个 manage.py,zqxt 是项目名称)
cd
/home/tu/
sudo
chmod
-R 644 zqxt
sudo
find
zqxt -
type
d -
exec
chmod
755 \{\} \;
apache 服务器运行用户可以在 /etc/apache2/envvars 文件里面改,这里使用的是默认值,当然也可以更改成自己的当前用户,这样的话权限问题就简单很多,但在服务器上推荐有 www-data 用户,更安全。以下是默认设置:
# Since there is no sane way to get the parsed apache2 config in scripts, some
# settings are defined via environment variables and then used in apache2ctl,
# /etc/init.d/apache2, /etc/logrotate.d/apache2, etc.
export APACHE_RUN_USER=www-data
export APACHE_RUN_GROUP=www-data
上传文件夹权限
media 文件夹一般用来存放用户上传文件,static 一般用来放自己网站的js,css,图片等,在settings.py中的相关设置
STATIC_URL 为静态文件的网址 STATIC_ROOT 为静态文件的根目录,
MEDIA_URL 为用户上传文件夹的根目录,MEDIA_URL为对应的访问网址
在settings.py中设置:
# Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/dev/howto/static-files/
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR,'static')
# upload folder
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR,'media')
在 Linux 服务器上,用户上传目录还要设置给 www-data 用户的写权限,下面的方法比较好,不影响原来的用户的编辑。
假如上传目录为 zqxt/media/uploads 文件夹,进入media文件夹,将 uploads 用户组改为www-data,并且赋予该组写权限:
cd
media/
# 进入media文件夹
sudo
chgrp
-R www-data uploads
sudo
chmod
-R g+w uploads
备注:这两条命令,比直接用sudo chown -R www-data:www-data uploads 好,因为下面的命令不影响文件原来所属用户编辑文件,fedora系统应该不用设置上面的权限,但是个人强烈推荐用ubuntu,除非你对linux非常熟悉,你自己选择。
如果你使用的是sqlite3数据库,还会提示 Attempt to write a readonly database,同样要给www-data写数据库的权限
进入项目目录的上一级,比如project目录为 /home/tu/blog 那就进入 /home/tu 执行下面的命令(和修改上传文件夹类似)
sudo
chgrp
www-data blog
sudo
chmod
g+w blog
sudo
chgrp
www-data blog
/db
.sqlite3
# 更改为你的数据库名称
sudo
chmod
g+w blog
/db
.sqlite3
备注:上面的不要加 -R ,-R是更改包括所有的子文件夹和文件,这样不安全。个人建议可以专门弄一个文件夹,用它来放sqlite3数据库,给该文件夹www-data写权限,而不是整个项目给写权限,有些文件只要读的权限就够了,给写权限会造成不安全。
6. 激活新网站
sudo
a2ensite sitename 或
sudo
a2ensite sitename.conf
如果顺利,这样网站就搭建成功,访问你的网址试试看,如果出现问题就接着看下面的。
7. 错误排查
一,没有静态文件,网站打开很乱,没有布局,多半是静态文件没有生效。
确保你的配置文件中的路径是正确的
确保你的settings.py中的文件设置正确
收集静态文件(详细静态文件部署教程)
python manage.py collectstatic
二,网站打开后报错
这时你可以把settings.py更改
DEBUG = True
重启服务器
sudo
service apache2 restart
再访问网站 来查看具体的出错信息。
如果这样做还看不到出错信息,只是显示一个服务器错误,你可以查看apache2的错误日志
cat
/var/log/apache2/error
.log
根据错误日志里面的内容进行修正!
总结:
部署时文件对应关系:
sitename.conf --> wsgi.py --> settings.py --> urls.py --> views.py
扩展
明白了上面的关系, 一个 Django project 使用多个域名或让app使用子域名很简单,只要新建一个 wsgi.py 文件,更改里面对应的settings文件,新的settings文件可以对应新的urls.py,从而做到访问与原来不同的地址!
Django 部署(Nginx)
本文主要讲解 nginx + uwsgi socket 的方式来部署 Django,比 Apache mod_wsgi 要复杂一些,但这是目前主流的方法。
1. 运行开发服务器测试
cd
zqxt
# 进入项目 zqxt 目录
python manage.py runserver
运行开发服务器测试,确保开发服务器下能正常打开网站。
2. 安装 nginx 和 需要的包
2.1 安装 nginx 等软件
ubuntu / Linux Mint 等,下面简写为 (ubuntu):
sudo
apt-get
install
python-dev nginx
centos / Fedora/ redhat 等,下面简写为 (centos)
sudo
yum
install
epel-release
sudo
yum
install
python-devel nginx
2.2 安装 supervisor, 一个专门用来管理进程的工具,我们用它来管理 uwsgi 进程
sudo
pip
install
supervisor
Ubuntu用户 请直接看 3,以下是CentOS 注意事项:
CentOS下,如果不是非常懂 SELinux 和 iptables 的话,为了方便调试,可以先临时关闭它们,如果发现部署了之后出不来结果,可以临时关闭测试一下,这样就知道是不是 SELinux 和 iptables 的问题
CentOS 7 iptables如何使用:http://stackoverflow.com/questions/24756240/
将 SELinux 设置为宽容模式,方便调试:
sudo
setenforce 0
防火墙相关的设置:
可以选择临时关闭防火墙
sudo
service iptables stop
或者开放一些需要的端口,比如 80
sudo
iptables -A INPUT -p tcp -m tcp --dport 80 -j ACCEPT
上面的两条命令,如果是 CentOS 7 用
临时关闭防火墙
sudo
systemctl stop firewalld
或者 开放需要的端口
sudo
firewall-cmd --zone=public --add-port=80
/tcp
--permanent
sudo
firewall-cmd --reload
备注:由于我还没有用 最新版本的 Fedora ,新版 Fedora 需要用 dnf 来安装包,有需求的同学自测,可以参考这里。
3. 使用 uwsgi 来部署
安装 uwsgi
sudo
pip
install
uwsgi --upgrade
使用 uwsgi 运行项目
uwsgi --http :8001 --chdir
/path/to/project
--home=
/path/to/env
--module project.wsgi
这样就可以跑了,--home 指定virtualenv 路径,如果没有可以去掉。project.wsgi 指的是 project/wsgi.py 文件
如果提示端口已经被占用:
probably another instance of uWSGI is running on the same address (:8002).
bind(): Address already in use [core/socket.c line 764]
这时可以把相关的进程 kill 掉:
按照端口进行查询:
lsof
-i :8002
可以查出:
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
uwsgi 2208 tu 4u IPv4 0x53492abadb5c9659 0t0 TCP *:teradataordbms (LISTEN)
uwsgi 2209 tu 4u IPv4 0x53492abadb5c9659 0t0 TCP *:teradataordbms (LISTEN)
这时根据 PID 可以用下面的命令 kill 掉相关程序:
sudo
kill
-9 2208 2209
按照程序名称查询:
ps
aux |
grep
uwsgi
补充内容:
使用 gunicorn 代替 uwsgi 的方法
sudo
pip
install
gunicorn
在项目目录下运行下面的命令进行测试:
gunicorn -w4 -b0.0.0.0:8001 zqxt.wsgi
-w 表示开启多少个worker,-b 表示要使用的ip和port,我们这里用的是 8001,0.0.0.0代表监控电脑的所有 ip。
如果使用了 virtualenv 可以这样
/path/to/env/bin/gunicorn
--chdir
/path/to/project
--pythonpath
/path/to/env/
-w4 -b0.0.0.0:8017 project.wsgi:application
用 --pythonpath 指定依赖包路径,多个的时候用逗号,隔开,如:'/path/to/lib,/home/tu/lib'
4. 使用supervisor来管理进程
安装 supervisor 软件包
(sudo) pip install supervisor
生成 supervisor 默认配置文件,比如我们放在 /etc/supervisord.conf 路径中:
(
sudo
) echo_supervisord_conf >
/etc/supervisord
.conf
打开 supervisor.conf 在最底部添加(每一行前面不要有空格,防止报错):
[program:zqxt]
command=/path/to/uwsgi --http :8003 --chdir /path/to/zqxt --module zqxt.wsgi
directory=/path/to/zqxt
startsecs=0
stopwaitsecs=0
autostart=true
autorestart=true
command 中写上对应的命令,这样,就可以用 supervisor 来管理了。
启动 supervisor
(
sudo
) supervisord -c
/etc/supervisord
.conf
重启 zqxt 程序(项目):
(
sudo
) supervisorctl -c
/etc/supervisord
.conf restart zqxt
启动,停止,或重启 supervisor 管理的某个程序 或 所有程序:
(
sudo
) supervisorctl -c
/etc/supervisord
.conf [start|stop|restart] [program-name|all]
以 uwsgi 为例,上面这样使用一行命令太长了,我们使用 ini 配置文件来搞定,比如项目在 /home/tu/zqxt 这个位置,
在其中新建一个 uwsgi.ini 全路径为 /home/tu/zqxt/uwsgi.ini
[uwsgi]
socket =
/home/tu/zqxt/zqxt
.sock
chdir =
/home/tu/zqxt
wsgi-
file
= zqxt
/wsgi
.py
touch
-reload =
/home/tu/zqxt/reload
processes = 2
threads = 4
chmod
-socket = 664
chown
-socket = tu:www-data
vacuum =
true
注意上面的 /home/tu/zqxt/zqxt.sock ,一会儿我们把它和 nginx 关联起来。
在项目上新建一个空白的 reload 文件,只要 touch 一下这个文件(touch reload) 项目就会重启。
注意:不建议把 sock 文件放在 /tmp 下,比如 /tmp/xxx.sock (不建议)!有些系统的临时文件是 namespaced 的,进程只能看到自己的临时文件,导致 nginx 找不到 uwsgi 的 socket 文件,访问时显示502,nginx 的 access log 中显示 unix: /tmp/xxx.sock failed (2: No such file or directory),所以部署的时候建议用其它目录来放 socket 文件,比如放在运行nginx用户目录中,也可以专门弄一个目录来存放 sock 文件,比如 /tmp2/
sudo
mkdir
-p
/tmp2/
&&
sudo
chmod
777
/tmp2/
然后可以用
/tmp2/zqxt
.sock 这样的路径了
详细参考 http://stackoverflow.com/questions/32974204/got-no-such-file-or-directory-error-while-configuring-nginx-and-uwsgi
修改 supervisor 配置文件中的 command 一行:
[program:zqxt]
command=/path/to/uwsgi --ini /home/tu/zqxt/uwsgi.ini
directory=/path/to/zqxt
startsecs=0
然后重启一下 supervisor:
(
sudo
) supervisorctl -c
/etc/supervisord
.conf restart zqxt
或者
(
sudo
) supervisorctl -c
/etc/supervisord
.conf restart all
5. 配置 Nginx
新建一个网站 zqxt
sudo
vim
/etc/nginx/sites-available/zqxt
.conf
写入以下内容:
server {
listen 80;
server_name www.ziqiangxuetang.com;
charset utf-8;
client_max_body_size 75M;
location /media {
alias /path/to/project/media;
}
location /static {
alias /path/to/project/static;
}
location / {
uwsgi_pass unix:///home/tu/zqxt/zqxt.sock;
include /etc/nginx/uwsgi_params;
}
}
激活网站:
sudo
ln
-s
/etc/nginx/sites-available/zqxt
.conf
/etc/nginx/sites-enabled/zqxt
.conf
测试配置语法问题
sudo
service nginx configtest 或
/path/to/nginx
-t
重启 nginx 服务器:
sudo
service nginx reload 或
sudo
service nginx restart 或
/path/to/nginx
-s reload
一些有用的参考教程:
Django 官网部署教程:
https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/gunicorn/
https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/uwsgi/
nginx 与 socket
http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html#configure-nginx-for-your-site
防火墙:
iptables: https://www.digitalocean.com/community/tutorials/how-to-setup-a-basic-ip-tables-configuration-on-centos-6
centos 7 FireWalld: http://stackoverflow.com/questions/24756240/how-can-i-use-iptables-on-centos-7
ubuntu ufw 防火墙:http://wiki.ubuntu.org.cn/Ufw%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97
uwsgi ini 配置文件:http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html#configuring-uwsgi-to-run-with-a-ini-file
- Django14-部署
- 部署
- 部署
- 部署
- 部署
- 部署
- 部署
- 部署Hadoop_单机部署
- 部署Hadoop_单机部署
- walle部署系统部署
- 部署 Jaggle
- 部署规划
- 部署项目
- 部署was
- MIDlet 部署
- Servlet部署
- roller部署
- 部署Log4j
- linux服务之iSCSI
- 定时任务高效触发
- Combine Two Tables题解
- jsp中<select>标签
- 关于 ACM-ICPC 自动评测系统 8种结果的解释
- Django14-部署
- 页面置换算法
- Linux信号列表
- GO语言的reflection
- HTML+CSS知识点(一)
- 指针笔记简要
- centos7.2下安装mysql5.7.16使用rpm包安装
- 【Python】多维narray数组的子数组仍然是narray格式,赋值也无法改变这一点
- 57- 打印钻石图形