Django|Django+uwsgi+Nginx项目部署

项目部署: 这里用的是非常干净的ubuntu 16.04系统环境,没有使用任何云服务器,原因是因为不同的云服务器环境都不一样。我们就从零开始来完成部署。
在开发机上的准备工作:

  1. 确认项目没有bug。
  2. pip freeze > requirements.txt将当前环境的包导出到requirements.txt文件中,方便部署的时候安装。
  3. 把dysms_python文件准备好。因为短信验证码的这个包必须通过
  4. 将项目上传到服务器上的/srv目录下。这里以git为例。使用git比其他上传方式(比如使用pycharm)更加的安全,因为git有版本管理的功能,以后如果想要回退到之前的版本,git轻而易举就可以做到。
  5. 在https://git-scm.com/downloads下载Windows版本的客户端。然后双击一顿点击下一步安装即可。
  6. 然后使用码云,在码云上创建一个项目。码云地址:https://gitee.com/
  7. 然后进入到项目中,使用以下命令做代码提交:
# 初始化一个残酷 * git init # 添加远程的仓库地址 * git remote add origin xxx.git # 添加所有的代码到缓存区 * git add . # 将代码提交到本地仓库 * git commit -m 'first commit' # 从码云仓库上拉数据下来 * git pull origin master --allow-unrelated-histories # 将本地仓库中的代码提交到远程服务器的master分支上 * git push origin master

在服务器上的准备工作:
  1. ubuntu开启root用户:
sudo passwd root
然后输入root用户的密码
  1. 为了方便xshell或者CRT连接服务器,建议安装OpenSSH(一般云服务器上都已经安装了):
sudo apt install openssh-server openssh-client service ssh restart

  1. 安装vim:
    sudo apt install vim
  2. 修改一下ubuntu的apt源(云服务器一般都有自己的源,可以不用修改),apt源是用来安装软件的链接:
    先拷贝/etc/apt/sources.list为/etc/apt/sources.list.bak,然后用vi编辑/etc/apt/sources.list,删除sources.list中的其他内容,将下面代码粘贴到文件中。然后保存:
deb-src http://archive.ubuntu.com/ubuntu xenial main restricted deb http://mirrors.aliyun.com/ubuntu/ xenial main restricted deb-src http://mirrors.aliyun.com/ubuntu/ xenial main restricted multiverse universe deb http://mirrors.aliyun.com/ubuntu/ xenial-updates main restricted deb-src http://mirrors.aliyun.com/ubuntu/ xenial-updates main restricted multiverse universe deb http://mirrors.aliyun.com/ubuntu/ xenial universe deb http://mirrors.aliyun.com/ubuntu/ xenial-updates universe deb http://mirrors.aliyun.com/ubuntu/ xenial multiverse deb http://mirrors.aliyun.com/ubuntu/ xenial-updates multiverse deb http://mirrors.aliyun.com/ubuntu/ xenial-backports main restricted universe multiverse deb-src http://mirrors.aliyun.com/ubuntu/ xenial-backports main restricted universe multiverse deb http://archive.canonical.com/ubuntu xenial partner deb-src http://archive.canonical.com/ubuntu xenial partner deb http://mirrors.aliyun.com/ubuntu/ xenial-security main restricted deb-src http://mirrors.aliyun.com/ubuntu/ xenial-security main restricted multiverse universe deb http://mirrors.aliyun.com/ubuntu/ xenial-security universe deb http://mirrors.aliyun.com/ubuntu/ xenial-security multiverse

然后更新源:
sudo apt update
5. 安装MySQL服务器和客户端:
sudo apt install mysql-server mysql-client
6. 安装memcached:
通过命令apt install memcached即可安装。更多的memcached的知识点请参考memcached那一章节。
  1. 安装好项目要用到的Python:
* sudo apt install python3 * sudo apt install python3-pip * pip install --upgrade pip

如果系统上已经有Python3了,就无需再安装了。因为supervisor不支持Python3,所以还需要安装Python2,如果没有,就安装一下:
* sudo apt install python2.7 * sudo apt install python-pip

然后输入python2.7即可使用了。
如果在输入pip的时候提示以下错误:
Traceback (most recent call last): File "/usr/bin/pip", line 9, in from pip import main ImportError: cannot import name main

这是因为pip 10的一个bug,可以零时使用以下解决方案:
将/usr/bin/pip中的:
from pip import main if __name__ == '__main__': sys.exit(main())

改成:
from pip import __main__ if __name__ == '__main__': sys.exit(__main__._main())

  1. 安装virtualenvwrapper,并创建好项目要用到的虚拟环境:
* pip install virtualenvwrapper

安装完virtualenvwrapper后,还需要配置virtualenvwrapper的环境变量。
  • 首先通过which virtualenvwrapper.sh命令查看virtualenvwrapper.sh文件所在的路径。
  • 在当前用户目录下创建.virtualenv文件夹,用来存放所有的虚拟环境目录。
  • 在当前用户目录下编辑.bashrc文件,添加以下代码:
export WORKON_HOME=$HOME/.virtualenvs source /usr/local/bin/virtualenvwrapper.sh

