nginx+uWSGI+django+virtualenv+supervisor部署发布web项目

Posted 2021-01-18 Today is a nice day

 nginx (engine x) 是一个高性能的HTTP和反向代理服务，也是一个IMAP/POP3/SMTP服务。

wsgi是PythonWeb服务器网关接口(Web Server Gateway Interface)，WSGI是作为Web服务器与Web应用程序或应用框架之间的一种低级别的接口，以提升可移植Web应用开发的共同点。WSGI是基于现存的[[CGI]]标准而设计的。

Django是一个开放源代码的Web应用框架，由Python写成。

Virtualenv指的的Python的虚拟环境

supervisor管理进程，是通过fork/exec的方式将这些被管理的进程当作supervisor的子进程来启动，所以我们只需要将要管理进程的可执行文件的路径添加到supervisor的配置文件中就好了。此时被管理进程被视为supervisor的子进程，若该子进程异常中断，则父进程可以准确的获取子进程异常中断的信息，通过在配置文件中设置autostart=ture，可以实现对异常中断的子进程的自动重启。

整个请求和响应流程如下：

 一、Python环境的准备

说明，系统为centos 7.3

1 安装python3

安装python 3.4和对应版本的pip 

[root@node1 ~]# yum install  python34.x86_64   python34-pip.noarch -y

2 安装虚拟环境

[root@node1 ~]# pip3 install virtualenv

（1）创建虚拟目录

[root@node1 ~]# virtualenv  django

（2）进入虚拟目录

[root@node1 ~]# cd django/

（3）启用虚拟环境

[root@node1 django]# source bin/activate

可以看到目录地下有默认的几个文件夹

(django) [root@node1 django]# ll
total 0
drwxr-xr-x 3 root root 330 Nov  5 15:00 bin
drwxr-xr-x 2 root root  24 Nov  5 14:55 include
drwxr-xr-x 3 root root  23 Nov  5 14:55 lib
lrwxrwxrwx 1 root root  16 Nov  5 14:55 lib64 -> /root/django/lib

 二、Django的安装与项目创建以及配置

1 安装Django，这里使用1.11版本

(django) [root@node1 django]# pip3 install django==1.11
Collecting django==1.11
  ……………
Installing collected packages: pytz, django
Successfully installed django-1.11 pytz-2018.7

2 创建项目和应用

（1）创建名为mysite的项目

 (django) [root@node1 django]# django-admin startproject mysite

（2）创建名为app01的应用

(django) [root@node1 django]# cd mysite/
(django) [root@node1 mysite]#python3  manage.py  startapp  app01

（3）可以看到mysite项目下有如下目录

(django) [root@node1 mysite]# ll
total 4
drwxr-xr-x 3 root root 123 Nov  5 15:07 app01
-rwxr-xr-x 1 root root 804 Nov  5 15:04 manage.py
drwxr-xr-x 3 root root  93 Nov  5 15:07 mysite

 3 修改默认配置文件

（1）修改Django配置文件mysite/settings.py

