nginx+django线上部署
(一):背景在线
由于现在工作的需要,我需要使用Python来进行一个网站后台的开发,python之前接触过其语法的学习,基本的东西已经掌握,但是当时自学的时候是学得python3.5,而现在要使用python2.7进行实现,所以,先不管了,大多是一样的,有部分是不一样的,慢慢搞吧.
(二):编程环境搭建
我的网站开发是在ubuntu系统下进行的,我们都知道,ubuntu系统在安装的时候,是自带python2.7的,所以,pyhthon就不用进行安装了.我们还需要安装的有:
- django ‘1.6.0’
- mysql 5.6
- ngix
好了,下面我们就搭建我们的环境.
(1):安装Django
首先我们需要安装的是django,我们直接使用命令进行安装:
sudo apt-get install python-django
安装完成之后,我们来测试一下我们的django的版本.使用下面的命令:
python import django django.get_version()
下面来看一下我的系统的输出:
(2):安装MySQL
Django安装完成之后,接着我们需要安装与他进行合作网站开发的mysql.在ubuntu中安装mysql比较简单,直接使用命令行即可安装,在这里我们使用mysql5.6
sudo apt-get install mysql-server
在安装中间,他会提示你让你输入root用户的密码,这个密码要记住.
安装完成后,我们测试一下打开我们的数据库搂一眼.
mysql -u root -p //回车之后,输入密码
能够进入之后,就表明我们的数据库安装完成了.
(3):安装Django和mysql连接的驱动
当安装完成Django和Mysql之后,如果想要Django能够找到mysql,我们就需要安装一个驱动,这样来安装:
sudo apt-get install python-mysqldb
安装完成之后,就表明我们的变成环境就搭建完成了,现在ngix暂时使用不到,所以我们后面再讲述如何安装ngix.
(三):Hello World
1:新建项目
首先我们需要将工作路径切换到我们希望建工程的目录下:
cd xxxx
然后,在该目录下执行下面的命令:
django-admin startproject HelloWorld
新建app:
python manage.py startapp app名称
这里的HelloWorld就是我们项目的名称.下面我们来看一下新建项目的目录结构.
下面来介绍一下各个目录和文件的作用.
HelloWorld: 项目的容器
manage.py: 命令行工具,用于和Django交互
HelloWorld/init.py:空文件,告诉python,该目录是一个Python包
HelloWorld/setting.py : 对该项目的配置文件
HelloWorld/urls.py : 该项目的url声明
HelloWorld/wsgi.py : 服务器入口
2:运行服务器
当我们的项目新建完成之后,我们就需要测试一下该项目有没有创建成功,也就是能不能运行起来.
python manage.py runserver
3:浏览器运行测试
当我们的服务器启动成功之后,我们就在我们的浏览器中输入http://127.0.0.1:8000
,下面我们来看一下运行成功后的浏览器输出.
如果你的输出是这样的,那么你就成功了.
4:重新部署
当我们修改了代码之后,服务器会自动检测其代码的改变,所以,不需要重新启动服务器了.
nginx:
1. 运行开发服务器测试
cd zqxt # 进入项目 zqxt 目录 python manage.py runserver
2. 安装 nginx 和 需要的包运行开发服务器测试,确保开发服务器下能正常打开网站。
2.1 安装 nginx 等软件
ubuntu / Linux Mint 等,下面简写为 (ubuntu):
sudo apt-get install python-dev nginx
centos安装方法:
sudo yum install epel-release sudo yum install python-devel nginx
2.2 安装 supervisor, 一个专门用来管理进程的工具,我们用它来管理 uwsgi 进程
sudo pip install supervisor
Ubuntu用户 请直接看 3,以下是CentOS 注意事项:
CentOS下,如果不是非常懂 SELinux 和 iptables 的话,为了方便调试,可以先临时关闭它们,如果发现部署了之后出不来结果,可以临时关闭测试一下,这样就知道是不是 SELinux 和 iptables 的问题
CentOS 7 iptables如何使用:http://stackoverflow.com/questions/24756240/
将 SELinux 设置为宽容模式,方便调试:
sudo setenforce 0
防火墙相关的设置:
可以选择临时关闭防火墙 sudo service iptables stop 或者开放一些需要的端口,比如 80 sudo iptables -A INPUT -p tcp -m tcp --dport 80 -j ACCEPT
上面的两条命令,如果是 CentOS 7 用
临时关闭防火墙 sudo systemctl stop firewalld 或者 开放需要的端口 sudo firewall-cmd --zone=public --add-port=80/tcp --permanent sudo firewall-cmd --reload
3. 使用 uwsgi 来部署备注:由于我还没有用 最新版本的 Fedora ,新版 Fedora 需要用 dnf 来安装包,有需求的同学自测,可以参考这里。
安装 uwsgi
sudo pip install uwsgi --upgrade
使用 uwsgi 运行项目
uwsgi --http :8001 --chdir /path/to/project --home=/path/to/env --module project.wsgi
这样就可以跑了,--home 指定virtualenv 路径,如果没有可以去掉。project.wsgi 指的是 project/wsgi.py 文件
如果提示端口已经被占用:
probably another instance of uWSGI is running on the same address (:8002). bind(): Address already in use [core/socket.c line 764]
按照端口进行查询:这时可以把相关的进程 kill 掉:
lsof -i :8002
可以查出:
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME uwsgi 2208 tu 4u IPv4 0x53492abadb5c9659 0t0 TCP *:teradataordbms (LISTEN) uwsgi 2209 tu 4u IPv4 0x53492abadb5c9659 0t0 TCP *:teradataordbms (LISTEN)
这时根据 PID 可以用下面的命令 kill 掉相关程序:
sudo kill -9 2208 2209
按照程序名称查询:
ps aux | grep uwsgi
补充内容:
使用 gunicorn 代替 uwsgi 的方法
sudo pip install gunicorn 在项目目录下运行下面的命令进行测试: gunicorn -w4 -b0.0.0.0:8001 zqxt.wsgi
如果使用了 virtualenv 可以这样-w 表示开启多少个worker,-b 表示要使用的ip和port,我们这里用的是 8001,0.0.0.0代表监控电脑的所有 ip。
/path/to/env/bin/gunicorn --chdir /path/to/project --pythonpath /path/to/env/ -w4 -b0.0.0.0:8017 project.wsgi:application
用 --pythonpath 指定依赖包路径,多个的时候用逗号,隔开,如:'/path/to/lib,/home/tu/lib'
4. 使用supervisor来管理进程
安装 supervisor 软件包
(sudo) pip install supervisor
生成 supervisor 默认配置文件,比如我们放在 /etc/supervisord.conf 路径中:
(sudo) echo_supervisord_conf > /etc/supervisord.conf
打开 supervisor.conf 在最底部添加(每一行前面不要有空格,防止报错):
[program:zqxt] command=/path/to/uwsgi --http :8003 --chdir /path/to/zqxt --module zqxt.wsgi directory=/path/to/zqxt startsecs=0 stopwaitsecs=0 autostart=true autorestart=true
command 中写上对应的命令,这样,就可以用 supervisor 来管理了。
启动 supervisor
(sudo) supervisord -c /etc/supervisord.conf
启动,停止,或重启 supervisor 管理的某个程序 或 所有程序:
(sudo) supervisorctl -c /etc/supervisord.conf restart zqxt
以 uwsgi 为例,上面这样使用一行命令太长了,我们使用 ini 配置文件来搞定,比如项目在 /home/tu/zqxt 这个位置,
(sudo) supervisorctl -c /etc/supervisord.conf [start|stop|restart] [program-name|all]
在其中新建一个 uwsgi.ini 全路径为 /home/tu/zqxt/uwsgi.ini
[uwsgi] socket = /home/tu/zqxt/zqxt.sock chdir = /home/tu/zqxt wsgi-file = zqxt/wsgi.py touch-reload = /home/tu/zqxt/reload processes = 2 threads = 4 chmod-socket = 664 chown-socket = tu:www-data vacuum = true
在项目上新建一个空白的 reload 文件,只要 touch 一下这个文件(touch reload) 项目就会重启。注意上面的 /home/tu/zqxt/zqxt.sock ,一会儿我们把它和 nginx 关联起来。
注意:不建议把 sock 文件放在 /tmp 下,比如 /tmp/xxx.sock (不建议)!有些系统的临时文件是 namespaced 的,进程只能看到自己的临时文件,导致 nginx 找不到 uwsgi 的 socket 文件,访问时显示502,nginx 的 access log 中显示 unix: /tmp/xxx.sock failed (2: No such file or directory),所以部署的时候建议用其它目录来放 socket 文件,比如放在运行nginx用户目录中,也可以专门弄一个目录来存放 sock 文件,比如 /tmp2/
sudo mkdir -p /tmp2/ && sudo chmod 777 /tmp2/ #然后可以用 /tmp2/zqxt.sock 这样的路径了
修改 supervisor 配置文件中的 command 一行:
[program:zqxt] command=/path/to/uwsgi --ini /home/tu/zqxt/uwsgi.ini directory=/path/to/zqxt startsecs=0
然后重启一下 supervisor:
(sudo) supervisorctl -c /etc/supervisord.conf restart zqxt 或者 (sudo) supervisorctl -c /etc/supervisord.conf restart all
5. 配置 Nginx
新建一个网站 zqxt
sudo vim /etc/nginx/sites-available/zqxt.conf
写入以下内容:
server { listen 80; server_name www.ziqiangxuetang.com; charset utf-8; client_max_body_size 75M; location /media { alias /path/to/project/media; } location /static { alias /path/to/project/static; } location / { uwsgi_pass unix:///home/tu/zqxt/zqxt.sock; include /etc/nginx/uwsgi_params; } }
激活网站:
sudo ln -s /etc/nginx/sites-available/zqxt.conf /etc/nginx/sites-enabled/zqxt.conf
|
|
测试配置语法问题
sudo service nginx configtest 或 /path/to/nginx -t
|
|
重启 nginx 服务器:
sudo service nginx configtest 或 /path/to/nginx -t
一些有用的参考教程:
Django 官网部署教程:
https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/gunicorn/
https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/uwsgi/
nginx 与 socket
防火墙:
centos 7 FireWalld: http://stackoverflow.com/questions/24756240/how-can-i-use-iptables-on-centos-7
ubuntu ufw 防火墙:http://wiki.ubuntu.org.cn/Ufw%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97
uwsgi ini 配置文件:http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html#configuring-uwsgi-to-run-with-a-ini-file