树莓派部署django项目 | 树莓派小无相系列

人生苦短，快用 python。由于刚刚接触到 django，实现项目以后，对部署不太熟悉，因此在树莓派上尝试一下。文中教程 Linux 通用。

部署概览

咱们采用 nginx + uwsgi 的方案进行部署。整个系统架构图以下：

环境配置

首先须要安装 virtualenv 为其提供独立的环境，命令行以下：

pip3 install virtualenv

建立并生成环境，个人项目名为 demo，我决定将它放置在 /home/pi/www/demo 下，命令行以下：

cd ~/www/demo
python3 -m virtualenv --no-site-packages venv

激活环境命令为：

source venv/bin/activate

注：激活环境后，输入命令的指示标志前会变成相似 (venv) pi@raspberrypi:~/www/demo $。

退出当前环境命令为：

deactivate

django 项目配置

环境配置好后，即可以准备项目的上传。该部分的全部命令皆是在激活虚拟环境（source venv/bin/activate）以后进行。

(1). 在编写 django 项目的测试机器上，进入项目根目录（存着 manage.py 文件的目录），cd 到该目录，以后运行以下命令生成扩展库信息列表：

pip freeze > requirements.txt

(2). 把 django 项目整个传到树莓派上，项目根目录（manage.py 同级目录）下的所有文件所有复制到树莓派项目目录，复制以后，状况大概是这样：

(venv) pi@raspberrypi:~/www/demo $ ls
demo  guestbook  manage.py  requirements.txt  venv

(3). 安装扩展库，记住在激活的环境下执行，命令行以下：

pip3 install -r requirements.txt

(4). 上传文件后把 /<项目名>/<app名>/migrations/ 下的相似00.. 的记录文件所有删除，可是不要删除别的文件。

(5). 配置 django 项目的设置，若是设置项存在便修改，不存在则添加，改动以下：

DEBUG = False
ALLOWED_HOSTS = ['192.168.1.37', '127.0.0.1', 'demo.pi.com']
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

ALLOWED_HOSTS：容许访问的主机，若是你想经过某个 host 访问，就将它添加到这里，假设你想经过树莓派 ip（192.168.1.37） 访问，就将 192.168.1.37 添加到这里。

STATIC_ROOT：只在部署环境下生效的配置。部署环境下，效率更高的 niginx 会根据该目录提供静态环境。

(6). 将网站生成静态文件：

python3 manage.py collectstatic

(7). 配置好上述后，即可以同步并建立数据库了，先进入项目根目录，以后执行以下命令：

python3 manage.py makemigrations
python3 manage.py migrate

(8). 创建管理员帐号：

python3 manage.py createsuperuser

(9). 完成上述工做后，就能够跑一跑检查一下是否可以正常运行啦：

python manage.py runserver 0.0.0.0:8000

注：这时候打开网页会发现 css 样式都未应用，是由于静态文件已经再也不是 django 管理了，以后咱们会让 nginx 接管它。

uwsgi 配置

仍然是在激活的环境（source venv/bin/activate）中进行。

安装 uwsgi：

pip3 install uwsgi

注：若是安装出现错误，能够尝试先安装 python-dev 包：sudo apt-get install python-dev

配置 uwsgi，咱们使用 .ini 文件配置。

新建一个 uwsgi 文件夹存放 uwsgi 相关的文件（配置、日志等），这个文件夹能够存放在任意位置，我将它放置在了 django 项目根目录下，其目录即为 /home/pi/www/uwsgi/，在文件夹下新建一个 uwsgi.ini 文件。文件内容以下：

# uwsgi使用配置文件启动
[uwsgi]
# 项目根目录，并不是是app目录
chdir=/home/pi/www/demo/
# wsgi.py 的路径，demo是wsgi.py存在的目录名
module=demo.wsgi:application
# 指定sock的文件路径，用来与nginx通讯       
socket=/home/pi/www/uwsgi/uwsgi.sock
# 进程个数       
workers=4
pidfile=/home/pi/www/uwsgi/uwsgi.pid
# 指定IP端口，这里能够用来测试uwsgi与django项目之间是否准确链接。调试好后能够注释掉
# 若是开启了能够不用开启nginx服务而直接经过 ip:8000       
# http=192.168.1.37:8000

