百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术资源 > 正文

Nginx + Uwsgi + Django部署详细流程

off999 2024-09-27 13:44 28 浏览 0 评论

主要介绍标题中写明的项目部署流程,以及解决部署过程中可能遇到的一些问题,在开始之前,墙裂推荐这篇文档:

Setting up Django and your web server with uWSGI and nginx

看完这篇文档,你可能已经能够解决90%(甚至100%)的问题了,剩下10%的问题(我所遇到的)将穿插在我部署的过程中进行解决。

(第一次部署的过程十分粗糙,遇到的很多问题都没有妥善记录下来,现在另起一个比较干净的服务器,重新部署一下,好把之前的坑过一遍,另外对配置进行一些优化)

如果按照本文流程,仍然配置不成功的话,请按照以下几点排除问题:

  1. 检查服务器端口配置
  2. 检查配置文件是否正确
  3. 检查部署过程中各个项目的版本是否和本文一致(版本更新后可能导致配置变化)
  4. 检查防火墙(我配置时没有遇到这个问题)
  5. google…
  6. 欢迎留言,一起解决问题~

环境

阿里云: Ubuntu 14.04 64位

本机:windows10

python:3.6.6

工具

IDE:Pycharm(代码部署功能比较好用)

文件图形化客户端:WinSCP(查看服务器文件结构)

virtualbox虚拟机(这个其实无所谓,只是觉得开个虚拟机直连服务器比较舒服一点)

预配置

申请一个阿里云服务器

获取服务器实例

获取IP

配置安全组([配置放行端口](

))

连接服务器

连接服务器的方法很多,不一一赘述了,我比较喜欢在Ubuntu系统下使用ssh直连

安装ssh

sudo apt-get install ssh

连接目标服务器

ssh root@xx.xx.xxx.xxx

xxx部分为服务器的公网IP地址,root为用户名(不推荐使用root账户进行后续部署操作)

配置用户

给服务器系统添加自定义用户,后面的操作都在该用户下(本文中添加并使用账户名为breavo,账户名可任意取)

sudo adduser breavo

详细过程可以自行google:)

(创建用户后请务必添加sudo权限,避免后续出现权限问题)

使用pyenv管理python版本

由于各个项目之间存在python的版本问题,而服务器中自带的python2(现在也自带python3了,但是版本可能不符合需求)是远远无法满足需求的,导致的结果就是你的服务器中安装了多个python版本,每个项目依赖不同的版本运行。那么管理的必要性是不言而喻的了,另外每个项目需要一个独立的运行环境(项目依赖需要分开管理,否则会变成噩梦),这一点通过创建虚拟环境来解决。

下载pyenv

首先对系统环境进行一下更新,确保后面的操作不会因为缺少某个工具导致失败

sudo apt-get update

安装curl,git

sudo apt-get install curl git-core

安装pyenv

Bash
curl -L https://raw.github.com/yyuu/pyenv-installer/master/bin/pyenv-installer | bash
1

这个命令会把pyenv安装到当前用户的~/.pyenv目录下.(本文中为/home/breavo/.pyenv)

同样,在用户目录下找到.bashrc文件,将下面的代码添加至文件内容末尾(本文中bashrc文件路径在/home/breavo下,可自行对应到自己的路径)

Bash
export PYENV_ROOT="${HOME}/.pyenv"
if [ -d "${PYENV_ROOT}" ]; then
 export PATH="${PYENV_ROOT}/bin:${PATH}"
 eval "$(pyenv init -)"
fi
1
2
3
4
5
6

修改后保存~

这段代码的作用主要是指明pyenv的位置,以便以后可以直接在命令行里面运行pyenv命令。 保存在~/.bashrc 文件中是为了每次用户登陆后自动生效。

所以如果你是第一次运行命令并且没有注销的话, 这一段是不会生效的, 我们还需要运行下面的命令令其生效

Bash
source ~/.bashrc
1

然后就可以直接在命令行里面敲pyenv了。

安装pyenv参考文章:点击这里

Python安装

pyenv安装完了,接下来安装我们需要的python版本,首先查看一下目前python有哪些版本可以安装

Bash
pyenv install --list
1

会打印一串很长的列表,网上滑一滑,可以看下如下图所示。


我们就安装图中画圈的这个版本

pyenv install 3.6.6 -v

(注:这里install的时候最好加一个 -v,否则安装过程信息是不会打印在控制台的,看上去就好像安装进度卡住了一样,首次安装可能会引起疑惑)


安装失败 = =,原因是一些依赖还没有装上

