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:// 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!