美文网首页Python
Django + Nginx + Gunicorn 部署

Django + Nginx + Gunicorn 部署

作者: 唯老 | 来源:发表于2019-03-10 21:22 被阅读157次

    一、前期准备工作

    1、版本

    • Ubuntu 18
    • python 3.6.5
    • Django 1.11.12
    • Nginx 1.14.0
    • Gunicorn 19.9.0
    • gevent 1.4.0

    2、安装(服务器)

    1. nginx
      sudo apt install nginx
      
    2. 安装python3(已经安装请忽略)
      # ubuntu 18 自带的就是3.6.5 其它Ubuntu版本的请使用命令安装
      sudo apt update
      sudo apt install python3.6
      
    3. 安装pip(已经安装请忽略)
      sudo apt-get install python3-pip
      
    4. 安装虚拟环境
      sudo pip install virtualenv
      

    二、Django项目

    1、修改相关配置

    1. 关闭debug,修改hosts


      image
    2. 修改数据连接, 例如下图所示


      image
    3. 将静态文件打包
      image
      使用命令 collectstatic
      image
      收集完成之后如下图所示
      image
    4. 导出项目所依赖的库到项目根目录
      pip freeze > requirements.txt
      
    5. 注意
      一定要确保你的项目在本地运行没有问题,否则在服务器终端下出了问题对于新手来说不好解决

    2、项目上传

    1. 注意
      最好将本地项目复制一份,然后将项目下的虚拟环境删除
    2. 在windows下可以使用图形化界面工具WinScp或者Xshel
      scp -r 本地项目根目录绝对路径 服务器用户名@服务器ip地址:上传服务器的目录
      
    3. linux或者mac使用命令
      scp -r 本地项目根目录绝对路径 服务器用户名@服务器ip地址:上传服务器的目录
      
      scp /home/xxx/work/PycharmProjects/DjangoDeployExample test@192.168.0.112:/home/www/django
      

    3、连接远程服务器创建虚拟环境

    1. 说明
      由于python兼容性的问题,不建议在全局环境中部署,而且一个服务器有可能部署多个项目,所以推荐在虚拟环境中部署
    2. 连接远程服务器
      ssh 用户名@IP地址 -p 端口号(默认80)
      
    3. 安装虚拟环境
      sudo pip install virtualenv
      
    4. 创建虚拟环境
      # 1.在项目的根目录(建议),也可以在其他地方均可
      cd /home/www/django
      # 创建虚拟环境,名字随意
      virtualenv venv
      
    5. 激活虚拟环境
      source .venv//bin/activate
      
      image

    4、导入虚拟环境

    1. 使用pip
      pip install -r requirement.txt
      

    三、Gunicorn

    1、安装

    1. 在项目的虚拟环境安装gunicorn
      # 如果下载速度过慢使用国内源
      pip3 install gunicorn -i https://pypi.douban.com/simple
      
    2. 在项目的虚拟环境中安装gevent
      # 基于协程的库,提高并发量
      pip3 install gevent -i https://pypi.douban.com/simple
      

    2、通过Gunicorn启动项目

    2.1、命令启动(不推荐)

    1. 命令
      # 常见的参数
      gunicorn -w 10 -k 'gevent' -b 0.0.0.0:9000 DjangoDeployExample.wsgi:application --reload -t 500 -D --access-logfile logs/gunicorn.log
      
    2. 参数说明
      参数 说明 备注
      -w 10 开启10个进程 根据服务器配置来定
      -k 'gevent' 使用gevent异步模式,提高了响应速度。 必须先安装好gevent
      -b 0.0.0.0:9000 表示绑定ip地址和端口
      DjangoDeployExample.wsgi:application settings.py文件同级目录的wsgi.py中 这里使用的是相对路径
      -–reload 监听到项目文件变动自动重启gunicorn 生效
      -D 让命令后台执行 如果想看命令错误可不要
      -t 500 配置每个请求的超时时间为500秒
      –access-logfile logs/gunicorn.log 将请求日志保存到该文件中 logs目录必须创建
    3. 示例图


      image
      image
    4. 备注
      详细参数,请看其他附录

    2.2、通过配置文件启动(常用)

    1. 创建gunicorn.conf文件
      # 并行工作进程数
      workers = 4
      # 指定每个进程的线程数
      threads = 2
      # 监听内网端口8000
      bind = '192.168.58.44:8000'
      # 设置守护进程(linux有效)
      daemon = 'true'
      # 工作模式协程
      worker_class = 'gevent'
      # 设置最大并发量
      worker_connections = 2000
      # 设置进程文件目录
      pidfile = '/home/xxx/work/DjangoDeployExample/product/gunicorn//gunicorn.pid'
      # 设置访问日志和错误信息日志路径
      accesslog = '/home/xxx/work/DjangoDeployExample/product/gunicorn/logs/gunicorn_acess.log'
      errorlog = '/home/xxx/work/DjangoDeployExample/product/gunicorn/logs/gunicorn_error.log'
      # 设置日志记录水平
      loglevel = 'error'
      
    2. 启动
      gunicorn -c gunicorn.conf DjangoDeployExample.wsgi:application
      
    3. 注意
      • 注意用户权限问题,比如pid文件 访问日志 errorlog 如果权限不够可以给目录授权一下

    四、nginx

    1、说明

    本教程是通过命令安装,一般默认安装在/etc/nginx/,下载安装包的安装的可以根据自己的目录来配置,具体的一些细节这里不介绍,具体请自行查询

    注意:在系统的命令窗口中使用,上面都是在虚拟环境下使用

    2、命令介绍

    1. 查看nginx是否启动
      ps aux|grep nginx
      
      image
    2. 检查nginx配置文件是否有错:
      # -t 测试     nginx的配置文件
      sudo nginx -t xxx/xxx/nginx.conf
      
    3. 通过配置文件启动
      sudo nginx -c xxx/xxx/nginx.conf
      
    4. 关闭nginx
      nginx -s stop
      # 其它方式
      sudo pkill -9 nginx 
      

    3、反向代理

    1. nginx.conf配置文件
      不建议直接修改nginx的配置文件,最好复制一份通过指定配置文件启动
      # 用户  用户名    用户组
      user  zhangwei  zhangwei;
      #设置值和CPU核心数一致
      worker_processes auto;
      # 全局错误日志 (注意权限)
      error_log  /home/xxx/work/PycharmProjects/DjangoDeployExample/product/nginx/logs/error.log;
      # pid文件所在目录 (注意权限)
      pid  /home/xxx/work/PycharmProjects/DjangoDeployExample/product/nginx//nginx.pid;
      # events块配置
      events {
        # 事件驱动模型,select|poll|kqueue|epoll|resig|/dev/poll|eventport
        use epoll;
        # 单个work进程允许的最大连接数,默认为512
        worker_connections 65535;
      }
      # http块配置
      http {
          # 文件扩展名与文件类型映射表。设定mime类型(邮件支持类型),类型由mime.types文件定义
          # 
          include /etc/nginx/mime.types;
          #默认文件类型,默认为text/plain
          default_type application/octet-stream;
          # http模块的的访问日志
          access_log  /home/zhangwei/work/PycharmProjects/DjangoDeployExample/product/nginx/logs/access.log;
          # #允许sendfile方式传输文件,默认为off,可以在http块,server块,location块。
          #(sendfile系统调用不需要将数据拷贝或者映射到应用程序地址空间中去)
          sendfile  on;
          # 连接超时时间,默认为75s,可以在http,server,location块
          keepalive_timeout  65;
          server {
              listen       80;
              #  有域名的话绑定域名,没域名写ip地址
              server_name  www.hello.com;
              # 全局错误的界面
              error_page  404  /404.html;
              # 反向代理的路径(和upstream绑定),location后面设置映射的路径
              location / { 
                 # 注意代理的ip地址一定要和gunicorn里的端口一致
                 proxy_pass http://192.168.58.44:8000;
                 proxy_pass_header       Authorization;
                 proxy_pass_header       WWW-Authenticate;
                 proxy_set_header Host $host;
                 proxy_set_header X-Real-IP $remote_addr;
                 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
              }
              # 处理静态文件
              location /static {
                  alias  /home/xxx/work/PycharmProjects/DjangoDeployExample/static;
                  # 过期30天,静态文件不怎么更新,过期可以设大一点,
                   # 如果频繁更新,则可以设置得小一点。
                  expires 30d;
              }
           # 多媒体资源等文件 路径
              location /media {
                  alias /home/xxx/work/PycharmProjects/DjangoDeployExample/media/;
                  # 过期30天,静态文件不怎么更新,过期可以设大一点,
                  # 如果频繁更新,则可以设置得小一点。
                  expires 30d;
              }
          }
      }
      
    2. 本案例直接将nginx放在工程下
      sudo nginx -c xxx/xxx/nginx.conf
      
    3. 注意
      • 一定要注意文件的权限问题日志 pid文件的权限问题
      • 代理的ip地址一定要和gunicorn里的端口一致
      • mime.types注意引入的路径,因为不是修改默认的nginx配置文件

    五、附录

    1、gunicorn详细参数

    命令 简写 参数类型 说明
    --config -c 字符串 配置文件路径,路径形式的字符串格式
    --bind -b ip地址 绑定服务器套接字
    --workers -w 整型 用于处理工作进程的数量,为正整数,默认为1。worker推荐的数量为当前的CPU个数*2 + 1
    --backlog 整型 等待服务的客户的数量, 必须是正整数,一般设定在64~2048的范围内
    --worker-class -k 字符串 要使用的工作模式,默认为sync 可选值 gevent tornado
    --threads 整型 处理请求的工作线程数,使用指定数量的线程运行每个worker。为正整数,默认为1
    --worker-connections 整型 最大客户端并发数量,默认情况下这个值为1000
    max_requests 整型 超过这么多秒后工作将被杀掉,并重新启动。一般设定为30秒
    --timeout -t 整型
    --keep-alive 整型 `连接上等待请求的秒数,默认情况下值为2。一般设定在1~5秒之间
    --limit-request-line 整型 HTTP请求行的最大大小,此参数用于限制HTTP请求行的允许大小,默认情况下,这个值为4094。值是0~8190的数字。此参数可以防止任何DDOS攻击
    --limit-request-fields 整型 限制HTTP请求中请求头字段的数量。此字段用于限制请求头字段的数量以防止DDOS攻击,与limit-request-field-size一起使用可以提高安全性。默认情况下,这个值为100,这个值不能超过32768
    --limit-request-field-size 整型 限制HTTP请求中请求头的大小,默认情况下这个值为8190。值是一个整数或者0,当该值为0时,表示将对请求头大小不做限制
    --reload 代码更新时将重启工作,默认为False。此设置用于开发,每当应用程序发生更改时,都会导致工作重新启动。
    --check-config 布尔 显示配置文件信息
    --chdir 路径 切换到指定的工作目录
    --daemon -D, 布尔 守护Gunicorn进程,默认False
    -pid -p 文件 设置pid文件的文件名,如果不设置将不会创建pid文件
    --worker-tmp-dir DIR 路径 设置工作临时文件目录,如果不设置会采用默认值
    --access-logfile 文件 要写入的访问日志目录
    --error-logfile 文件 要写入错误日志的文件目录
    --log-file 文件 要写入日志的文件目录

    相关文章

      网友评论

        本文标题:Django + Nginx + Gunicorn 部署

        本文链接:https://www.haomeiwen.com/subject/qknppqtx.html