django 项目部署详细教程 【uwsgi + nginx

发表于

小知识，大挑战！本文正在参与“程序员必备小知识”创作活动。

本文同时参与 「掘力星计划」 ，赢取创作大礼包，挑战创作激励金

项目部署

  1. 环境搭建

不使用 Anaconda 可直接跳到创建虚拟环境

1.1 Anaconda 下载

1.2 Anaconda 安装

  • 下载好后传到Linux
    在这里插入图片描述
  • 安装
1
ruby复制代码  root@iZwz9ijwralw5z37wd16xsZ:~# bash ~/Downloads/Anaconda3-5.3.1-Linux-x86_64.sh

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-uxvB4xoo-1596510168906)(C:\Users\user\AppData\Roaming\Typora\typora-user-images\image-20200726085008704.png)]

  • 回车安装到默认路径即可
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-QVZgCMiB-1596510168908)(C:\Users\user\AppData\Roaming\Typora\typora-user-images\image-20200726085429443.png)]
  • 建议输入yes，输入No的话还需要自己手动添加路径，否则conda将无法正常运行
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-xnxv4n7e-1596510168910)(C:\Users\user\AppData\Roaming\Typora\typora-user-images\image-20200726085610006.png)]
  • 是否安装VSCode，随便，我这里不安装
  • 启动服务
1
ruby复制代码root@iZwz9ijwralw5z37wd16xsZ:~# source ~/.bashrc
  • 输入conda list , 安装成功会显示包名

1.3 环境配置

  • 创建 anaconda 环境
+ conda create -n name python版本号




1
ruby复制代码root@iZwz9ijwralw5z37wd16xsZ:~# conda create -n MyDjango python=3.6.2

1.4 创建虚拟环境

  • 下载虚拟环境pip包
    • pip install virtualenv
    • pip install virtualenvwrapper
  • 修改 .bashrc 文件
1
2
3
4
5
6
7
8
bash复制代码vim ~/.bashrc
# 添加下面代码
export WORKON_HOME=$HOME/.virtualenvs
export PROJECT_HOME=$HOME/workspace
source /usr/local/bin/virtualenvwrapper.sh

# 使 .bashrc 生效
source ~/.bashrc
  • 使用 anaconda环境/python环境 创建新虚拟环境
+ mkvirtualenv --python='指定路径' 环境名称
+ eg：
1
ini复制代码mkvirtualenv --python='/root/anaconda3/envs/MyDjango/bin/python' MyDjango

默认情况下，新创建的环境将会被保存在/Users/<user_name>/anaconda3/env目录下，其中，<user_name>为当前用户的用户名。
不指定python环境的话，默认会选择本地的python版本

  • 进入虚拟环境
+ workon MyDjango
  1. 项目拉到服务器

2.1 项目迁移

2.1.1 方法一（Xftp）

  • 通过 Xftp 将项目文件从本机直接拉到服务器
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-VIpr7KCT-1596510168912)(C:\Users\user\AppData\Roaming\Typora\typora-user-images\image-20200726094725914.png)]

2.2.2 方法二（git）

  • 服务器安装git
    • apt-get install git
  • 通过 git clone 命令将仓库克隆到服务器

2.2 安装项目依赖包

  • 在本机项目中通过 pip freeze > requirement.txt 命令将项目所需包输出到 requirement.txt 文件中
  • 服务器端项目中。通过 pip install -r requirements.txt 命令安装包
  1. uwsgi
  • 遵循 wsgi 协议的 web 服务器

在这里插入图片描述

3.1 uwsgi 的安装

  • pip install uwsgi

3.2 uwsgi 的配置

  • 项目部署时，需要修改 settings.py 文件
1
2
ini复制代码DEBUG=FALSE
ALLOWED_HOSTS=['*']
  • 在项目中新建一个文件 uwsgi.ini，方便启动/终止 uwsgi 服务
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
ini复制代码[uwsgi]
# 使用nginx链接时使用
# socket=127.0.0.1:8000
# 直接做web服务器使用 python manage.py runserver ip:port
http=127.0.0.1:8000
# 项目目录 [pwd查看 直接填，不需要引号]
chdir=
# 项目中wsgi.py文件的目录，相对于项目目录
wsgi-file=
# 指定启动的工作进程数
processes=4
# 指定工作进程中的线程数
threads=2
# 进程中，有一个主进程
master=True
# 保存启动之后主进程的pid
pidfile=uwsgi.pid
# 设置uwsgi后台运行, uwsgi.log 保存日志信息
daemonize=uwsgi.log
# 设置虚拟环境的路径 [cd .virtualenvs]
virtualenv=