# 这里使用上面收集的静态文件夹目录
static-map=/static=/home/pi/www/demo/static
# 启动uwsgi的用户名和用户组
uid=pi
gid=root
# 启用主进程
master=true
# 自动移除unix Socket和pid文件当服务中止的时候
vacuum=true
# 序列化接受的内容，若是可能的话
thunder-lock=true
# 启用线程
enable-threads=true
# 设置自中断时间
harakiri=30
# 设置缓冲
post-buffering=4096
# 设置日志目录
daemonize=/home/pi/www/uwsgi/uwsgi.log

启动 uwsgi 服务：

uwsgi --ini uwsgi.ini

nginx 配置

安装 nginx：

sudo apt-get install nginx

由于我以前在树莓派上作了 dns 解析，将 pi 的 ip 地址解析到了 pi.com 这个域名上，因此我为这个项目配置的域名为 demo.pi.com，编辑 nginx 对项目的配置文件：

sudo nano /etc/nginx/sites-available/demo.pi.com

注：ctrl+o 以后回车保存，ctrl+x 退出。

文件内容以下：

server { 
    listen 80; 
    server_name demo.pi.com; #若是解析到域名便填写域名，不然填写ip地址便可
    charset utf-8;
    gzip_types text/plain application/x-javascript text/css text/javascript application/x-httpd-php application/json text/json image/jpeg image/gif image/png application/octet-stream;

    error_page 404 /404.html;
    error_page 500 502 503 504 /50x.html;

    # 指定项目路径uwsgi
    location / {
        # uwsgi_params在nginx文件夹下
        include /etc/nginx/uwsgi_params; 
        # 设置链接uWSGI超时时间
        uwsgi_connect_timeout 30; 
        # nginx与uwsgi的通讯方式，动态请求会经过sock传递给uwsgi处理
        uwsgi_pass unix:/home/pi/www/uwsgi/uwsgi.sock;
    }

    # 这里使用上面收集的静态文件夹目录
    location /static/ {
      alias /home/pi/www/demo/static/;
      index index.html index.htm;
    }
}

接下来建立一个软连接到 /etc/nginx/sites-enabled/ 目录下，使配置文件生效：

sudo ln -s /etc/nginx/sites-available/demo.pi.com /etc/nginx/sites-enabled/

重启 nginx 使其生效：

sudo nginx restart

一键重启脚本

每次网站有变更时，总要在作这么几个事，关闭原有 uwsgi 服务，启动 uwsgi 服务，重启 nginx，太繁琐，咱们写个脚本搞定它，我把脚本放在了 ~/www/uwsgi/ 这个目录，方便管理。脚本名为 run.sh，内容以下：

#!/bin/sh
sudo killall -9 uwsgi
/home/pi/www/demo/venv/bin/uwsgi --ini /home/pi/www/uwsgi/uwsgi.ini
sudo /etc/init.d/nginx restart

当中第三行的 uwsgi 相关路径换为你的项目对应的就 OK。

别忘了给这个文件执行权限：

chmod +x run.sh

以上完成以后，运行 ./run.sh 重启整个项目，而后在其余设备访问试试。

参考

部署Django项目 - Junay

系列说明

小无相功是小说《天龙八部》中「逍遥派」的一门内功，讲究不着形相，无迹可寻，熟悉后再了解其余武功招式即可依仗威力习得，甚至青出于蓝而胜于蓝。而树莓派形似小无相功，同具无限可能，了解一些基础即可轻松上手，去探寻其余更多未知。所以，系列以此为题，带来一系列树莓派相关的教程，同时也是对我的长期折腾树莓派以来的一个归档整理。

注：本做品采用知识共享署名-非商业性使用-禁止演绎 3.0 未本地化版本许可协议进行许可。