Bash
sudo apt-get install make build-essential libssl-dev zlib1g-dev
sudo apt-get install libbz2-dev libreadline-dev libsqlite3-dev wget
sudo apt-get install llvm libncurses5-dev libncursesw5-dev
1
2
3

依赖安装完毕之后,再次pyenv install 3.6.6 -v

顺利完成~

注:到这一步为止有一个坑,很多人喜欢安装最新的版本(python 3.7.0+),在依赖全部安装完毕的情况下,依旧会出现下图提示。


问题是Open SSL已经安装过了(就是这个libssl-dev),当时排查这个问题排查了很久,到最后,发现是因为没有配置的情况下,本地的OpenSSL根本没有支持到python3.7.0+

pyenv builds/installs openssl into a sub-directory of a new installation prefix, but Python is not configured to use it. Without ./configure --with-openssl=${somewhere} it will favor the system’s OpenSSL. In the case of Darwin, this always fails because the version of OpenSSL is no longer supported (Python >=3.7.0).

问题链接:Python 3.7.0 :: The Python ssl extension was not compiled. Missing the OpenSSL lib?

前面排查的时候根本没往那方面想,结果悲剧了,浪费了很多时间 = =~

pyenv基本操作

安装完成,查看一下

Bash
pyenv versions
1

发现python3.6.6已经安装进系统了~

切换系统默认python环境

Bash
pyenv global 3.6.6
1

当前系统默认python版本已经变成3.6.6了,可以输入python命令check一下

卸载某个python版本

Bash
pyenv uninstall x.x.x
1

另外pyenv还有各种其他命令行操作,可自行google了解~

重新打开远程SSH窗口可能会遇到pyenv command not found问题,重新source一下.bashrc文件

或者

查看解决方案:戳这里

配置虚拟环境

准备

开始配置之前,不妨阅读一下pyenv-virtualenv ReadMe

(可选 + 推荐)自动激活虚拟环境

通过pyenv安装完成后,连带着virtualenv也安装完成了,我们可以通过pyenv命令完成虚拟环境的配置

在 pyenv-virtualenv中,由于需要从根本上处理一些已知的问题(关于$PATH和shell提示符),activate/deactivate提示符将会在未来的版本中移除(目前依然可以使用,但是会弹出warning,我是觉得不爽啦~)

问题链接:Question regarding prompt changing

根据作者的建议,我们可以如下方式完成虚拟环境的配置和激活

运行

$ echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bash_profile

重启一下shell

Bash
$ exec "$SHELL"
1

运行

pyenv virtualenv 3.6.6 eshop

其中3.6.6是需要指定的python版本, eshop是虚拟环境的名称(随便起的~)

此时,虚拟环境已经创建完成并自动激活,可以通过pyenv versions查看,如下图所示。


通过 pyenv shell xxx(xxx为python版本号或者虚拟环境名称)切换环境,效果如下图


原有的激活方式

运行

pyenv virtualenv 3.6.6 eshop

激活/反激活虚拟环境

pyenv activate eshop

pyenv deactivate

最后

卸载虚拟环境

pyenv uninstall

至此,虚拟环境的搭建就算完成了~

Nginx基本配置

Bash
sudo apt-get install nginx
1

运行

Bash
sudo /etc/init.d/nginx start # start nginx
1

如果出现sudo: unable to resolve host问题,参考这里

如果出现端口占用情况,通过修改配置文件换用其他端口(如8000)

如果出现端口没被占用但无法访问,请回到配置安全组出查看端口策略是否配置完备

打开浏览器访问 xx.xx.xxx.xxx:80,其中xxxx是你的公网IP,80是Nginx默认监听的端口号

出现


这个表示Nginx已经成功安装并运行起来了

(可选)服务端配置数据库

本文以postgresql为例进行安装配置

基本配置

参考文章:Ubuntu 安装和配置postgresql

安装postgresql

sudo apt-get install postgresql

安装完成后服务器系统会自动创建一个名为postgres的账户(数据库超级用户),密码为空

切换到postgres

Bash
sudo su postgres
1

登陆postgresql

Bash
psql postgres
1

在postgresql界面继续输入如下命令(注意末尾加分号)

Bash
ALTER USER postgres with PASSWORD 'postgres';
1

修改成功后输入’\q’ 退出postgresql

退出postgres账户可以直接输入exit后回车或者ctrl + d

上述流程正确的情况下如下图所示。


远程登陆

编辑pgsql配置文件,运行

vim /etc/postgresql/9.1/main/postgresql.conf

