Python3 + Django + uwsgi + nginx 配置部署

简介

本来以为最后将代码部署到服务器上是一件很容易的事,没想到在这里又踩了无数的坑。虽然网上与此相关的博客有很多很多,但是每一个的方法都略有不同,很多方法用过之后发现并不能成功部署(绝望...)。于是我写一篇博客记录一下我在配置过程中的详细步骤,也方便日后有需时看这篇博客回忆一下。

安装与配置

基本环境

  • 服务器:腾讯云 CVM 标准型S3,操作系统为 Ubuntu Server 16.04.1 LTS 64位
  • python:3.5.2
  • mysql:5.7.23
  • pip3:18.1

安装配置

1、django及其相关库的安装

在这里我们使用的django版本号为1.9.5,直接运行以下命令即可成功安装:

pip3 install --user django~=1.9.5

:命令中若不加--user,则可能出现用户权限的问题而无法成功安装。
此外,我们还需要mysqlclientpymysql实现django与mysql数据库的交互:

pip3 install --user mysqlclient~=1.3.7
pip3 install --user pymysql~=0.9.2

2、uWSGI的安装

直接运行以下命令即可成功安装:

pip3 install --user uwsgi

:一般这样安装的uWSGI是没有问题的,如果大家不放心的话,可以参考网上测试uWSGI的方法,此处省略。

3、nginx的安装

直接运行以下命令即可成功安装:

sudo apt-get install nginx

:我一开始是用make源码的方式安装了nginx,但是发现安装之后使用起来很不方便,很多路径都找不到;而网上关于nginx的配置基本都是用上述命令安装的,所以为了省事,我也就改成使用上述命令直接安装。

使用

在使用nginxuWSGI进行配置时,最容易出错的是路径问题(捂脸)所以我在这里先给出我的项目架构,再说明具体配置方式。

项目架构(目录)

(.env) ubnutu@VM-0-10-ubuntu:~/WeChatTicket$(即在/home/ubuntu/WeChatTicket/目录下)
.
├── manage.py
├── configs.json
├── static/
├── WeChatTicket/
|  └── wsgi.py              # wsgi模块
└──  deployment/
    ├── mysite_nginx.conf    # nginx配置文件
    ├── mime.types           # nginx相关配置文件
    ├── uwsgi_params         # nginx中与uWSGI相关的参数引用文件
    ├── nginx_error.log      # nginx错误日志文件
    ├── nginx_access.log     # nginx连接日志文件
    ├── mysite_uwsgi.ini     # uWSGI配置文件
    ├── uwsgi.log            # uWSGI日志文件
    └── uwsgi.pid            # uWSGI控制文件

文件配置

1、在mysite_nginx.conf中写入如下内容:

# mysite_nginx.conf
# 设置用户权限
user root;

events {
  worker_connections 1024;
}
http {
  #加入mime.types配置文件
  include mime.types;

  # nginx需要连接到的地址(即uWSGI在本地开启的地址,在这里选用9090端口)
  upstream django {
      server 127.0.0.1:9090;
  }
  # 配置服务器
  server {
      # 你监听的端口号
      listen  80;

      # 服务器
      server_name  236584.iterator-traits.com;
      charset  utf-8;

      # 输出日志
      access_log /home/ubuntu/WeChatTicket/deployment/nginx_access.log;
      error_log /home/ubuntu/WeChatTicket/deployment/nginx_error.log;

      # 最大上传尺寸
      client_max_body_size 75M; 

      #与uWSGI连接的地址及静态文件配置
      location / {
        alias /home/ubuntu/WeChatTicket/static/;
        try_files $uri $uri/ @django;
      }

      location @django {
        uwsgi_pass  django;
        include  uwsgi_params;
     }
  }
}

2、从nginx的配置文件夹conf中直接将uwsgi_params文件拷贝到deployment目录;或者直接在deployment目录下创建uwsgi_params文件并写入如下内容:

uwsgi_param  QUERY_STRING       $query_string;
uwsgi_param  REQUEST_METHOD     $request_method;
uwsgi_param  CONTENT_TYPE       $content_type;
uwsgi_param  CONTENT_LENGTH     $content_length;

uwsgi_param  REQUEST_URI        $request_uri;
uwsgi_param  PATH_INFO          $document_uri;
uwsgi_param  DOCUMENT_ROOT      $document_root;
uwsgi_param  SERVER_PROTOCOL    $server_protocol;
uwsgi_param  REQUEST_SCHEME     $scheme;
uwsgi_param  HTTPS              $https if_not_empty;

uwsgi_param  REMOTE_ADDR        $remote_addr;
uwsgi_param  REMOTE_PORT        $remote_port;
uwsgi_param  SERVER_PORT        $server_port;
uwsgi_param  SERVER_NAME        $server_name;   

3、从nginx的配置文件夹conf中直接将mime.types文件拷贝到deployment目录;或者直接在deployment目录下创建mime.types文件并写入如下内容:

