Ubuntu环境下部署Django+uwsgi+nginx总结
Posted deaconone
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Ubuntu环境下部署Django+uwsgi+nginx总结相关的知识,希望对你有一定的参考价值。
前言
这是我在搭建Django项目时候的过程,拿来总结记录,以备不时之需。
项目采用nginx+uwsgi的搭配方式。
项目依赖包采用requirements.txt
文件管理的方式。
本地准备工作
-
确认项目能够运行起来,没有
bug
-
将当前环境的包导出
pip freeze > requirements.txt
-
将项目上传到服务器上的
/srv
目录下。这里以git
的形式为例, 打开终端, 依次输入如下命令:$ git init $ git remote add origin xxx.git # 替换成你的项目git地址 $ git add . $ git commit -m ‘first commit‘ $ git pull origin master --allow-unrelated-histories $ git push origin master
部署项目到服务器
安装python
-
安装好项目用到的
python
。$ sudo apt install python $ sudo apt install python-pip $ pip install --upgrade pip
-
安装
virtualenv
以及virutalenvwrapper
,并创建虚拟环境。$ pip install virtualenv $ pip install virtualenvwrapper $ sudo apt install vim
-
编辑文件
~/.bashrc
$ vim ~/.bashrc # 添加如下2行代码 export WORKON_HOME=$HOME/.virtualenvs source /usr/local/bin/virtualenvwrapper.sh # 保存文件,让文件成效 $ source ~/.bashrc
安装git:
$ sudo apt install git
# 为了方便XShell或者CRT连接服务器,建议安装OpenSSH
$ sudo apt install openssh-server openssh-client
$ service ssh restart
安装mysql
$ sudo apt install mysql-server mysql-client
$ sudo apt-get install libmysqld-dev
测试配置
- 安装依赖包,进入虚拟环境
workon ***
,进入项目根目录,执行命令pip install -r requirements.txt
- 创建数据库,新打开一个终端,登录数据库,
mysql -uroot -p
, 创建相应的数据库CREATE DATABASE IF NOT EXISTS my_db default charset utf8mb4;
- 迁移数据,
python manage.py migrate
- 收集静态文件,
python manage.py collectstatic
- 启动服务器,执行
python manage.py runserver 0.0.0.0:8000
,然后在你自己电脑上,在浏览器中输入http://<your server ip>:8000
,访问下网站所有页面,确保所有页面都没有错误。
注意:
- 设置
ALLOW_HOST
为你的域名或ip
地址。 - 设置
DEBUG=False
。
安装uwsgi
uwsgi
是一个应用服务器,非静态文件的网络请求就必须通过他完成,他也可以充当静态文件服务器,但不是他的强项。
uwsgi
是使用python
编写的,因此通过pip install uwsgi
就可以了。(uwsgi
必须安装在系统级别的Python
环境中,不要安装到虚拟环境中)。
-
命令行启动
uwsgi
:$ uwsgi --http :8000 --module test.wsgi --vritualenv=/root/.virtualenvs/django-env-py36
如果能够在浏览器中访问到测试的页面,说明uwsgi可以加载项目了。
-
配置文件方式启动
uwsgi
:在项目的根路径下面,创建一个文件
djangotest.ini
,填写以下代码:[uwsgi] # Django相关的配置 # 必须全部为绝对路径 # 项目的路径 chdir=/srv/djangotest # Django的wsgi文件 module=djangotest.wsgi # Python虚拟环境的路径 home=/root/.virtualenvs/django-env-py36 # 进程相关的设置 # 主进程 master=true # 最大数量的工作进程 processes=10 # socket文件路径,绝对路径 socket=/srv/djangotest/djangotest.sock # 设置socket的权限 chmod-socket=666 # 退出的时候是否清理环境 vacuum=true 然后使用命令uwsgi --ini djangotest.ini,看下是否还能启动这个项目。
安装nginx
nginx
是一个web
服务器。用来加载静态文件和接收http
请求的。
-
通过命令
sudo apt install nginx
即可安装。 -
nginx
常用命令:- 启动nginx:service nginx start
- 关闭nginx:service nginx stop
- 重启nginx:service nginx restart
-
收集静态文件:
静态文件应该让
nginx
来处理,而不是让django
来做。首先确保你的
settings.py
文件中有一个STATIC_ROOT
配置,这个配置应该指定你的静态文件要放在哪个目录下。那么我们可以执行以下命令:
python manage.py collectstatic
来收集所有静态文件(已经执行过请忽略)。 -
编写nginx配置文件,在
/etc/nginx/conf.d
目录下,新建一个文件djangotest.conf
,然后将以下代码贴进去:upstream djangotest { server unix:///srv/djangotest/djangotest.sock; } # 配置服务器 server { # 监听的端口号 listen 80; # 域名 server_name 192.168.0.101; charset utf-8; # 最大的文件上传尺寸 client_max_body_size 75M; # 静态文件访问的url location /static { # 静态文件地址 alias /srv/djangotest/static_dist; } # 最后,发送所有非静态文件请求到django服务器 location / { uwsgi_pass djangotest; # uwsgi_params文件地址 include /etc/nginx/uwsgi_params; } }
-
测试配置文件:
service nginx configtest
。注意:每次修改完配置需要重启nginx
:service nginx restart
使用supervisor
让supervisor管理uwsgi,可以在uwsgi发生意外的情况下,自动重启。
-
安装
supervisor
:在系统级别的python环境下pip install supervisor
。 -
在项目根目录下创建一个文件
my_supervisor.conf
。编写内容:# supervisor的程序名字 [program:mysite] # supervisor执行的命令 command=uwsgi --ini zlkt_uwsgi.ini # 项目的目录 directory = /srv/djangotest # 开始的时候等待多少秒 startsecs=0 # 停止的时候等待多少秒 stopwaitsecs=0 # 自动开始 autostart=true # 程序挂了后自动重启 autorestart=true # 输出的log文件 stdout_logfile=/srv/djangotest/log/supervisord.log # 输出的错误文件 stderr_logfile=/srv/djangotest/log/supervisord.err [supervisord] # log的级别 loglevel=info # 使用supervisorctl的配置 [supervisorctl] # 使用supervisorctl登录的地址和端口号 serverurl = http://127.0.0.1:9001 # 登录supervisorctl的用户名和密码 username = admin password = 123 [inet_http_server] # supervisor的服务器 port = :9001 # 用户名和密码 username = admin password = 123 [rpcinterface:supervisor] supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
-
运行
supervisor
,执行supervisord -c my_supervisor.conf
。 -
进入
supervisor
管理控制台,supervisorctl -c my_supervisor.conf
-
supervisor
管理控制台常用命令# 查看状态 status # 启动程序 start program_name # 重新启动程序 restart program_name # 关闭程序 stop program_name # 重新加载配置文件 reload # 退出控制台 quit
Enjoy your code!
以上是关于Ubuntu环境下部署Django+uwsgi+nginx总结的主要内容,如果未能解决你的问题,请参考以下文章
3.django restframework 项目部署到ubuntu18.04上(安装uwsgi)
[部署开发环境]部署django的生成环境nginx+uwsgi+django
django+nginx+uwsgi的生产环境部署(Ubuntu16.04)
Ubuntu + Django(DRF) + channels(websocket)+NGINX + uwsgi 环境部署