或者利用WinSCP界面进行编辑(本篇文章中所有配置文件编辑均使用WinSCP + sublime,个人喜好)

修改配置文件如下:

监听任何地址访问,修改连接权限

Bash
# listen_addresses = ‘localhost’
改为 
listen_addresses = ‘*’
1
2
3

启用密码验证

Bash
# password_encryption = on 
改为 
password_encryption = on
1
2
3

编辑 /etc/postgresql/9.1/main/pg_hba.conf,在文件末尾添加

Bash
# to allow your client visiting postgresql server
host all all 0.0.0.0 0.0.0.0 md5
1
2

保存上述修改

最后,重启数据库

sudo service postgresql restart


至此,数据库配置完成了

可以通过登陆测试一下,直接登陆或者使用PgAdmin都可以,不再赘述

Django项目代码上传

上传

前面配置了这么多,Django项目还没有上传到服务器呢,确保本地有一个可运行Django项目(废话:P)

上传方式很多

  1. 通过WinSCP直接上传(左边拖到右边,完成~)
  2. 通过pycharm进行代码部署(推荐)
  3. 其他

新建的用户可能会遇到上传的权限问题,解决方法戳Permissions on /var/www/html for uploading web site files via SFTP

查看用户xxx所在组以及组内成员

groups xxx

更改文件上传目录的用户和用户组

sudo chown breavo:breavo /file/upload/path

为用户组添加写权限

sudo chmod -R 775 /file/upload/path

项目试运行

设置django settings.py

Bash
ALLOWED_HOSTS = ['*']
1

安装项目依赖(依赖写入requirements.txt中,每个依赖注意添加版本号)

cd 到你存放requirement.txt的目录, 运行

pip install -r requirements.txt

等待依赖安装完成,cd到项目目录下,运行

python manage.py runserver 0.0.0.0:8000

打开浏览器输入服务器地址,查看

xx.xx.xxx.xxx:8000 (xxx为服务器公网IP地址)

项目正常运行~(如果settings.py文件中的DEBUG设置为False,会观察到静态资源无法加载)

Nginx代理

在项目中配置Nginx

在项目目录下添加一个config文件夹,后面的配置文件都统一放到该文件夹下(配置文件存放路径不统一会导致输入提示符时运行不成功)

config文件下新建mysite_nginx.conf文件,内容如下(将路径替换成你自己的项目路径或者对应文件):

Bash
# mysite_nginx.conf
# the upstream component nginx needs to connect to
upstream django {
 # unix:///home/breavo/PyWorkSpace/mysite_code_shuffle/config/eshop.sock
 # server unix:///path/to/your/mysite/mysite.sock; # for a file socket
 server 127.0.0.1:8001; # for a web port socket (we'll use this first)
}
# configuration of the server
server {
 # the port your site will be served on
 listen 8000;
 # the domain name it will serve for
 server_name xx.xx.xxx.xxx; # substitute your machine's IP address or FQDN
 charset utf-8;
 # max upload size
 client_max_body_size 75M; # adjust to taste
 # Django media
 location /media {
 # /home/breavo/PyWorkSpace/mysite_code_shuffle/meida;
 alias /path/to/your/mysite/media; # your Django project's media files - amend as required
 }
 location /static {
 # /home/breavo/PyWorkSpace/mysite_code_shuffle/static
 alias /path/to/your/mysite/static; # your Django project's static files - amend as required
 }
 # Finally, send all non-media requests to the Django server.
 location / {
 uwsgi_pass django;
 include /home/breavo/PyWorkSpace/mysite_code_shuffle/config/uwsgi_params; # the uwsgi_params file you installed
 }
}
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
33
34
35
36
37

在/etc/nginx/sites-enabled中创建一个链接,这样Nginx能够发现并启用我们的配置,运行

Bash
sudo ln -s ~/path/to/your/mysite/mysite_nginx.conf /etc/nginx/sites-enabled/
1

部署静态文件

在运行Nginx之前,需要将django项目中的所有静态文件放入static文件夹,在mysite/settings.py中添加

Bash
STATIC_ROOT = os.path.join(BASE_DIR, "static/")
1

然后运行

Bash
python manage.py collectstatic
1

启动(重启)Nginx

Bash
sudo /etc/init.d/nginx start
1

简单测试

往服务器项目的media文件夹里丢一个图片(这里以test.png为例)


访问

Bash
xx.xx.xxx.xxx:8000/media/test.png
1



图片正确显示~

至此,静态文件部署算是完成了