ALLOWED_HOSTS = [\'*\']

注册app01
INSTALLED_APPS = [
\'app01.apps.App01Config\',
....
]

静态文件目录
STATIC_URL = \'/static/\'
STATICFILES_DIRS=[
    os.path.join(BASE_DIR,"static"),
]

（2）修改路由匹配规则mysite/urls.py

from django.conf.urls import url
from django.contrib import admin
from app01 import views

urlpatterns = [
    url(r\'^admin/\', admin.site.urls),
    url(r\'^index/\', views.index),
]

（3）新建功能，修改app01/views.py

from django.shortcuts import HttpResponse

def index(request):
    return HttpResponse(\'Hello World!\')

 4 启动Django

(django) [root@node1 mysite]# python3 manage.py  runserver
Performing system checks...
…….
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

测试访问

[root@node1 ~]# curl http://127.0.0.1:8000/index/
Hello World!

 三、uwsgi的安装与配置

1 由于使用pip3 install uwsgi 安装会报我不能解决的错误

在ubuntu上不会有这个错误

Command "/usr/bin/python3.4 -u -c "import setuptools, tokenize;
__file__=\'/tmp/pip-install-k0ebn5sl/uwsgi/setup.py\';
f=getattr(tokenize, \'open\', open)(__file__);
code=f.read().replace(\'\\r\\n\', \'\\n\');
f.close();
exec(compile(code, __file__, \'exec\'))" \\
install --record /tmp/pip-record-eekd779j/install-record.txt \\
--single-version-externally-managed \\
--compile" failed with error code 1 in /tmp/pip-install-k0ebn5sl/uwsgi/

故采用以下安装方式（仅限centos）：

[root@node1 ~]# yum install uwsgi

查看版本

[root@node1 ~]# uwsgi --version
2.0.17.1

2 安装uwsgi-plugin-python3

注：插件 Ubuntu不需要此步骤

[root@node1 ~]# yum install -y uwsgi-plugin-python34.x86_64

为解决启动报错：

!!! UNABLE to load uWSGI plugin: /usr/lib64/uwsgi/python_plugin.so: cannot open shared object file: No such file or directory !!!

[root@node1 ~]# ln -sv /usr/lib64/uwsgi/python34_plugin.so /usr/lib64/uwsgi/python_plugin.so

3 启动uwsgi

(django) [root@node1 mysite]# uwsgi --http-socket :8888 --plugin python --wsgi-file ./test.py

Ubuntu下：uwsgi --http :88888 --wsgi-file test.py

4 测试

[root@node1 ~]# curl http://127.0.0.1:8888/index/
This is uwsgi test

test.py文件内容如下：

def application(env, start_response):
    start_response(\'200 OK\', [(\'Content-Type\',\'text/html\')])
    return [b"This is uwsgi test"]

5 报错解决

（1）invalid request block size: 21573 (max 4096)...skip

buffer-size = 65536

（2）-- unavailable modifier requested: 0 --

-- unavailable modifier requested: 0 –

plugins = python #指定插件

 四、Django与uwsgi的结合

1 热启动Django

（1）uWsgi热加载python程序（仅做测试使用）

(django) [root@node1 mysite]# uwsgi --http-socket  :8000 --plugin python  --module  mysite.wsgi  --py-autoreload=1

按下Ctrl +C 可终止进程

（2）启动Django

(django) [root@node1 mysite]# uwsgi --http-socket  :8000 --plugin python  --module mysite.wsgi

 2   在/etc/目录下新建uwsgi_nginx.ini

uwsgi支持ini、xml等多种配置方式，本文以 ini 为例，添加如下配置

[root@node1 ~]# cat /etc/uwsgi_nginx.ini
[uwsgi]
# Django-related settings
# the base directory (full path)  #Django项目的目录
chdir           = /root/django/mysite
# Django\'s wsgi file
module          = mysite.wsgi
# the virtualenv (full path)  #虚拟目录的路径
home            = /root/django
# process-related settings
# master
master          = true
# maximum number of worker processes  #启动进程数，处理器个数
processes       = 1
# threads = 4                 #线程个数
# the socket (use the full path to be safe  #指定套接字
socket          = 0.0.0.0:8000
# ... with appropriate permissions - may be needed #权限设置，要是提示权限不够，可以改为666
# chmod-socket    = 664
# clear environment on exit #退出时清除环境
vacuum          = true
#指定插件，不然会报错：-- unavailable modifier requested: 0 --
plugins = python

3 指定配置文件并启动uwsgi

[root@node1 ~]# uwsgi --ini  /etc/uwsgi_nginx.ini

五、 配置nginx结合uWSGI

1 安装Nginx

[root@node1 ~]# yum install nginx –y

2 新建Nginx配置文件

[root@node1 ~]# vim /etc/nginx/conf.d/djang.conf

server {
    listen       80;
    server_name  192.168.15.128; #指定本机ip或者配置你的域名
    location / {
              include  /etc/nginx/uwsgi_params;
              uwsgi_pass 0.0.0.0:8000;

              }
    location /static {  #配置静态文件目录
              alias /root/django/mysite/static;
              }
    location /media {
              alias /root/django/mysite/media;
              }
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   html;
    }
}

3 启动nginx

[root@node1 ~]# systemctl start nginx

此时以及可以测试访问了

[root@node1 ~]# curl http://127.0.0.1/index/
Hello World!

用浏览器测试如下

 

六、nginx结合supervisor

1 安装supervisor

[root@node1 ~]# yum install python34-setuptools.noarch
[root@node1 ~]# yum install  supervisor

2 生成配置文件

通过命令生成supervisor的配支文件

[root@node1 ~]# echo_supervisord_conf > /etc/supervisord.conf

3 编辑配置文件/etc/supervisord.conf

再最后添加如下内容：

[program:mysite]
command= /usr/sbin/uwsgi --uwsgi-socket 0.0.0.0:8000 --plugin python\\
--chdir /root/django/mysite --home=/root/django --module mysite.wsgi
directory=/root/django/mysite
startsecs=0
stopwaitsecs=0
autostart=true
autorestart=true

说明：

# [program:mysite] 指定程序名称
# /usr/sbin/uwsgi 指定uwsgi的位置，
#--chdir /root/django/mysite 指定项目路径
# --home=/root/django 指定寻虚拟目录

4 启动supervisor

最后启动supervisor，完成uWSGI启动django，nginx反向代理

[root@node1 ~]#  supervisord  -c /etc/supervisord.conf

此时配置完成！！至此，所有配置均已完成

 

操作说明：

supervisorctl -c /etc/supervisord.conf [start|stop|restart] [program-name|all]

（1）启动mysite程序

supervisorctl -c /etxc/supervisord.conf  start  mysite

（2）重启mysite程序

supervisorctl  -c  /etc/supervisord.conf  restart   mysite

（3）停止mysite程序

supervisorctl  -c  /etc/supervisord.conf  stop  mysite

（4）更新新的配置到supervisord   

supervisorctl  update

（5）重新启动配置中的所有程序

supervisorctl reload

 

参考：

https://www.cnblogs.com/pyyu/p/9481344.html
https://uwsgi-docs-zh.readthedocs.io/zh_CN/latest/tutorials/Django_and_nginx.html
https://uwsgi-docs.readthedocs.io/en/latest/tutorials/Django_and_nginx.html