types {
    text/html                                        html htm shtml;
    text/css                                         css;
    text/xml                                         xml;
    image/gif                                        gif;
    image/jpeg                                       jpeg jpg;
    application/javascript                           js;
    application/atom+xml                             atom;
    application/rss+xml                              rss;

    text/mathml                                      mml;
    text/plain                                       txt;
    text/vnd.sun.j2me.app-descriptor                 jad;
    text/vnd.wap.wml                                 wml;
    text/x-component                                 htc;

    image/png                                        png;
    image/svg+xml                                    svg svgz;
    image/tiff                                       tif tiff;
    image/vnd.wap.wbmp                               wbmp;
    image/webp                                       webp;
    image/x-icon                                     ico;
    image/x-jng                                      jng;
    image/x-ms-bmp                                   bmp;

    application/font-woff                            woff;
    application/java-archive                         jar war ear;
    application/json                                 json;
    application/mac-binhex40                         hqx;
    application/msword                               doc;
    application/pdf                                  pdf;
    application/postscript                           ps eps ai;
    application/rtf                                  rtf;
    application/vnd.apple.mpegurl                    m3u8;
    application/vnd.google-earth.kml+xml             kml;
    application/vnd.google-earth.kmz                 kmz;
    application/vnd.ms-excel                         xls;
    application/vnd.ms-fontobject                    eot;
    application/vnd.ms-powerpoint                    ppt;
    application/vnd.oasis.opendocument.graphics      odg;
    application/vnd.oasis.opendocument.presentation  odp;
    application/vnd.oasis.opendocument.spreadsheet   ods;
    application/vnd.oasis.opendocument.text          odt;
    application/vnd.openxmlformats-officedocument.presentationml.presentation
                                                     pptx;
    application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
                                                     xlsx;
    application/vnd.openxmlformats-officedocument.wordprocessingml.document
                                                     docx;
    application/vnd.wap.wmlc                         wmlc;
    application/x-7z-compressed                      7z;
    application/x-cocoa                              cco;
    application/x-java-archive-diff                  jardiff;
    application/x-java-jnlp-file                     jnlp;
    application/x-makeself                           run;
    application/x-perl                               pl pm;
    application/x-pilot                              prc pdb;
    application/x-rar-compressed                     rar;
    application/x-redhat-package-manager             rpm;
    application/x-sea                                sea;
    application/x-shockwave-flash                    swf;
    application/x-stuffit                            sit;
    application/x-tcl                                tcl tk;
    application/x-x509-ca-cert                       der pem crt;
    application/x-xpinstall                          xpi;
    application/xhtml+xml                            xhtml;
    application/xspf+xml                             xspf;
    application/zip                                  zip;

    application/octet-stream                         bin exe dll;
    application/octet-stream                         deb;
    application/octet-stream                         dmg;
    application/octet-stream                         iso img;
    application/octet-stream                         msi msp msm;

    audio/midi                                       mid midi kar;
    audio/mpeg                                       mp3;
    audio/ogg                                        ogg;
    audio/x-m4a                                      m4a;
    audio/x-realaudio                                ra;

    video/3gpp                                       3gpp 3gp;
    video/mp2t                                       ts;
    video/mp4                                        mp4;
    video/mpeg                                       mpeg mpg;
    video/quicktime                                  mov;
    video/webm                                       webm;
    video/x-flv                                      flv;
    video/x-m4v                                      m4v;
    video/x-mng                                      mng;
    video/x-ms-asf                                   asx asf;
    video/x-ms-wmv                                   wmv;
    video/x-msvideo                                  avi;
}

4、在mysite_uwsgi.ini中写入如下内容:

[uwsgi]
# django相关设置
socket          = 127.0.0.1:9090

# 项目所在目录
chdir           = /home/ubuntu/WeChatTicket

# wsgi模块所在地址
module          = WeChatTicket.wsgi

# 进程相关设置

master          = true

# 最大工作进程与线程
processes       = 4
threads         = 2

# 离开时清除环境
vacuum          = true

# pid文件
pidfile        = uwsgi.pid

# 日志文件
daemonize      = uwsgi.log

运行(此时终端位于deployment目录下)

1、启动uWSGI

uwsgi --ini mysite_uwsgi.ini

此时会发现,目录下增加了uwsgi.piduwsgi.log两个文件。
2、启动nginx

sudo nginx -c /home/ubuntu/WeChatTicket/deployment/mysite_nginx.conf

此时会发现,目录下增加了nginx_error.lognginx_access.log两个文件。
使用sudo是为了解决用户权限的限制。
3、使用浏览器,输入ip地址,检测服务是否正确部署。

附:常用命令

  • ps aux|grep nginx(或uwsgi):查看进程状态。
  • sudo nginx -c nginx.conf:以nginx.conf的配置开启nginx的服务。
  • sudo pkill -9 nginx:强制结束nginx服务。
  • uwsgi --ini uwsgi.ini:初始化uWSGI服务并开启。
  • uwsgi --stop uwsgi.pid:终止uWSGI服务,同时会删除uwsgi.pid
  • uwsgi --reload uwsgi.pid:重新加载uWSGI服务。

总结

Python3 + Django + uwsgi + nginx 配置部署的学习就到此结束了,如果大家有什么疑问,可以随时提出。文档中有什么错误或者不足之处,也欢迎大家批评指正。

参考资料:
1、uwsgi服务启动(start)停止(stop)重新装载(reload)
2、uWSGI+django+nginx的工作原理流程与部署历程
3、基于nginx和uWSGI在Ubuntu上部署Django

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

推荐阅读更多精彩内容