Uwsgi安装及配置

接下来我们需要使用Uwsgi来处理项目中的动态请求

基本配置

虚拟环境下运行

pip install uwsgi

在之前创建的config文件夹下新建一个hello.py用来做测试,写入以下内容

Bash
# test.py
def application(env, start_response):
 start_response('200 OK', [('Content-Type','text/html')])
 return [b"Hello World"] # python3
 #return ["Hello World"] # python2
1
2
3
4
5

接下来运行

uwsgi --http :8001 --wsgi-file test.py

打开浏览器查看


出现上图,说明Uwsgi已经初步运行成功

运行项目

上述步骤没有出问题的话,我们就可以使用Uwsgi启动项目了,项目根目录下运行

uwsgi --http :8001 --module mysite.wsgi

其中mysite.wsgi(mysite替换成自己的项目名称)会自动搜索项目中的wsgi.py文件

如果正常运行~恭喜

如果浏览器出现Internal Server Error

  1. 检查命令提示符是否输入正确
  2. 检查是否项目根目录下运行
  3. 其他情况,查看命令行输出或者log

至此Uwsgi基本配置算是完成了~~

Nginx + Uwsgi + django

Nginx访问hello.py

现在我们使用socket通信来通过Nginx访问hello.py,(确保Nginx已经启动)config文件夹下运行

uwsgi --socket :8001 --wsgi-file hello.py

好了,就这么现在访问浏览器

xx.xx.xxx.xxx:8000


成功访问~

其中8000是Nginx监听的端口(mysite_nginx.conf文件中配置),–socket :8001是用于socket通信的端口(两个端口都可以替换~)

使用Unix sockets替换端口

编辑mysite_nginx.conf文件,将原来内容修改成如下

Bash
server unix:///path/to/your/mysite/mysite.sock; # for a file socket
# server 127.0.0.1:8001; # for a web port socket (we'll use this first)
1
2

保存后,config文件夹下运行

uwsgi --socket mysite.sock --wsgi-file hello.py

依旧打开浏览器访问xx.xx.xxx.xxx:8000,屏幕出现hello world,说明一切正常

如果出现502 Bad Getway

查看你的Nginx error log(/var/log/nginx/error.log)

如果出现

Bash
connect() to unix:///path/to/your/mysite/mysite.sock failed (13: Permission
denied)
1
2

则说明是权限问题,运行

uwsgi --socket mysite.sock --wsgi-file hello.py --chmod-socket=666

或者

uwsgi --socket mysite.sock --wsgi-file hello.py --chmod-socket=664 (推荐,但是我用了没成功)

log如果打印了其他问题,请仔细检查配置~

使用Nginx + Uwsgi运行项目

Bash
uwsgi --socket mysite.sock --module mysite.wsgi --chmod-socket=664
1

注意这里有个小坑,mysite_nginx.conf中我配置的mysite.sock在config文件夹下,而这条命令需要在项目根目录下运行,这里可以:

  1. 修改mysite_nginx.conf下sock文件路径到根目录下
  2. 使用配置文件启动(推荐)
编辑配置文件

config文件夹下新建mysite_uwsgi.ini,输入以下内容

Bash
# mysite_uwsgi.ini file
[uwsgi]
# Django-related settings
# the base directory (full path)
chdir = /path/to/your/project
# Django's wsgi file
module = project.wsgi
# the virtualenv (full path)
home = /path/to/virtualenv
# process-related settings
# master
master = true
# maximum number of worker processes
processes = 10
# the socket (use the full path to be safe
socket = /path/to/your/project/mysite.sock
# ... with appropriate permissions - may be needed
chmod-socket = 666
# clear environment on exit
vacuum = true
stats = %(chdir)/config/uwsgi.status 
pidfile = %(chdir)/config/uwsgi.pid
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

用自己的路径替换其中对应的配置~

保存后,运行(确保在mysite_uwsgi.ini目录下)

uwsgi --ini mysite_uwsgi.ini

打开浏览器访问xx.xx.xxx.xxx:8000

项目这时候应该完美运行了~~

大功告成~:)

最后

重新一步一步的部署了一遍之后,强迫症终于舒服了~~文章中还是有很多地方不(没)够(有)完(写)善(全),后面有时间继续补一补~:)

相关推荐

Modbus RTU 指令基本功能介绍(modbus-rtu)

ModbusRTU协议概述:入门级知识点ModbusRTU协议,是工业自动化领域应用广泛的串行通信协议。它简单、可靠,在各种工业设备之间建立通信桥梁,实现数据的采集和控制。ModbusRTU...