下面是我的uwsgi.ini 文件配置，可以参考一下。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
ini复制代码[uwsgi]
# 使用nginx链接时使用
socket=127.0.0.1:8000
# 直接做web服务器使用 python manage.py runserver ip:port
# http=127.0.0.1:8000
# 项目目录 [pwd查看 直接填，不需要引号]
chdir=/root/MyDjango
# 项目中wsgi.py文件的目录，相对于项目目录
wsgi-file=MyDjango/wsgi.py
# 指定启动的工作进程数
processes=4
# 指定工作进程中的线程数
threads=2
# 进程中，有一个主进程
master=True
# 保存启动之后主进程的pid
pidfile=uwsgi.pid
# 设置uwsgi后台运行, uwsgi.log 保存日志信息
daemonize=uwsgi.log
# 设置虚拟环境的路径 [cd .virtualenvs]
virtualenv=/root/.virtualenvs/MyDjango

3.3 uwsgi 的启动和停止

  • 启动： uwsgi –ini 配置文件路径
    • 例如： uwsgi –ini uwsgi.ini
    • 启动后，ps aux | grep uwsgi 命令可以查看uwsgi 进程
  • 停止： uwsgi –stop uwsgi.pid 路径
    • 例如： uwsgi –stop uwsgi.pid

这里有一个小问题，如果遇到可以看一下解决方法

问题：

​ 执行启动后，报错信息 uwsgi: error while loading shared libraries: libpcre.so.1: cannot open shared object file: No such file or directory

解决方法：

​ sudo apt-get install libpcre3 libpcre3-dev # 安装需要的包

​ find / -name libpcre.so.3 # 找到libpcre.so.3（一般在根目录/lib/x86_64-linux-gnu下）

​ 找到 /lib/x86_64-linux-gnu/libpcre.so.3

​ sudo ln -s /lib/x86_64-linux-gnu/libpcre.so.3 /usr/lib/libpcre.so.1 # 做软链接即可

仅仅使用uwsgi，首页的静态文件不能显示

解决方法：

在uwsgi前面在加一个nginx服务器

nginx中进行配置

  1. 如果是动态请求，转交请求给uwsgi
  2. 如果是静态请求，提前把项目用到的静态文件放到nginx所在电脑的某个目录中

根据配置，nginx就会去目录下方找到静态文件，直接返回给用户

  1. nginx

在这里插入图片描述

4.1 nginx 配置转发请求给 uwsgi

  • uwsgi 需要更改配置文件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
ini复制代码[uwsgi]
# 使用nginx链接时使用
socket=127.0.0.1:8080
# 直接做web服务器使用 python manage.py runserver ip:port
# http=127.0.0.1:8080
# 项目目录 [pwd查看 直接填，不需要引号]
chdir=
# 项目中wsgi.py文件的目录，相对于项目目录
wsgi-file=
# 指定启动的工作进程数
processes=4
# 指定工作进程中的线程数
threads=2
# 进程中，有一个主进程
master=True
# 保存启动之后主进程的pid
pidfile=uwsgi.pid
# 设置uwsgi后台运行, uwsgi.log 保存日志信息
daemonize=uwsgi.log
# 设置虚拟环境的路径 [cd .virtualenvs]
virtualenv=
  • nginx配置转发请求给 uwsgi，配置路径为 /etc/nginx/sites-available/default
1
2
3
4
5
6
7
8
9
10
11
12
13
ini复制代码http{
	server {
		listen 80;
		server_name localhost;
		
		location / {
            # 包含uwsgi的请求参数
            include uwsgi_params;
            # 转交请求给uwsgi
            uwsgi_pass 127.0.0.1:8000  # uwsgi服务器的ip:port
    	}
	}
}
  • 下面是我的 default 配置信息，加了静态文件处理【静态文件处理请继续往下看】，可以参考一下
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
ini复制代码upstream MyDjango {
        server 127.0.0.1:8000;
}

