## 前言
这是我在搭建Django项目时候的过程，拿来总结记录，以备不时之需。
项目采用nginx+uwsgi的搭配方式。
项目依赖包采用`requirements.txt`文件管理的方式。
## 本地准备工作
1. 确认项目能够运行起来，没有`bug`
2. 将当前环境的包导出 `pip freeze > requirements.txt`
3. 将项目上传到服务器上的`/srv`目录下。这里以`git`的形式为例, 打开终端, 依次输入如下命令:
```bash
$ git init
$ git remote add origin xxx.git # 替换成你的项目git地址
$ git add .
$ git commit -m 'first commit'
$ git pull origin master --allow-unrelated-histories
$ git push origin master
```
## 部署项目到服务器
### 安装python
1. 安装好项目用到的`python`。
```bash
$ sudo apt install python
$ sudo apt install python-pip
$ pip install --upgrade pip
```
2. 安装`virtualenv`以及`virutalenvwrapper`，并创建虚拟环境。
```bash
$ pip install virtualenv
$ pip install virtualenvwrapper
$ sudo apt install vim
```
3. 编辑文件`~/.bashrc`
```bash
$ vim ~/.bashrc
# 添加如下2行代码
export WORKON_HOME=$HOME/.virtualenvs
source /usr/local/bin/virtualenvwrapper.sh
# 保存文件，让文件成效
$ source ~/.bashrc
```
### 安装git：
```bash
$ sudo apt install git
# 为了方便XShell或者CRT连接服务器，建议安装OpenSSH
$ sudo apt install openssh-server openssh-client
$ service ssh restart
```
### 安装MySQL
```
$ sudo apt install mysql-server mysql-client
$ sudo apt-get install libmysqld-dev
```
### 测试配置
1. 安装依赖包，进入虚拟环境 `workon ***`，进入项目根目录，执行命令`pip install -r requirements.txt`
2. 创建数据库，新打开一个终端，登录数据库，`mysql -uroot -p `, 创建相应的数据库 `CREATE DATABASE IF NOT EXISTS my_db default charset utf8mb4;`
3. 迁移数据，`python manage.py migrate`
4. 收集静态文件, `python manage.py collectstatic`
4. 启动服务器，执行 `python manage.py runserver 0.0.0.0:8000`，然后在你自己电脑上，在浏览器中输入`http://:8000`，访问下网站所有页面，确保所有页面都没有错误。
注意：
1. 设置 `ALLOW_HOST` 为你的域名或 `ip` 地址。
2. 设置 `DEBUG=False`。
### 安装uwsgi
`uwsgi`是一个应用服务器，非静态文件的网络请求就必须通过他完成，他也可以充当静态文件服务器，但不是他的强项。
`uwsgi`是使用`python`编写的，因此通过`pip install uwsgi`就可以了。(`uwsgi`必须安装在系统级别的`Python`环境中，不要安装到虚拟环境中)。
1. 命令行启动`uwsgi`：
```bash
$ uwsgi --http :8000 --module test.wsgi --vritualenv=/root/.virtualenvshttps://img.qb5200.com/download-x/django-env-py36
```
如果能够在浏览器中访问到测试的页面，说明uwsgi可以加载项目了。
2. 配置文件方式启动`uwsgi`：
在项目的根路径下面，创建一个文件`djangotest.ini`，填写以下代码：
```
[uwsgi]
# Django相关的配置
# 必须全部为绝对路径
# 项目的路径
chdir=/srvhttps://img.qb5200.com/download-x/djangotest
# Django的wsgi文件
module=djangotest.wsgi
# Python虚拟环境的路径
home=/root/.virtualenvshttps://img.qb5200.com/download-x/django-env-py36
# 进程相关的设置
# 主进程
master=true
# 最大数量的工作进程
processes=10
# socket文件路径，绝对路径
socket=/srvhttps://img.qb5200.com/download-x/djangotesthttps://img.qb5200.com/download-x/djangotest.sock
# 设置socket的权限
chmod-socket=666
# 退出的时候是否清理环境
vacuum=true
然后使用命令uwsgi --ini djangotest.ini，看下是否还能启动这个项目。
```
### 安装nginx
`nginx`是一个`web`服务器。用来加载静态文件和接收`http`请求的。
1. 通过命令`sudo apt install nginx`即可安装。
2. `nginx`常用命令：
* 启动nginx：service nginx start
* 关闭nginx：service nginx stop
* 重启nginx：service nginx restart
3. 收集静态文件:
静态文件应该让`nginx`来处理，而不是让`django`来做。
首先确保你的`settings.py`文件中有一个`STATIC_ROOT`配置，这个配置应该指定你的静态文件要放在哪个目录下。
那么我们可以执行以下命令：`python manage.py collectstatic`来收集所有静态文件(已经执行过请忽略)。
4. 编写nginx配置文件，在`/etc/nginx/conf.d`目录下，新建一个文件 `djangotest.conf`，然后将以下代码贴进去：
```
upstream djangotest {
server unix:///srvhttps://img.qb5200.com/download-x/djangotesthttps://img.qb5200.com/download-x/djangotest.sock;
}
# 配置服务器
server {
# 监听的端口号
listen 80;
# 域名
server_name 192.168.0.101;
charset utf-8;
# 最大的文件上传尺寸
client_max_body_size 75M;
# 静态文件访问的url
location /static {
# 静态文件地址
alias /srvhttps://img.qb5200.com/download-x/djangotest/static_dist;
}
# 最后，发送所有非静态文件请求到django服务器
location / {
uwsgi_pass djangotest;
# uwsgi_params文件地址
include /etc/nginx/uwsgi_params;
}
}
```
5. 测试配置文件：`service nginx configtest`。注意：每次修改完配置需要重启`nginx`: `service nginx restart`
### 使用supervisor
让supervisor管理uwsgi，可以在uwsgi发生意外的情况下，自动重启。
1. 安装`supervisor`：在系统级别的python环境下 `pip install supervisor`。
2. 在项目根目录下创建一个文件`my_supervisor.conf`。编写内容：
```
# supervisor的程序名字
[program:mysite]
# supervisor执行的命令
command=uwsgi --ini zlkt_uwsgi.ini
# 项目的目录
directory = /srvhttps://img.qb5200.com/download-x/djangotest
# 开始的时候等待多少秒
startsecs=0
# 停止的时候等待多少秒
stopwaitsecs=0
# 自动开始
autostart=true
# 程序挂了后自动重启
autorestart=true
# 输出的log文件
stdout_logfile=/srvhttps://img.qb5200.com/download-x/djangotest/log/supervisord.log
# 输出的错误文件
stderr_logfile=/srvhttps://img.qb5200.com/download-x/djangotest/log/supervisord.err
[supervisord]
# log的级别
loglevel=info
# 使用supervisorctl的配置
[supervisorctl]
# 使用supervisorctl登录的地址和端口号
serverurl = http://127.0.0.1:9001
# 登录supervisorctl的用户名和密码
username = admin
password = 123
[inet_http_server]
# supervisor的服务器
port = :9001
# 用户名和密码
username = admin
password = 123
[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
```
3. 运行`supervisor`，执行`supervisord -c my_supervisor.conf`。
4. 进入`supervisor`管理控制台， `supervisorctl -c my_supervisor.conf`
5. `supervisor`管理控制台常用命令
```
# 查看状态
status
# 启动程序
start program_name
# 重新启动程序
restart program_name
# 关闭程序
stop program_name
# 重新加载配置文件
reload
# 退出控制台
quit
```
Enjoy your code！