AIOT开发选型:行空板 K10 与 M10 适用场景与选型深度解析

前言随着人工智能和物联网技术的飞速发展,越来越多的开发者、学生和爱好者投身于创意项目的构建。在众多的开发板中,行空板K10和M10以其独特的优势脱颖而出。本文旨在为读者提供一份详尽的行空板K...

程序员花了1个月时间,手搓低成本机械臂:跟着他你也能复刻一台

在开源硬件的广阔天地中,SO-ARM100作为一款备受瞩目的开源机械臂项目脱颖而出。它以标准化的四轴机械臂设计为核心,构建起一个开放共享的技术平台,为机械臂爱好者与开发者提供了绝佳的远程操作实践场域...

RPC接口测试技术-Tcp 协议的接口测试

首先明确Tcp的概念,针对Tcp协议进行接口测试,是指基于Tcp协议的上层协议比如Http,串口,网口,Socket等。这些协议与Http测试方法类似(具体查看接口自动化测试章...

同事开玩笑说:你这个python程序要是外流出去了,可能会有危险

引言公司因为业务原因,购入了一些高灵敏高精度的振动传感器。老板说:“拿去进行测试,看看数据如何?”吭哧吭哧接入数据,一看,确实精度和灵敏度非常高。具体多高呢?将传感器固定在相关的结构物上,在办公室中人...

STM32搭建简易环境监测站并通过网络实时上报

一、系统总体架构本系统以STM32F407为核心,搭建一个环境监测节点,能够采集温湿度、光照、空气质量等数据,并通过OLED屏显示,同时通过ESP8266模块实现局域网数据上报。适合室内空气监测、智慧...

STM32通过NB-IoT模块实现远程告警推送

一、项目概述本系统以STM32F103C8T6作为主控核心,通过串口控制NB-IoT通信模块(移远BC26),实现对外设状态的远程监测和异常自动告警推送(如温度超限、设备震动异常等)。支持通过UDP或...

MicroPython 玩转硬件系列3:上电执行程序

1.引言上一篇:MicroPython玩转硬件系列2:点灯实验我们在ESP32上实现了LED灯的闪烁,但是有一个问题,该功能的实现需要我们在串口终端里去手动执行代码,可不可以让ESP32上电后自动...

打标机与上位机通讯异常如何快速定位?串口工具验证流程拆解

打标机与上位机通信过程中出现的错误问题需要通过串口通信助手验证,主要原因在于串口通信的底层特性以及问题隔离的工程需求。以下是原理说明和验证方法:一、验证原理底层数据透明化串口通信本质上是基于二进制数据...

4G短信猫发送中文短信(Python)(4g短信)

4G短信猫发送中文短信(Python)4G短信猫发送中文短信的方式可以使用TEXT模式或者PDU模式。1.TEXT模式在TEXT模式下发送中文短信的指令序列:AT+CSCS="UCS2...

ESP32如何刷microPython固件(esp32 固件升级)

目录为什么要刷microPython固件固件和工具的获取刷固件的步骤检验是否成功1.为什么要刷固件microPython是由计算机工程师DamienGeorge设计出来的,他的初衷是——用Pyth...

CH9329双头线使用说明(双头线是干什么用的)

目录1.介绍说明2.测试说明3.修改为ASCII模式(CH9328字符模式)常见问题解答:1.介绍说明CH9329双头线是集成了CH9329+CH340芯片的成品线,主要作用是使用主控电脑发送串口指令...

Windows下最简单的ESP8266_ROTS_ESP-IDF环境搭建与腾讯云SDK编译

前言其实也没啥可说的,只是我感觉ESP-IDF对新手来说很不友好,很容易踩坑,尤其是对业余DIY爱好者搭建环境非常困难,即使有官方文档,或者网上的其他文档,但是还是很容易踩坑,多研究,记住两点就行了,...

CPU眼里的:Python 和 C(cpp和python)

“Python跟C语言有什么联系?它们在计算机系统中分别扮演着什么角色?”01提出问题Python可能是当今最热门的编程语言,凭借简洁易读的语法和强大的生态,成为许多新手程序员的首选。然而,作为一门解...

Python在工控领域的应用与优势(python工业控制系统)

前言之前利用Python编写了一些S7系列的PLC调试工具和组态开发,今天就具体讲讲Python在工控领域还有哪些应用与优势。Python在工业控制工控领域的应用逐渐增多,得益于其简洁的语法、丰富的生...

取消回复欢迎 发表评论: