项目部署

项目部署

• 项目部署是指在软件开发完毕后，将开发软件安装到服务器上进行长期运行
• 部署分以下几个步骤进行
  1. 在服务器上安装和配置同版本的数据库
  2. django项目迁移(在安装机器上配置与开发环境相同的python版本及依赖的包)
  3. 用 uwsgi 替代python3 manage.py runserver 方法启动服务器
  4. 配置 nginx 反向代理服务器
  5. 用nginx 配置静态文件路径,解决静态路径问题

django 项目迁移

1. 安装python
   • $ sudo apt install python3
2. 安装相同版本的包
   • 导出当前模块数据包的信息：$ pip3 freeze > package_list.txt
   • 导入到另一台新主机： $ pip3 install -r package_list.txt
3. 将当前项目源代码复制到远程主机上(scp 命令)
   • $ sudo scp 当前项目源代码 远程主机地址和文件夹

uWSGI 网关接口配置

• WSGI Django工作环境部署
  • Web服务器网关接口(Web Server Gateway Interface, WSGI)，Python应用程序或框架和Web服务器之间的一种接口，被广泛使用。
  • 实现了WSGI协议、http等协议。
  • Nginx中HttpUwsgiModule的作用是与uWSGI服务器进行交换。
• uWSGI
  • python manage.py runserver 轻量级，性能较低，通常只在开发和测试环境中使用。
  • 当开发结束后，完善的项目代码需要在一个高效稳定的环境中运行，这时可以使用uWSGI。
  • uWSGI是WSGI的一种,它可以让Django、Flask等开发的web站点运行其中。
  • 胶水层，将请求翻译成字典给Django。

安装uWSGI

• 在线安装 uwsgi

  $ sudo pip3 install uwsgi -i https://pypi.tuna.tsinghua.edu.cn/simple/
  

• 查看uwsgi版本

  $ sudo pip3 freeze | grep -i 'uwsgi'  （-i 不区分大小写）
  

• 离线安装
  1. 在线下载安装包，下载后的文件为 uwsgi-2.0.18.tar.gz

     $ pip3 download uwsgi
     

  2. 离线安装

     $ tar -xzvf uwsgi-2.0.18.tar.gz
     $ cd uwsgi-2.0.18
     $ sudo python3 setup.py install
     

配置uWSGI

• 添加配置文件 项目文件夹/uwsgi.ini

  $ cd 项目文件夹
  $ touch uwsgi.ini
  

  [uwsgi]
  # Http通信方式的 IP地址:端口号
  http=127.0.0.1:8000
  # 项目当前工作目录
  chdir=.../my_project 这里需要换为项目文件夹的绝对路径
  # 项目中wsgi.py文件的目录，相对于当前工作目录
  wsgi-file=my_project/wsgi.py
  # 进程个数
  process=4
  # 每个进程的线程个数
  threads=2
  # 服务的pid记录文件
  pidfile=uwsgi.pid
  # 服务的目志文件位置
  daemonize=uwsgi.log
  # 开启主进程管理模式
  master=true
  

• 修改 settings.py

  • 将 DEBUG=True 改为 DEBUG=False
  • 将　ALLOWED_HOSTS = [] 改为　ALLOWED_HOSTS = [‘网站域名’] 或者 [‘服务监听的ip地址’]

• uWSGI的运行管理

  • 启动 uwsgi

    $ cd 项目文件夹
    $ sudo uwsgi --ini uwsgi.ini  # 与配置文件名对应
    

  • 停止 uwsgi

    $ cd 项目文件夹
    $ sudo uwsgi --stop uwsgi.pid  # 与配置文件名中的.pid对应
    

  • 说明:
    • 当uwsgi 启动后,当前django项目的程序已变成后台守护进程,在关闭当前终端时此进程也不会停止。
    • 若执行 stop 操作失败，则需要执行如下操作杀死进程。

    lsof -i:端口号 # 查看端口占用情况
    ps aux|grep ‘uwsgi’ -> 查看uwsgi进程
    sudo kill -9 pid
    ```
  • 测试:在浏览器端输入http://127.0.0.1:8000 进行测试。
  • 注意，此时端口号为8000。

Nginx 反向代理配置

• Nginx是轻量级的高性能Web服务器，提供了诸如HTTP代理和反向代理、负载均衡、缓存等一系列重要特性，在实践之中使用广泛。
• C语言编写，执行效率高。
• nginx 作用
  • 接收用户请求实现负载均衡，多台服务器轮流处理请求
  • 反向代理
• 原理：客户端请求nginx,再由nginx请求uwsgi, 运行django下的python代码

ubuntu 下 nginx 安装

```shell
$ sudo apt install nginx
vim /etc/apt/sources.list
sudo apt-get update  # 更改国内源
```

nginx 配置

• 超级用户权限下修改nginx的配置文件

  $ sudo su 切换超级用户
  $ cd /etc/nginx
  $ vim sites-enabled/default  修改配置文件
  

• 在server节点下添加新的location项，指向uwsgi的ip与端口。

  server {
      ...
      location / {
          uwsgi_pass 127.0.0.1:8000;  # 重定向到127.0.0.1的8000端口
          include /etc/nginx/uwsgi_params; # 将所有的参数转到uwsgi下
      }
      ...
  }
  

• nginx服务控制

  $ sudo /etc/init.d/nginx start|stop|restart|status
  # 或
  $ sudo service nginx start|stop|restart|status
  # 检查nginx配置文件语法错误
  $ sudo nginx -t
  

  通过start,stop,restart,status可能实现nginx服务的启动、停止、重启、查状态等操作。

• 修改uWSGI配置

  1. 将项目文件夹/uwsgi.ini下的Http通信方式改为socket通信方式

     [uwsgi]
     # 去掉如下
     # http=127.0.0.1:8000
     # 改为套接字方式的 IP地址:端口号
     socket=127.0.0.1:8000
     

  2. 重启uWSGI服务

     $ sudo uwsgi --stop uwsgi.pid
     $ sudo uwsgi --ini 项目文件夹/uwsgi.ini
     

• 测试：在浏览器端输入http://127.0.0.1 进行测试

• 注意

  • 此时端口号为80(nginx默认端口)
  • Django中有任何修改 需要重启uwsgi , 否则修改不生效

nginx 配置静态文件路径

• 创建新路径，主要存放Django所有静态文件
• 在Django settings.py中添加新配置

  #此配置路径为存放所有正式环境中需要的静态文件
  STATIC_ROOT = '.../项目名_static/static'
  

• 终端项目文件夹下，执行python3 manage.py collectstatic
  执行该命令后，Django将项目重所有静态文件 复制到 STATIC_ROOT 中 ，包括Django内建的静态文件
• Nginx配置中添加新配置

  # file : /etc/nginx/sites-enabled/default
  # 新添加location /static 路由配置
  server {
      ...
      location /static {
          # root 重定向到指定的创建文件夹的绝对路径
           root .../项目名_static;          
      }
      ...      
  }