Django 部署(Nginx)

本文主要讲解 nginx + uwsgi socket 的方式来部署 Django,比 Apache mod_wsgi 要复杂一些,但这是目前主流的方法。

推荐:使用Code Studio 在线代码编辑,新人更有免费一个月云主机,可以用来实战体验本节的部署!

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

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,736评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,167评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,442评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,902评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,302评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,573评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,847评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,562评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,260评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,531评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,021评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,367评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,016评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,068评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,827评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,610评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,514评论 2 269

推荐阅读更多精彩内容