这一篇教程,我们一起来了解如何在CentOS系统中将Django2的Web项目部署到Nginx服务器。
CentOS系统虽然和Ubuntu系统都是Linux系统,但是环境搭建和部署过程还是有一些区别。
整个流程分为几个部分:
- 安装图形桌面与远程登录
- 安装Python3.6及相关库文件
- 安装Django2
- 安装uWSGI
- 安装Nginx
- 配置Nginx
- 使用ini文件启动uWSGI服务器
- 使用supervisor管理uWSGI服务器
接下来,我们就逐一完成这些步骤。
一、安装图形界面
在此之前大家应该先完成CentOS系统的最小化安装。
然后,安装我们需要的图形界面和远程登录功能。
因为远程登录需要图形界面支持,所以从顺序上先进行图形界面的安装,再安装远程登录。
(一)使用Gnome桌面
GNOME桌面比较耗费系统资源,在主机上我们更多是通过命令行进行操作,所以,我比较倾向于使用面向低性能硬件的Xfce桌面。
如果选择使用Xfce桌面,大家可以略过此步骤,直接浏览第(二)部分。
1、安装软件源
执行命令:
yum install epel* -y
2、更新软件包
执行命令:
yum -y upgrade
3、安装桌面支持
执行命令:
yum groupinstall "X Window System" "GNOME Desktop" -y
或者:
yum -y groupinstall "Server with GUI"
4、安装xrdp和vnc
执行命令:
yum install tigervnc-server xrdp -y
5、启动xrdp服务,并且设置为开机启动
执行命令:
systemctl start xrdp
(二)使用Xfce桌面
1、安装软件源
执行命令:
yum install epel* -y
2、更新软件包
执行命令:
yum -y upgrade
3、安装桌面管理器
执行命令:
yum install lightdm -y
4、安装桌面
执行命令:
yum groupinstall xfce -y
5、安装远程服务
执行命令:
yum install tigervnc-server xrdp -y
6、禁用GDM桌面管理器
执行命令:
systemctl disable gdm
7、启用LightDM桌面管理器
执行命令:
systemctl enable lightdm
8、配置Xfce为默认桌面
执行命令:
vim ~/.Xclients
在打开的文件中,写入以下内容:
#!/bin/bash XFCE="$(which xfce4-session 2>/dev/null)" exec "$XFCE"
代码输入完毕,按“ESC”键并键入“:wq
”回车,保存测试文件。
然后,执行命令,增加执行权限:
chmod +x ~/.Xclients
9、启动或重启远程连接服务
执行命令:
systemctl start xrdp
或者:
systemctl restart xrdp
10、设置远程连接为开机启动
执行命令:
systemctl enable xrdp
二、安装Python3.6
CentOS系统自带的是Python2.7.5,可以通过输入“python
”命令打开。
我们安装了Python3.6之后,需要使用命令“python3
”启动Python3.6的Shell。
1、安装相关库文件
执行命令:
yum -y install zlib*
yum -y install gcc
yum -y install gcc-c++
yum -y install openssl
yum -y install openssl-devel
yum -y install libffi-devel
yum -y install sqlite
yum -y install sqlite-devel
yum -y install readline readline-devel
2、安装Python3.6与相关库文件
(一)安装Python3.6
首先,创建一个用于保存下载文件的文件夹,并赋予权限。
执行命令:
mkdir /home/centos/Downloads
cd /home/centos/Downloads
chmod 777 /home/centos/Downloads
然后,下载Python的源码安装包。
下载地址:https://www.python.org/downloads/source/
如果是通过Windows远程登录,可以直接复制系统中下载好的Python源码安装包,粘贴到CentOS系统的文件夹中。
当然,也可以在CentOS系统中通过“wget
”命令进行下载。
执行命令:
wget https://www.python.org/ftp/python/3.6.5/Python-3.6.5.tgz
最后,解压缩软件安装包,进入解压缩后的目录进行安装。
执行命令:
tar xfz Python-3.6.5.tgz
cd Python-3.6.5
./configure --enable-shared --with-ssl=openssl
make && make install
安装完毕后,启动Python3.6。
执行命令:
python3
此时,可能会出现错误。
python3: error while loading shared libraries: libpython3.6m.so.1.0: cannot open shared object file: No such file or directory
产生错误的原因是:配置文件添加了参数“ --enable-shared
”,Python3.6运行时没有加载到文件“libpython3.6m.so.1.0 ”。
实际上我们在执行“make”命令时,已经编译了这个文件,解决问题的方法就是把编译好的文件复制到特定的目录中。
执行命令:
cd /home/centos/Downloads/Python-3.6.5
cp libpython3.6m.so.1.0 /usr/local/lib64/
cp libpython3.6m.so.1.0 /usr/lib/
cp libpython3.6m.so.1.0 /usr/lib64/
(二)安装相关库
我们需要安装 “python36-devel”。
yum -y install python36-devel
如果正常完成安装,可直接跳转到下一部分“安装Django2”。
如果这个库没有在系统默认源中,我们需要先添加一个安装源工具,通过下载rpm文件进行安装。
但是,直接下载rpm文件进行安装有可能会出现错误。
Warning: user mockbuild does not exist. using root
所以,我们需要先安装一个依赖库。
执行命令:
yum install mock -y
useradd -s /sbin/nologin mockbuild
然后,下载“rpmforge”的安装文件。
可以到“http://repoforge.org/use/
”进行下载,或者通过“wget
”命令进行下载。
执行命令:
cd /home/centos/Downloads/
wget http://repository.it4i.cz/mirrors/repoforge/redhat/el7/en/x86_64/rpmforge/RPMS/rpmforge-release-0.5.3-1.el7.rf.x86_64.rpm
下载完成后进行安装。
执行命令:
rpm -ivh rpmforge-release-0.5.3-1.el7.rf.x86_64.rpm
此时,可能会出现“NOKEY”的错误,是因为“yum”安装了旧版本的“GPG keys”造成的,解决办法是导入“gpg”。
执行命令:
rpm --import /etc/pki/rpm-gpg/RPM*
接下来,就可以安装 “python36-devel”了。
可以先通过命令,搜索python3-devel的可用版本。
执行命令:
yum search python3 | grep devel
在搜索结果中可以看到一些关于Python3.X的文件名称,其中有一个为“Python36”。
执行命令:
yum -y install python36-devel
这样就完成了“python36-devel”的安装。
三、安装Django2
Python3.6默认安装后,需要使用命令“pip3”安装第三方库。
先安装Django的依赖库“pytz”。
执行命令:
pip3 install pytz
然后,安装Django。
执行命令:
pip3 install django
或者,下载Django的安装包,放入“Downloads”文件夹后进行安装。
执行命令:
cd /home/centos/Downloads/
tar xfz Django-2.0.3.tar.gz
cd Django-2.0.3
python3 setup.py install
最后,测试一下Python3.6、Django以及Sqlite3是否能够正常使用。
执行命令:
python3
>>>import django
>>>import sqlite3
四、安装uWSGI
注意:不要用“yum install uwsgi
”进行安装,这样装完会关联系统中的Python2.7,并且系统可能会自带uwsgi,自带uwsgi的启动项在“/usr/sbin/
”中,而我们通过“pip3
”命令安装uwsgi的启动项在“/usr/local/bin/
”目录中。
执行命令:
pip3 install uwsgi
如果怕搞混,我们可以卸载系统自带的uwsgi,然后将启动项复制到“/usr/sbin/
”目录中。
执行命令:
yum remove uwsgi
cp -f /usr/local/bin/uwsgi /usr/sbin/
或者,我们可以将自己安装的uwsgi启动项复制到“/usr/sbin/”目录中时,改名为“uwsgi3”。
执行命令:
cp -f /usr/local/bin/uwsgi /usr/sbin/uwsgi3
接下来,我们测试一下uwsgi是否能够正常工作。
创建一个测试文件“mytest.py”。
执行命令:
vi /var/www/mytest.py
写入内容:
# !/usr/bin/python3 # 也可以写成“#!/usr/bin/python3.6”。 def application(env, start_response): start_response('200 OK', [('Content-Type', 'text/html')]) return [b'UWSGI Test...']
代码输入完毕,按“ESC”键并键入“:wq
”回车,保存测试文件。
然后,系统中如果没有自带浏览器的话,可以安装火狐浏览器。
执行命令:
yum install firefox -y
最后,进行测试。
执行命令:
cd /var/www/
uwsgi3 --http :8888 --wsgi-file mytest.py
如果出现以下问题:
uwsgi: option ‘–http’ is ambiguous; possibilities: ‘–http-socket’ ‘–https-socket-modifier2’ ‘–https-socket-modifier1’ ‘–https-socket’ ‘–http11-socket’ ‘–http-socket-modifier2’ ‘–http-socket-modifier1’
getopt_long() error
尝试:
yum install uwsgi-plugin-python36
uwsgi --http-socket :8888 --plugin python36 --wsgi-file mytest.py
此时,通过本机浏览器访问“http://127.0.0.1:8888
”或者“http://localhost:8888
”进行测试,如果页面中显示“UWSGI Test…”字样,则说明测试成功,uwsgi可以正常工作了。
五、安装Nginx
首先,安装Nginx的依赖库“pcre”。
执行命令:
yum install -y pcre pcre-devel
然后,安装Nginx。
执行命令:
yum install -y nginx*
安装完成后,就可以通过命令控制Nginx了。
启动命令:/usr/sbin/nginx
停止命令:/usr/sbin/nginx -s stop
退出命令:/usr/sbin/nginx -s quit
重载命令:/usr/sbin/nginx -s reload
查询进程:ps aux|grep nginx
另外,我们还可以设置Nginx为开机自启动。
执行命令:
vi /etc/rc.local
在打开的文件中,按“i”键进入编辑模式,添加一行内容。
/usr/local/nginx/sbin/nginx
输入完毕,按“ESC”键并键入“:wq
”回车,保存测试文件。
六、配置Nginx
创建配置文件,并写入内容。
执行命令:
vi /etc/nginx/conf.d/MyWeb.conf
写入内容:
server { listen 80; server_name www.qqtbb.com; charset utf-8; client_max_body_size 5M; location /media { alias /var/www/MyWeb/media; } location /static { alias /var/www/MyWeb/static; } location / { uwsgi_pass 127.0.0.1:8888; include /etc/nginx/uwsgi_params; } }
提示:配置内容的详细说明,可以参考《Django2:Web项目开发入门笔记(16)》。
内容输入完毕(使用时请先清除注释),按“ESC”键并键入“:wq
”回车保存,并让服务器重载配置。
执行命令:
nginx -s reload
此时,可能发生错误。
nginx: [error] open() “/usr/local/var/run/nginx.pid” failed (2: No such file or directory)
解决方法是找到“nginx.conf”的文件夹目录,然后运行“nginx
”命令。
例如,“nginx.conf”文件在“/etc/nginx/
”目录中。
执行命令:
nginx -c /etc/nginx/nginx.conf
nginx -s reload
如果发生80端口被占用的情况,可以先查询占用端口的进程,通过“kill
”命令关闭进程。
执行命令:
lsof -i :80
kill -9 [进程ID]
nginx -c /etc/nginx/nginx.conf
七、使用ini文件启动uWSGI服务器
首先,使用ini文件启动uWSGI服务器,需要安装依赖库。
执行命令:
yum -y install uwsgi-plugin-python3
然后,在项目文件夹中创建ini文件。
例如,在“/var/www/MyWeb
”中存放Web项目文件。
执行命令:
vi /var/www/MyWeb/uwsgi.ini
在新建的文件中输入内容。
[uwsgi] socket = 127.0.0.1:8888 # 因为要接收来自Nginx的Socket,此处必须和Nginx的设置保持一致。 chdir = /var/www/MyWeb/ wsgi-file = MyWeb/wsgi.py # 完整路径是“/var/www/MyWeb/MyWeb/wsgi.py” processes = 3 # 注意,此处启用了多进程,之后使用supervisor管理uWSGI时,需要增加配置项。 threads = 5 chmod-socket = 664 chown-socket = www-data pidfile= /var/www/MyWeb/MyWeb.pid vacuum = true
提示:配置内容的详细说明,可以参考《Django2:Web项目开发入门笔记(16)》。
内容输入完毕(使用时请先清除注释),按“ESC”键并键入“:wq
”回车保存,然后就可以通过配置文件启动uWSGI服务器了。
启动命令:
uwsgi3 --ini /var/www/MyWeb/uwsgi.ini
停止命令:
uwsgi3 --stop /var/www/MyWeb/MyWeb.pid
重载配置:
uwsgi3 --reload uwsgi.ini
再次强调:启动时注意Python版本是否Python3.6,并且不要使用系统自带的uwsgi。
此时,通过域名就能够访问我们的Web项目了。
八、使用supervisor管理uWSGI服务器
supervisor可以在程序意外关闭时自动重新启动,使用它管理uWSGI服务器非常不错。
不过,supervisor只支持Python2,我们需要通过CentOS自带的Python2.7进行安装。
首先,安装“pip”工具。
执行命令:
cd /usr/lib/python2.7/site-packages/
easy_install pip
然后,安装“supervisor”。
pip install supervisor
接下来,进行配置。
执行命令:
echo_supervisord_conf > /etc/supervisord.conf
vi /etc/supervisord.conf
在打开的文件末尾添加内容。
注意:语句前面不要有空格。
[program:MyWeb] command=uwsgi3 --ini /var/www/MyWeb/uwsgi.ini directory=/var/www/MyWeb/ startsecs=10 stopwaitsecs=10 stopasgroup=true killasgroup=true autostart=true autorestart=true
提示:配置内容的详细说明,可以参考《Django2:Web项目开发入门笔记(16)》。
这里特别需要注意的是,如果“uwsgi.ini”文件中开启了多进程,一定要加上下面两句。
stopasgroup = true # 用于停止进程组,即停止所有通过“uwsgi.ini”配置启动的进程。 killasgroup = true # 用于关闭进程组,即关闭所有通过“uwsgi.ini”配置启动的进程。
如果不添加这两句,supervisorctl命令停止或关闭进程时,只会关闭其中1个进程,从而导致再次启动或重启uWSGI失败,出现“ERROR (spawn error)”的错误。
这是因为残留的孤儿进程,阻止了新的同类进程的开启。
当我们完成配置文件的修改之后,必须重新加载配置文件,才能使其生效。
执行命令:
supervisorctl reload
此时,可能出现错误:Unlinking stale socket /var/run/supervisor.sock
这个的错误是因为缺少依赖,需要安装“python-meld3”。
执行命令:
yum -y install python-meld3
最后,启动supervisord和uWSGI。
执行命令:
/usr/bin/supervisord -c /etc/supervisord.conf
或者:
supervisorctl -c /etc/supervisord.conf start MyWeb
此时,可能会发生错误。
Error: Another program is already listening on a port that one of our HTTP servers is configured to use. Shut this program down first before starting supervisord.
这是因为已经有“supervisor.sock”文件被链接(上一次启动Supervisor造成的)。
我们需要先查找哪个“supervisor.sock”文件被链接,并取消已有链接。
执行命令:
find / -name supervisor.sock
unlink /被链接文件的所在路径/supervisor.sock
如果出现错误“ERROR (spawn error)”,可能是uWSGI进程已存在所导致的。
执行命令:
ps -ef|grep uwsgi
kill -9 [端口号]
或者使用“killall”命令通过名称关闭全部相关进程。
killall -9 uwsgi
此时,再次启动项目就可以了。
如果还是出现错误“ERROR (spawn error)”,也可能是因为“uwsgi.ini”中添加了“daemonize ”(日志)项导致的,将其删除即可。
另外,通过“supervisorctl
”命令,可以方便的管理项目。
启动项目命令:supervisorctl start [配置文件中的项目名称]
重启项目命令:supervisorctl restart [配置文件中的项目名称]
停止项目命令:supervisorctl stop [配置文件中的项目名称]
控制所有项目:supervisorctl <start/restart/stop> all
注意:如果系统中出现了Python3的其他版本(例如:Python3.4.8),并且“python3”命令不能启动Python3.6时,可以通过创建新的链接解决。
执行命令:
rm -f /usr/bin/python3
ln -s /usr/local/bin/python3 /usr/bin/python3
补充内容:Xfce桌面相关问题解决方案。
1、不能正常安装。
可以在上方操作之后,继续安装“X Window System”。
执行命令:
yum -y groupinstall "X Window system"
然后,设置默认启动图形界面。
执行命令:
systemctl isolate graphical.target
systemctl set-default graphical.target
完成以上步骤之后,通过“reboot
”命令重启系统即可进入Xfce桌面。
2、Xfce桌面乱码
出现乱码有可能是因为安装了中文版CentOS系统,需要安装文泉驿字体。
执行命令:
yum install wqy*
完成以上步骤之后,通过“reboot
”命令重启系统即可解决乱码问题。
转载请注明:魔力Python » Django2:Web项目开发入门笔记(20)