Django项目部署
项目部署:
这里用的是非常干净的ubuntu 16.04
系统环境,没有使用任何云服务器,原因是因为不同的云服务器环境都不一样。我们就从零开始来完成部署。
在开发机上的准备工作:
- 确认项目没有bug。
- 用
pip freeze > requirements.txt
将当前环境的包导出到requirements.txt
文件中,方便部署的时候安装。 - 一些非pip安装的包,例如阿里云短信服务,把
dysms_python
文件准备好。因为短信验证码的这个包必须通过 - 将项目上传到服务器上的
/srv
目录下。这里以git
为例。使用git
比其他上传方式(比如使用pycharm)更加的安全,因为git
有版本管理的功能,以后如果想要回退到之前的版本,git
轻而易举就可以做到。 - 在
https://git-scm.com/downloads
下载Windows
版本的客户端。然后双击一顿点击下一步安装即可。 - 然后使用码云或coding.net,在码云上创建一个项目。码云地址:https://gitee.com/
- 然后进入到项目中,使用以下命令做代码提交:
# 初始化一个残酷 * 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用户的密码
2. 为了方便xshell
或者CRT
连接服务器,建议安装OpenSSH
(一般云服务器上都已经安装了):
sudo apt install openssh-server openssh-client service ssh restart
3. 安装vim
:
sudo apt install vim
4. 修改一下ubuntu
的apt
源(云服务器一般都有自己的源,可以不用修改),apt
源是用来安装软件的链接:先拷贝/etc/apt/sources.list
为/etc/apt/sources.list.bak
,然后用vim
编辑/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
7. 安装好项目要用到的Python,如果系统上已经有Python3
了,就无需再安装了:
Python3
了,就无需再安装了:sudo apt install python3 sudo apt install python3-pip pip install --upgrade pip
因为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())
8. 安装virtualenvwrapper
,并创建好项目要用到的虚拟环境:
sudo easy_install virtualenvwrapper
创建目录用来存放虚拟环境
mkdir ~/python3_env
在当前用户目录下编辑.bashrc
文件,添加以下代码:
export WORKON_HOME=$HOME/python3_env source /usr/local/bin/virtualenvwrapper.sh
然后退出bashrc
文件,输入命令
source ~/.bashrc
创建一个虚拟环境:
mkvirtualenv --python=/usr/bin/python3 xfz-env
如果出现:ERROR: virtualenvwrapper could not find virtualenv in your path, 请安装 virtualenv
sudo pip install virtualenv
9. 安装git
:
sudo apt install git
10. 使用git
下载项目代码:
git init git remote add origin https://你的git项目地址 git pull origin master
11. 进入虚拟环境中,然后进入到项目所在的目录,执行命令:
pip install -r requirements.txt
如果提示OSError: mysql_config not found
,那么再安装sudo apt install libmysqld-dev
即可。
sudo apt install libmysqld-dev
注意短信验证码的包需要单独安装。把dysms_python
文件夹上传到项目中,然后进入到这个文件夹中。执行命令:python setup.py install
。
12. 进入mysql
数据库中,创建好项目的数据库。
13. 执行python manage.py makemigrations/migrate
将模型映射到数据库中。
14. 在settings.py
中的ALLOWED_HOST
添加网站的域名或者ip
地址。
15. 设置DEBUG=False
,避免如果你的网站产生错误,而将错误信息暴漏给用户。
16. 在settings.py
中配置STATIC_ROOT
,用来存储收集的静态文件。收集静态文件的命令如下:
17. 执行python manage.py runserver 0.0.0.0:8000
,然后在自己电脑上访问这个网站,确保没有BUG。
# setting.py中加入 STATIC_ROOT = os.path.join(BASE_DIR,'static_dist')
执行:
python manage.py collectstatic
安装uwsgi:
uwsgi是一个应用服务器,非静态文件的网络请求就必须通过他完成,他也可以充当静态文件服务器,但不是他的强项。uwsgi是使用python编写的,因此通过pip3 install uwsgi
就可以了。
(uwsgi必须安装在系统级别的Python环境中,不要安装到虚拟环境中)
# 退出虚拟环境 deactivate # 安装uwsgi sudo pip3 install uwsgi
在项目根文件下,新建文件: uwsgi.ini 然后写入一下内容:
建议在开发机上配置好:git到服务器
[uwsgi]
# 必须全部为绝对路径
# 项目的路径
chdir = /srv/xfz
# Django的wsgi文件
module = xfz.wsgi
# Python虚拟环境的路径
home = /root/.virtualenvs/xfz-env
# 进程相关的设置
# 主进程
master = true
# 最大数量的工作进程
processes = 10
# http = :8000
socket = /srv/xfz/xfz.sock
# 设置socket的权限
chmod-socket = 666
# 退出的时候是否清理环境
vacuum = true
# 输出日志,如果使用了supervisor,请关闭
# daemonize = /var/log/xfz_uwsgi.log
然后通过命令运行,确保没有错误。然后在浏览器中访问http://ip地址:8000
,如果能够访问到页面(可能没有静态文件)说明uwsgi
配置没有问题。
uwsgi --ini uwsgi.ini
安装和配置nginx:
虽然uwsgi
可以正常的部署我们的项目了。但我们还是依然要采用nginx
来作为web服务器。使用nginx
来作为web服务器有以下好处:
- uwsgi对静态文件资源处理并不好,包括响应速度,缓存等。
- nginx作为专业的web服务器,暴露在公网上会比uwsgi更加安全一点。
- 运维起来更加方便。比如要将某些IP写入黑名单,nginx可以非常方便的写进去。而uwsgi可能还要写一大段代码才能实现。
安装:
通过
apt install nginx
即可安装。
nginx简单操作命令:
- 启动:service nginx start
- 关闭:service nginx stop
- 重启:service nginx restart
- 测试配置文件:service nginx configtest
添加配置文件:
在/etc/nginx/conf.d
目录下,新建一个文件,叫做xfz.conf
,然后将以下代码粘贴进去:
upstream xfz{ server unix:///srv/xfz/xfz.sock; } # 配置服务器 server { # 监听的端口号 listen 80; # 域名 server_name 192.168.0.101; charset utf-8; # 最大的文件上传尺寸 client_max_body_size 75M; # 静态文件访问的url location /static { # 静态文件地址 alias /srv/xfz/static_dist; } # 最后,发送所有非静态文件请求到django服务器 location / { uwsgi_pass xfz; # uwsgi_params文件地址 include /etc/nginx/uwsgi_params; } }
写完配置文件后,为了测试配置文件是否设置成功,运行命令:service nginx configtest
,如果不报错,说明成功。
service nginx configtest
每次修改完了配置文件,都要记得运行service nginx restart
。
service nginx restart
因为使用了sock进行nginx和uwsgi通讯,所以在uwsgi的配置中也要更改成如下:
# http = :8000 socket = /srv/xfz/xfz.sock
修改完成后,重启uwsgi。
使用supervisor管理uwsgi
进程:
让supervisor管理uwsgi,可以在uwsgi发生意外的情况下,会自动的重启。
安装supervisor:
因为supervisor
是用python
写成的,所以通过pip
即可安装。
并且因为supervisor
不支持python3
,因此需要把supervisor
安装在python2
的环境中。
pip2 install supervisor。
启动:
在项目的根目录下创建一个文件叫做supervisor.conf
,然后将以下代码填入到配置文件中:
建议在开发机上配置好:git到服务器
# supervisor的程序名字
[program:xfz]
# supervisor执行的命令
command=uwsgi --ini uwsgi.ini
# 项目的目录
directory = /srv/xfz
# 开始的时候等待多少秒
startsecs=0
# 停止的时候等待多少秒
stopwaitsecs=0
# 自动开始
autostart=true
# 程序挂了后自动重启
autorestart=true
# 输出的log文件
stdout_logfile=/var/log/supervisord.log
# 输出的错误文件
stderr_logfile=/var/log/supervisord.err
[supervisord]
# log的级别
loglevel=debug
[inet_http_server]
# supervisor的服务器
port = :9001
# 用户名和密码
username = admin
password = ken8922
# 使用supervisorctl的配置
[supervisorctl]
# 使用supervisorctl登录的地址和端口号
serverurl = http://127.0.0.1:9001
# 登录supervisorctl的用户名和密码
username = admin
password = ken8922
[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 # 退出控制台