Ubuntu14.04部署Flak应用+WSGI+Nginx(亲测)

前言:######

在云主机上部署之前,我在本地的虚拟机上进行了部署,web服务器采用uwsgi,它是一个支持包括WSGI在内的多种不同接口的web服务器。
supervisor用来做常规启动服务,nginx作为反向代理。将部署过程中遇到的问题记录一下,供以后部署时参照。

1、环境

虚拟机ubuntu 14.04.0系统

2、部署步骤
. 2.1安装pip和virtualenv

安装pip

sudo apt-get install python-pip

** 安装virtualenv**
为了避免不同项目之间的python环境相互污染,采用它来解决依赖,使用virtualenv的好处就是,不用的应用使用不同的环境。在该环境中安装插件不用管理员权限安装。

sudo pip install virtualenv
. 2.2 下载项目并创建虚拟环境

我的项目是在gitlib上,所以关于如何将项目从gitlib(github)上下载到本地就不过多说了。下载完后的项目目录为:

/home/www/webapp

在webapp目录下创建虚拟环境

ubuntu@ubuntu:/home/www/webapp$ virtualenv venv # 创建虚拟环境
ubuntu@ubuntu:/home/www/webapp$  source venv/bin/active # 激活虚拟环境
(venv)ubuntu@ubuntu:/home/www/webapp$   # 表示已经激活了虚拟环境,退出当前环境可以使用deactivate 
. 2.3安装uwsgi

uwsgi是一个很大的C应用,所以需要解决一些依赖,我在刚开始安装的过程中遇到最多的问题就是编译过程中报错,如引入python.h头文件出错,网上也有很多安装教程,如果遇到问题搜索一下就能解决。

ubuntu@ubuntu:/home/www/webapp$ sudo apt-get install python-dev
ubuntu@ubuntu:/home/www/webapp$ sudo apt-get install uwsgi

安装完成之后先不考虑部署问题,先来看看flask应用的目录结构

. 2.4Flask目录结构
/home/www/webapp
                ---migrations/ 数据库迁移目录
                --- venv/  虚拟环境
                ---webapp/ 程序目录
                ---__init__.py
                ---manage.py 
                ---requirements.txt
manage.py文件中采用flask_script拓展。
命令行运行程序 python manage.py runserver
.2.5安装Flask依赖

进入我们2.2步骤创建的虚拟环境中,使用requirements.txt文件来安装所有的依赖

(venv)ubuntu@ubuntu:/home/www/webapp$ pip install -r requirements.txt

注意:在所有的依赖安装安装完成之后,我们最后使用在命令行python manage.py runserver验证我们的依赖是否安装完全。
如果命令行运行没问题就进行下一步的配置。

.2.6 配置uwsgi

在项目目录webapp下新建一个config.ini用来启动uwsgi

uwsgi]

# uwsgi 启动时所使用的地址与端口
socket = 127.0.0.1:8001 
# 指向网站目录
chdir = /home/www/ webapp
# python 启动程序文件
wsgi-file = manage.py 
# python 程序内用以启动的 application 变量名
callable = app 
# 处理器数
processes = 4
# 线程数
threads = 2
#状态检测地址
stats = 127.0.0.1:9191

运行uwsgi

(venv)ubuntu@ubuntu:/home/www/webapp$ uwsgi config.ini
如果没有问题,程序会运行起来,
但是我在配置的过程中,在程序运行起来之后(程序运行起来时打印出来日志让我判断uwsgi已经把程序运行了),
在本地的8001端口并不能访问程序首页,我直接进行下一步了。
.2.7 安装supervisor

我使用supervisor来启动应用

sudo apt-get install supervisor

supervisor的全局配置文件在/etc/supervisor/supervisor.conf

我们不用改动,直接新建一个*.conf文件拷贝到/etc/supervisor/conf.d目录下

我们新建一个用来启动我们应用的配置文件(flask_supervisor.conf),这个文件需要拷贝到上面说的目录。

[program:webapp]
# 启动命令入口, 使用虚拟环境中的uwsgi运行我们的程序,这句就和刚刚上面我们使用uwsgi config.ini作用一样
command=/home/www/webapp/venv/bin/uwsgi /home/www/webapp/config.ini 

# 命令程序所在目录
directory=/home/www/webapp
#运行命令的用户名
user=ubuntu
        
autostart=true
autorestart=true
#日志地址,在supervisor运行时,保证这个目录和文件是存在的,否则会报错
stdout_logfile=/home/www/webapp/logs/uwsgi_supervisor.log      

启动服务和终止服务

sudo service supervisor start/stop

问题:我在将自定的配置文件flask_supervisor.conf文件拷贝到相应位置后,重启了supervisor后,提示重启成功,但是没有任何报错(后面步骤会说得到报错情况)。
于是我使用下面的命令重新加载supervisor后报错了。

错误信息
unix:///var/run/supervisor.sock no such file

解决办法:https://github.com/Supervisor/supervisor/issues/480

我使用了这个方法后解决了
sudo touch /var/run/supervisor.sock
sudo chmod 777 /var/run/supervisor.sock
sudo service supervisor restart

改完使用supervisorctl reload来让supervisor重新加载配置文件,通过supervisor status webapp查看我们webapp应用状态。
这里你要确认你的supervisor配置正确后在进行下面的步骤。

.2.8 安装nginx
sudo apt-get install nginx

安装完成之后配置nginx
新建一个default文件,然后将这个文件拷贝到/ext/nginx/sites-available/下面替换到原来的default文件即可。

    server {
      listen  80;
      server_name xxx.xxx.xxx.xxx; #公网地址
    
      location / {
        include      uwsgi_params;
        uwsgi_pass   127.0.0.1:8001;  # 指向uwsgi 所应用的内部地址,所有请求将转发给uwsgi 处理
        uwsgi_param UWSGI_PYHOME /home/www/webapp/venv; # 指向虚拟环境目录
        uwsgi_param UWSGI_CHDIR  /home/www/webapp; # 指向网站根目录
        uwsgi_param UWSGI_SCRIPT manage:app; # 指定启动程序
      }
    }

配置好后重启服务

sudo service nginx restart

《Ubuntu14.04部署Flak应用+WSGI+Nginx(亲测)》 restart

保证你的nginx在修改完配置后重启成功[ok]

3、可能遇到的问题
.3.1 nginx都配置好后,访问公网ip出现502

如果上面的都配置好后,出现502的错误,说明你的nginx配置没有问题,但是问题出在了supervisor上,它并没有把我们的程序运行起来,所以你把注意力转移到supervisor配置上。采用2.7步骤中描述的那样好好检查配置。
或者手动运行uwsgi config.ini文件把程序启动起来,然后在访问公网IP,看看能不能访问到,正常情况下是可以的,这就验证了supervisor没有启动程序。

4、总结

网上有很多关于这方面的内容,不管别人说的再详细,自己在操作的过程中肯定不会一次通过,有些人没有把一些坑写出来,或者没遇到,所以想要成功部署还需要自己亲自趟一趟。

    原文作者:嘿嘿_小余同学
    原文地址: https://www.jianshu.com/p/dc909022e51a
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