Ubuntu部署Django项目方法详细讲解

教程使用的软件版本：Ubuntu 18.04.1 LTS，django2.0，Python 3.6.5、nginx-1.13.7、uWSGI (2.0.17.1)，Ubuntu是纯净的，全新的。下面我们开始来部署。

一、更新操作系统和安装依赖包

#更新操作系统软件库sudo apt-get update
sudo apt-get upgrade#安装上传rz、下载sz工具sudo apt-get install lrzsz#安装gcc g++的依赖库sudo apt-get install build-essential
sudo apt-get install libtool#安装 pcre依赖库sudo apt-get install libpcre3 libpcre3-dev#安装 pcre依赖库sudo apt-get install zlib1g-dev#安装 ssl依赖库sudo apt-get install openssl

二、安装Python3和PIP3

sudo apt install python3
sudo apt install python3-pip

三、建立两个文件夹，用于存放virtualenv环境和项目

#放虚拟环境的sudo mkdir -p /data/env#放项目的sudo mkdir -p /data/wwwroot

四、安装virtualenv

sudo pip3 install virtualenv

这里出现报错信息：“externally-managed-environment”错误，具体如下

root@111111111111111111111:~# sudo pip3 install virtualenv
error: externally-managed-environment
× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.
    
    If you wish to install a non-Debian-packaged Python package,
    create a virtual environment using python3 -m venv path/to/venv.
    Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
    sure you have python3-full installed.
    
    If you wish to install a non-Debian packaged Python application,
    it may be easiest to use pipx install xyz, which will manage a
    virtual environment for you. Make sure you have pipx installed.
    
    See /usr/share/doc/python3.12/README.venv for more information.
note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.

表明Python环境由系统外部管理‌。以下是几种解决方法：

1.使用系统包管理器安装‌：

可以使用Ubuntu的系统包管理器apt来安装Python库，例如：

sudo apt install python3-virtualenv

进入工程目录

cd /www/zcl

指定Python版本，创建名为pyweb的虚拟环境，

sudo virtualenv -p /usr/bin/python3 env_ll

指定Python版本的时候，如果不知道Python3的路径，可以使用下面的命令查看

which python

五、启动虚拟环境

#启动虚拟环境source /www/zcl/env_ll/bin/activate

六、上传项目并安装依赖软件库(虚拟环境下)

把我们开发好的项目上传到 /www/zcl/目录，然后进入该目录，先安装项目所需要的依赖包，然后启动项目，测试是否能正常启动。

sudo pip3 install -r requirements.txt
这个命令由于是在虚拟环境中安装，因此只需要以下命令
pip3 install -r requirements.txt

python3 manage.py runserver
直接运行这个会报错，因为是在win上开发，需要把之前的所有数据迁移记录删除，sql也删除，重新进行如下操作
python3 manage.py makemigrations 
python3 manage.py migrate 
再次进行
python3 manage.py runserver
ok之后接着往下进行

如果能正常启动，说明项目没啥问题。

七、安装uwsgi

sudo pip3 install uwsgi

留意：uwsgi要安装两次，先在系统里安装一次，然后进入对应的虚拟环境安装一次。

目前在虚拟环境里面，先在虚拟环境里安装

pip3 install uwsgi

退出虚拟环境

activate

sudo pip3 install uwsgi
很明显，还会出现如上面的错误
sudo apt install python3-uwsgi
会出现找不到包的错误
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
E: Unable to locate package python3-uwsgi
如果你确实需要通过系统的包管理器安装，你应该使用正确的包名。对于Debian或Ubuntu系统，你可以尝试：
sudo apt-get update
sudo apt-get install uwsgi

安装成功之后，我们进入项目根目录/data/wwwroot/mysite/新建一个 mysite.xml文件，在里面输入代码：

<uwsgi>    
   <socket>127.0.0.1:8997</socket><!-- 内部端口，自定义 --> 
   <chdir>/data/wwwroot/mysite/</chdir><!-- 项目路径 -->            
   <module>mysite.wsgi</module> 
   <processes>4</processes> <!-- 进程数 -->     
   <daemonize>uwsgi.log</daemonize><!-- 日志文件 --></uwsgi>

要留意里面的项目路径和.wsgi那里填写方法，你找到wsgi.py这个文件所在的目录，然后填写目录名+.wsgi即可。

八、安装nginx，并配置

/usr/local 目录执行下面命令下载nginx源码：

wget http://nginx.org/download/nginx-1.13.7.tar.gz

然后解压它：

tar -zxvf nginx-1.13.7.tar.gz

cd 进入解压后的nginx-1.13.7文件夹，依次执行以下命令：

sudo ./configure 
sudo make 
sudo make install

nginx一般默认安装好的路径为/usr/local/nginx

进入/usr/local/nginx/conf/目录，然后备份一下nginx.conf文件，以防意外。

sudo cp nginx.conf nginx.conf.bak

然后打开nginx.conf文件，把里面的内容全部删除，输入下面代码：

events {
    worker_connections  1024;
}http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    server {
        listen       80;
        server_name  www.django.cn;
        charset utf-8;
        location / {
           include uwsgi_params;
           uwsgi_pass 127.0.0.1:8997;
           uwsgi_param UWSGI_SCRIPT mysite.wsgi;
           uwsgi_param UWSGI_CHDIR /data/wwwroot/mysite/; #项目路径           
        }
        location /static/ {
        alias /data/wwwroot/mysite/static/; #静态资源路径        }
    }
}

需要留意的是，下图长方形里我标记的代码要和UWSGI配置文件mysite.xml一致，否则会出错。

至于静态资源路径，自己settings.py里怎么设置，你就按那个设置就好。

进入/usr/local/nginx/sbin/目录

执行下面命令先检查配置文件是否有错：

./nginx -t

没有错就执行以下命令：

./nginx

终端没有任何提示就证明nginx启动成功。

之后进入网站项目目录

cd /www/zcl/asite/

执行下面命令(虚拟环境下)：

uwsgi -x asite_uwsgi.xml

以上步骤都没有出错的话。

进入/usr/local/nginx/sbin/目录

执行：

./nginx -s reload

或者在任目录下执行

/usr/local/nginx/sbin/nginx -s reload

平滑重启nginx 。然后在浏览器里访问你的项目地址！这时项目就能成功访问。

后续更改任何内容都要进行如下步骤重启网站

以下直接输入 

cd /www/zcl

killall -9 uwsgi 

uwsgi -x asite_uwsgi.xml 

/usr/local/nginx/sbin/nginx -s reload 

关于后台样式丢失问题，解决方法和Centos解决方法一样，我就不在这里重复。