然后退出bashrc文件,输入命令source ~/.bashrc
注意:因为我们是把virtualenvwrapper安装在了python2的环境中,所以在创建虚拟环境的时候需要使用–python参数指定使用哪个Python文件。比如我的python3的路径是在/usr/bin/python3。那么示例代码如下:
mkvirtualenv --python=/usr/bin/python3 xfz-env
9. 安装git:
sudo apt install git
10. 使用git下载项目代码:
* git init * git remote add origin https://gitee.com/hynever/xfz_beike * git pull origin master

  1. 进入虚拟环境中,然后进入到项目所在的目录,执行命令:pip install -r requirements.txt,安装项目依赖的包。如果提示OSError: mysql_config not found,那么再安装sudo apt install libmysqld-dev即可。
    注意短信验证码的包需要单独安装。把dysms_python文件夹上传到项目中,然后进入到这个文件夹中。执行命令:python setup.py install
  2. 进入mysql数据库中,创建好项目的数据库。
  3. 执行python manage.py makemigrations/migrate将模型映射到数据库中。
  4. 执行python manage.py runserver 0.0.0.0:8000,然后在自己电脑上访问这个网站,确保没有BUG。
  5. 在settings.py中的ALLOWED_HOST添加网站的域名或者ip地址。
  6. 设置DEBUG=False,避免如果你的网站产生错误,而将错误信息暴漏给用户。
  7. 在settings.py中配置STATIC_ROOT,用来存储收集的静态文件。收集静态文件的命令如下:
    python manage.py collectstatic
安装uwsgi: uwsgi是一个应用服务器,非静态文件的网络请求就必须通过他完成,他也可以充当静态文件服务器,但不是他的强项。uwsgi是使用python编写的,因此通过pip3 install uwsgi就可以了。(uwsgi必须安装在系统级别的Python环境中,不要安装到虚拟环境中)。然后创建一个叫做uwsgi.ini的配置文件:
[uwsgi] # 必须全部为绝对路径 # 项目的路径 chdir= /srv/beike/xfz # Django的wsgi文件 module= xfz.wsgi # Python虚拟环境的路径 home= /root/.virtualenvs/xfz-env# 进程相关的设置 # 主进程 master= true # 最大数量的工作进程 processes= 10http= :8000# 设置socket的权限 chmod-socket= 666 # 退出的时候是否清理环境 vacuum= truedaemonize= /var/log/xfz_uwsgi.log 然后通过命令uwsgi --ini uwsgi.ini运行,确保没有错误。然后在浏览器中访问http://ip地址:8000,如果能够访问到页面(可能没有静态文件)说明uwsgi配置没有问题。

安装和配置nginx: 虽然uwsgi可以正常的部署我们的项目了。但我们还是依然要采用nginx来作为web服务器。使用nginx来作为web服务器有以下好处:
  1. uwsgi对静态文件资源处理并不好,包括响应速度,缓存等。
  2. nginx作为专业的web服务器,暴露在公网上会比uwsgi更加安全一点。
  3. 运维起来更加方便。比如要将某些IP写入黑名单,nginx可以非常方便的写进去。而uwsgi可能还要写一大段代码才能实现。
安装: 通过apt install nginx即可安装。
nginx简单操作命令: 启动:service nginx start
关闭:service nginx stop
重启:service nginx restart
测试配置文件:service nginx configtest
添加配置文件:
在/etc/nginx/conf.d目录下,新建一个文件,叫做zhiliaoketang.conf,然后将以下代码粘贴进去:upstream zhiliaoketang { server unix:///srv/zhiliaoketang/zhiliaoketang.sock; }# 配置服务器 server { # 监听的端口号 listen80; # 域名 server_name 192.168.0.101; charsetutf-8; # 最大的文件上传尺寸 client_max_body_size 75M; # 静态文件访问的url location /static { # 静态文件地址 alias /srv/zhiliaoketang/static_dist; }# 最后,发送所有非静态文件请求到django服务器 location / { uwsgi_passzhiliaoketang; # uwsgi_params文件地址 include/etc/nginx/uwsgi_params; } }

写完配置文件后,为了测试配置文件是否设置成功,运行命令:service nginx configtest,如果不报错,说明成功。
每次修改完了配置文件,都要记得运行service nginx restart。
使用supervisor管理uwsgi进程: 让supervisor管理uwsgi,可以在uwsgi发生意外的情况下,会自动的重启。
安装supervisor: 【Django|Django+uwsgi+Nginx项目部署】因为supervisor是用python写成的,所以通过pip即可安装。
并且因为supervisor不支持python3,因此需要把supervisor安装在python2的环境中。
pip2 install supervisor。
启动: 在项目的根目录下创建一个文件叫做supervisor.conf,然后将以下代码填入到配置文件中:
# supervisor的程序名字 [program:mysite] # supervisor执行的命令 command=uwsgi --ini zlkt_uwsgi.ini # 项目的目录 directory = /srv/zhiliaoketang # 开始的时候等待多少秒 startsecs=0 # 停止的时候等待多少秒 stopwaitsecs=0 # 自动开始 autostart=true # 程序挂了后自动重启 autorestart=true # 输出的log文件 stdout_logfile=/srv/zhiliaoketang/log/supervisord.log # 输出的错误文件 stderr_logfile=/srv/zhiliaoketang/log/supervisord.err[supervisord] # log的级别 loglevel=debug[inet_http_server] # supervisor的服务器 port = :9001 # 用户名和密码 username = admin password = 123# 使用supervisorctl的配置 [supervisorctl] # 使用supervisorctl登录的地址和端口号 serverurl = http://127.0.0.1:9001# 登录supervisorctl的用户名和密码 username = admin password = 123[rpcinterface:supervisor] supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

然后使用命令supervisord -c supervisor.conf运行就可以了。
以后如果想要启动uwsgi,就可以通过命令supervisorctl -c supervisor.conf进入到管理控制台,然后可以执行相关的命令进行管理:
status # 查看状态
start program_name #启动程序
restart program_name #重新启动程序
stop program_name # 关闭程序
reload # 重新加载配置文件
quit # 退出控制台

    推荐阅读