server {
        listen 80;
        server_name localhost;

        location / {
                include uwsgi_params;
                uwsgi_pass MyDjango;
        }

        location /static {
                alias /var/www/MyDjango/static;
        }
}

ps aux | grep nginx # 查看是否有nginx进程

  • 启动nginx
    • /etc/init.d/nginx start 【终止命令为： /etc/init.d/nginx stop】

也可以用如下命令
service nginx start
service nginx stop
service nginx restart
service nginx reload

  • 启动uwsgi
    • uwsgi –ini uwsgi.ini

4.2 nginx配置处理静态文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
csharp复制代码http{
	server {
		listen 80;
		server_name localhost;
		
		location / {
            # 包含uwsgi的请求参数
            include uwsgi_params;
            # 转交请求给uwsgi
            uwsgi_pass 127.0.0.1:8080  # uwsgi服务器的ip:port;
    	}
    	
    	# 请求的路径中以static开头，就匹配下列地址
    	location /static {
    		# 指定静态文件存放的目录
    		alias 目录 例如： /var/xxx/static;
    						/var/www/MyDjango/static;
    	}
	}
}
  • django settings.py 中配置收集静态文件路径
1
2
3
csharp复制代码# settings.py 中设置
STATIC_ROOT=收集的静态文件路径  例如: /var/xxx/static
# 例如，我的路径为 STATIC_ROOT = '/var/www/MyDjango/static'
  • 创建文件夹

sudo mkdir -p /var/www/MyDjango/static

普通用户没有权限，需要修改文件权限

sudo chmod 777 /var/xxx/static/

  • django 收集静态文件的命令
+ python manage.py collectstatic
+ 执行上面的命令会把项目中所使用的静态文件收集到 STATIC\_ROOT 指定的目录下
  • 重启nginx服务

/etc/init.d/nginx reload

到这里，项目就部署完成了，还有其他需求可以继续往下看。

4.3 nginx转发请求给另外地址

  • 在 location 对应的配置项中增加 proxy_pass 转发的服务器地址，

如当用户访问 127.0.0.1 时，在nginx 中配置把这个请求转发给 172.10.179.115:80(nginx)服务器，让这台服务器提供静态页面

  • nginx配置如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
ini复制代码http{
	server {
		listen 80;
		server_name localhost;
		
		location / {
            # 包含uwsgi的请求参数
            include uwsgi_params;
            # 转交请求给uwsgi
            uwsgi_pass 127.0.0.1:8080  # uwsgi服务器的ip:port;
    	}
    	
    	# 请求的路径中以static开头，就匹配下列地址
    	location /static {
    		# 指定静态文件存放的目录
    		alias 目录 例如： /var/xxx/static;
    	}
    	
    	# 等号为精确匹配
    	location = / {
    		# 传递请求给静态文件服务器上的nginx
    		proxy_pass http://ip;
    	}
	}
}

4.4 nginx 配置 upstream 实现负载均衡

在这里插入图片描述

  • nginx 配置负载均衡时，在 server 配置的前面增加 upstream 配置项
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
ini复制代码http{
    # 名称随便起
    upstream ruochen {
        server 127.0.0.1:8080;
        server 127.0.0.1:8081;
    }

	server {
		listen 80;
		server_name localhost;
		
		location / {
            # 包含uwsgi的请求参数
            include uwsgi_params;
            # 转交请求给uwsgi
            # uwsgi_pass 127.0.0.1:8080  # uwsgi服务器的ip:port;
            uwsgi_pass ruochen;  # 上面名字是啥，这里就是啥
    	}
    	
    	# 请求的路径中以static开头，就匹配下列地址
    	location /static {
    		# 指定静态文件存放的目录
    		alias 目录 例如： /var/xxx/static;
    	}
    	
    	# 等号为精确匹配
    	location = / {
    		# 传递请求给静态文件服务器上的nginx
    		proxy_pass http://ip;
    	}
	}
}

最后，欢迎大家关注我的个人微信公众号 『小小猿若尘』，获取更多IT技术、干货知识、热点资讯

本文转载自: 掘金

开发者博客 – 和开发相关的 这里全都有

0%