第一次在服务器上面部署Flask应用程序，踩了挺多坑，还好最终成功部署，记录一下。

uWSGI和Nginx

什么是Web服务器、Web框架、WSGI协议

  • Web服务器：用于接受客户端请求，建立连接，转发响应的程序
  • Web框架：处理业务逻辑。如模板渲染、数据库查询
  • WSGI协议：一种Server与Application解耦的规范，只要满足协议，那么就可以选择任意Server和Application组合成Web应用
    • WSGI Server：负责从客户端接收请求，将Request转发给Application，将Application返回的Response返回给客户端
    • WSGI Application：接收由Server转发的Request，处理并将结果返回给Server

而uWSGI，则是实现了WSGI Server协议的Web服务器，Flask是实现了WSGI Application协议的Web框架，也就是说它们可以直接组合成一个Web应用。
i> 为什么还需要Nginx

  • 虽然可以直接由uWSGI和Flask构成网站，但是如果访问量过大，客户端请求连接就要进行长时间的等待。此时就需要Nginx反向代理，实现分配客户端的请求连接和Web服务器的功能。

    安装Python3

  • 先看看现在的Python版本，默认是Python2

    1. $ python --version
    2. # Python 2.7.5

  • 下载Python3

    1. $ pwd
    2. # /root
    3. $ mkdir python && cd python
    4. $ wget https://www.python.org/ftp/python/3.7.0/Python-3.7.0.tgz

  • 编译安装

    1. $ tar -zxvf Python-3.7.0.tgz   # 解压
    2. $ ls
    3. >>> Python-3.7.0  Python-3.7.0.tgz
    4. $ cd Python-3.7.0/
    5. $ ./configure --prefix=/usr/local/python3.7
    6. $ make && make install

  • 备份Python2

    1. $ mv /usr/bin/python /usr/bin/python2.7.5

  • 如果你的系统为centos，还需要修改yum的配置，因为其使用的是Python2

    1. $ vim /usr/bin/yum
    2. $ vim /usr/libexec/urlgrabber-ext-down
    3. # 将两个文件中的第1行都修改为Python2的路径后保存即可
    4. #!/usr/bin/python2.7.5

  • 软链Python3和pip3

    1. $ ln -sv  /usr/local/python3.7/bin/python3.7 /usr/bin/python
    2. # $ ln -sv  /usr/local/python3.7/bin/pip3.7 /usr/bin/pip3

  • 验证

    1. $ python -V
    2. >>> Python 3.7.0
    3. $ pip -V
    4. >>> pip... for python 3.7.0
    5. # 如果pip版本较旧可以更新一下
    6. $ python -m pip install --upgrade pip

  • Pip换源，适用于国内服务器

    1. $ vim ~/.pip/pip.conf
    2. # 修改成下面的阿里源
    3. [global]
    4. index-url=https://mirrors.aliyun.com/pypi/simple/
    5. [install]
    6. trusted-host=mirrors.aliyun.com

    安装虚拟环境

  • 安装VirtualEnv

    1. $ sudo pip install virtualenv

  • 报错：WARNING: The script virtualenv is installed in '/usr/local/python3.7/bin' which is not on PATH.

    • 原因：virtualenv未添加到PATH中
    • 可通过 /usr/local/python3.7/bin/virtualenv 调用virtualenv
    • 通过以下方法将virtualenv添加到PATH中
      1. $ vim ~/.bashrc 
      2. # 末尾添加以下一行然后保存退出
      3. export PATH=/usr/local/python3.7/bin:$PATH
      4. # 使配置生效
      5. $ source ~/.bashrc

  • 进入项目目录

    1. $ cd /www/wwwroot/flask/

  • 创建虚拟环境venv_flask并进入

    1. $ virtualenv venv_flask
    2. $ source venv_flask/bin/activate
    3. # 退出虚拟环境
    4. # $ deactivate

  • 安装项目所需依赖，注意此时是在虚拟环境中

    1. (venv)$ pip install -r requirements.txt
    2. # 前面如果没有换源,可以通过以下命令临时使用国内源
    3. # (venv)$ pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt

    配置uWSGI

  • 先安装

    1. (venv)$ pip install uwsgi

  • 配置uWSGI。先在项目根目录创建uwsgi.ini文件，配置如下

    1. [uwsgi]
    2. # uwsgi启动时所使用的地址与端口
    3. socket = 127.0.0.1:5000
    4. # 指向网站目录
    5. chdir = /www/wwwroot/flask
    6. # python 启动程序文件
    7. wsgi-file = app.py    
    8. # python 程序内用以启动的 application 变量名
    9. callable = app 
    10. # 处理器数
    11. processes = 4
    12. # 线程数
    13. threads = 2
    14. #状态检测地址
    15. stats = 127.0.0.1:9191

  • 运行测试一下

    1. # 提示 uwsgi: command not found 即未建立软连接
    2. # ln -s /usr/local/python3.7/bin/uwsgi /usr/bin/uwsgi
    3. (venv)$ uwsgi uwsgi.ini
    4. *** Starting uWSGI 2.0.18 (64bit) on [Tue Mar  3 20:13:35 2020] ***
    5. ..........
    6. spawned uWSGI master process (pid: 17712)
    7. spawned uWSGI worker 1 (pid: 17713, cores: 2)
    8. spawned uWSGI worker 2 (pid: 17714, cores: 2)
    9. spawned uWSGI worker 3 (pid: 17716, cores: 2)
    10. spawned uWSGI worker 4 (pid: 17717, cores: 2)
    11. *** Stats server enabled on 127.0.0.1:9191 fd: 15 ***

  • 此时已经正常启动 uwsgi 并将 Flask 项目载入其中了，Ctrl+C 关闭程序。但这只是命令启动形式，要使其随同服务器启动并作为后台服务运行才是运营环境的实际所需要。因此接下来我们需要安装另一个工具来引导 uwsgi 。

    配置Nginx

    1. server
    2. {
    3.   listen 80;
    4.   server_name xxx.xxx.xxx.xxx;  # IP或域名
    6.    location / {
    7.      include uwsgi_params;
    8.      uwsgi_pass 127.0.0.1:5000;
    9.      uwsgi_param UWSGI_PYHOME /www/wwwroot/flask/venv_flask/bin;  # Python位置或虚拟环境
    10.      uwsgi_param UWSGI_CHDIR /www/wwwroot/flask;  # 项目根目录
    11.      uwsgi_param UWSGI_SCRIPT app:app;            # 启动项目的主程序
    12.     }
    13. }

    启动

  • 后台运行

    1. $ uwsgi --ini /www/wwwroot/flask/uwsgi.ini --daemonize /www/wwwroot/flask/log.out
    2. # 查看进程是否启动成功
    3. $ ps -ef | grep uwsgi
    4. # 如果需要停止服务,可以Kill掉对应的进程ID
    5. $ kill -9 进程id

    其它

  • 一开始部署到服务器时连接到数据库中没有表，一直报错。

    1. ### 经过排查才想起来还没建表，于是将代码改成这样然后手动运行了一下
    2. if __name__ == '__main__':
    3.   db.create_all()  # 建表
    4. ### 然后再将建表的语句删除，并再次运行
    5. if __name__ == '__main__':
    6.   app.run()

  • 网上很多方法都是使用 Supervisor引用uWSGI作常规启动服务，但是我对Supervisor并不熟悉，于是就不折腾了。可以直接将后台运行语句添加到开机自启实现。

  • 参考