Django2:Web项目开发入门笔记(20)

2024年04月16日 django Python51

这一篇教程,我们一起来了解如何在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”命令重启系统即可解决乱码问题。

本文链接:http://so.lmcjl.com/news/2264/

展开阅读全文