Flask部署笔记

在开发机上的准备工作：

  1. 确认项目没有bug。
  2. 用pip freeze > requirements.txt将当前环境的包导出到requirements.txt文件中，方便在部署的时候安装。

  3. 将项目上传到服务器上的/srv目录下。这里以git的形式为例。scp

    • git init
    • git remote add origin xxx.git
    • git add .
    • git commit -m ‘first commit’
    • git pull origin master —allow-unrelated-histories
    • git push origin master

      在服务器上的准备工作：

  4. 安装好项目用到的Python。

    • sudo apt install python3
    • sudo apt install python3-pip
    • pip3 install —upgrade pip

  5. 安装virtualenv以及virutalenvwrapper。并创建虚拟环境。

    • pip3 install virtualenv
    • pip3 install virtualenvwrapper
    • sudo apt install vim

    • vim ~/.bashrc 进入文件中，填入以下两行代码：

      1. export WORKON_HOME=$HOME/.virtualenvs
      2. source /usr/local/bin/virtualenvwrapper.sh

    • source ~/.bashrc

  6. 创建虚拟环境：

    1. mkvirtualenv --python=/usr/bin/python3 zlbbs-env

  7. 安装git：

    1. sudo apt install git

  8. 为了方便XShell或者CRT连接服务器，建议安装OpenSSH：

    1. > sudo apt install openssh-server openssh-client
    2. > service ssh restart

  9. 安装MySQL服务器和客户端：

    1. > sudo apt install mysql-server mysql-client
    2. > sudo apt-get install libmysqld-dev

  10. 进入虚拟环境中，然后进入到项目所在目录，执行命令：pip install -r requirements.txt，安装好相应的包。

  11. 在mysql数据库中，创建相应的数据库。
  12. 执行python manage.py db upgrade命令，将迁移文件，映射到数据库中，创建相应的表。
  13. 执行python zlbbs.py，然后在你自己电脑上，在浏览器中输入http://你的服务器的ip地址:8000/，访问下网站所有页 面，确保所有页面都没有错误。

  14. 设置DEBUG=False，避免如果你的网站产生错误，而将错误信息暴漏给用户。

    安装uwsgi

  15. uwsgi是一个应用服务器，非静态文件的网络请求就必须通过他完成，他也可以充当静态文件服务器，但不是他的强项。uwsgi是使用python编写的，因此通过pip install uwsgi就可以了。(uwsgi必须安装在系统级别的Python环境中，不要安装到虚拟环境中)。

  16. 使用命令uwsgi --http :8000 --wsgi-file /opt/zlbbs/zlbbs.py -callable app -H /root/.virtualenvs/zlbbs-env。用uwsgi启动项目，如果能够在浏览器中访问到这个页面，说明uwsgi可以加载项目了。

    编写uwsgi配置文件：

    在项目的路径下面，创建一个文件叫做zlbbs_uwsgi.ini的文件，然后填写以下代码：

    1. [uwsgi]
    2. # Django相关的配置
    3. # 必须全部为绝对路径
    4. # 项目的路径
    5. chdir           = /srv/zlbbs
    6. # 模块
    7. module          = zlbbs
    8. # Python虚拟环境的路径
    9. home            = /root/.virtualenvs/zlbbs-env
    10. # 进程相关的设置
    11. # 主进程
    12. master          = true
    13. # 最大数量的工作进程
    14. processes       = 10
    15. # socket文件路径，绝对路径
    16. socket          = /srv/zlbbs/zlbbs.sock
    17. # wsgi文件
    18. wsgi-file       = /srv/zlbbs/wsgi.py
    19. # wsgi文件的app变量
    20. callable        = app
    21. # 设置socket的权限
    22. chmod-socket    = 666
    23. # 退出的时候是否清理环境
    24. vacuum          = true

    然后使用命令uwsgi --ini zlbbs_uwsgi.ini，看下是否还能启动这个项目。

    安装nginx：

  17. nginx是一个web服务器。用来加载静态文件和接收http请求的。通过命令sudo apt install nginx即可安装。

  18. nginx常用命令：

    • 启动nginx：service nginx start
    • 关闭nginx：service nginx stop
    • 重启nginx：service nginx restart

      编写nginx配置文件：

      在/etc/nginx/conf.d目录下，新建一个文件，叫做zlbbs.conf，然后将以下代码粘贴进去：
      1. upstream zlbbs {
      2. server unix:///srv/zlbbs/zlbbs.sock; 
      3. }
      4. # 配置服务器
      5. server {
      6. # 监听的端口号
      7. listen      80;
      8. # 域名
      9. server_name 192.168.0.101; 
      10. charset     utf-8;
      11. # 最大的文件上传尺寸
      12. client_max_body_size 75M;  
      13. # 静态文件访问的url
      14. location /static {
      15.    # 静态文件地址
      16.    alias /srv/zlbbs/static; 
      17. }
      18. # 最后，发送所有非静态文件请求到django服务器
      19. location / {
      20.    uwsgi_pass  zlbbs;
      21.    # uwsgi_params文件地址
      22.    include     /etc/nginx/uwsgi_params; 
      23. }
      24. }
      写完配置文件后，为了测试配置文件是否设置成功，运行命令：service nginx configtest，如果不报错，说明成功。 每次修改完了配置文件，都要记得运行service nginx restart。

      使用supervisor配置：

      让supervisor管理uwsgi，可以在uwsgi发生意外的情况下，会自动的重启。

  19. supervisor的安装：在系统级别的python环境下pip install supervisor。

  20. 在项目的根目录下创建一个文件叫做zlbbs_supervisor.conf。内容如下：

    1. # supervisor的程序名字
    2. [program:zlbbs]
    3. # supervisor执行的命令
    4. command=uwsgi --ini zlbbs_uwsgi.ini
    5. # 项目的目录
    6. directory = /srv/zlbbs 
    7. # 开始的时候等待多少秒
    8. startsecs=0
    9. # 停止的时候等待多少秒
    10. stopwaitsecs=0  
    11. # 自动开始
    12. autostart=true
    13. # 程序挂了后自动重启
    14. autorestart=true
    15. # 输出的log文件
    16. stdout_logfile=/srv/zlbbs/log/supervisord.log
    17. # 输出的错误文件
    18. stderr_logfile=/srv/zlbbs/log/supervisord.err
    19. [supervisord]
    20. # log的级别
    21. loglevel=info
    22. # 使用supervisorctl的配置
    23. [supervisorctl]
    24. # 使用supervisorctl登录的地址和端口号
    25. serverurl = http://127.0.0.1:9001
    26. # 登录supervisorctl的用户名和密码
    27. username = admin
    28. password = 123
    29. [inet_http_server]
    30. # supervisor的服务器
    31. port = :9001
    32. # 用户名和密码
    33. username = admin
    34. password = 123
    35. [rpcinterface:supervisor]
    36. supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

  21. 然后使用命令supervisord -c zlbbs_supervisor.conf运行就可以了。 以后如果想要启动uwsgi，就可以通过命令supervisorctl -c supervisor.conf进入到管理控制台，然后可以执行相关的命令进行管理：

    • status # 查看状态
    • start program_name #启动程序
    • restart program_name #重新启动程序
    • stop program_name # 关闭程序
    • reload # 重新加载配置文件
    • quit # 退出控制台