Django部署笔记（nginx+uwsgi+supervisor)

最新推荐文章于 2024-04-09 09:55:12 发布

Amazinqc

最新推荐文章于 2024-04-09 09:55:12 发布

阅读量247

点赞数

分类专栏： Python # Django 文章标签： django 服务器部署

本文链接：https://blog.csdn.net/weixin_44055380/article/details/103358726

版权

笔记同时被 3 个专栏收录

47 篇文章 1 订阅

订阅专栏

Python

7 篇文章 0 订阅

订阅专栏

Django

4 篇文章 0 订阅

订阅专栏

django部署笔记

笔记总结来源：知了课堂Django教程

在开发机（本地）上的准备工作：

检查验收项目代码。
用pip freeze > requirements.txt将当前环境的包导出到requirements.txt文件中，方便在部署的时候安装。
将项目上传到服务器上的/srv目录下。这里以git的形式为例。
- git init
- git remote add origin xxx.git
- git add .
- git commit -m ‘first commit’
- git pull origin master --allow-unrelated-histories
- git push origin master

在服务器（乌班图系统为例）上的准备工作：

乌班图使用sudo apt指令，CentOS使用yum。

安装好项目用到的Python。
- sudo apt install python
- sudo apt install python-pip
- pip install --upgrade pip
安装virtualenv以及virutalenvwrapper。并创建虚拟环境。
- pip install virtualenv
- pip install virtualenvwrapper
- sudo apt install vim
- vim ~/.bashrc 进入文件中，填入以下两行代码：
```
export WORKON_HOME=$HOME/.virtualenvs
source /usr/local/bin/virtualenvwrapper.sh
```
- source ~/.bashrc
安装git：
```
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

进入虚拟环境中，然后进入到项目所在目录，执行命令：pip install -r requirements.txt，安装好相应的包。
在mysql数据库中，创建相应的数据库。
执行python manage.py migrate命令，将迁移文件，映射到数据库中，创建相应的表。
执行python manage.py runserver 0.0.0.0:8000，然后在你自己电脑上，在浏览器中输入http://你的服务器的ip地址:8000/，访问下网站所有页面，确保所有页面都没有错误。
设置ALLOW_HOST为你服务器的域名，以及ip地址。
设置DEBUG=False，避免如果你的网站产生错误，而将错误信息暴漏给用户。
收集静态文件：python manage.py collectstatic。
先设置STATIC_ROOT，静态文件目录，在nginx中配置后可以直接指向并处理静态文件

安装uwsgi

uwsgi是一个应用服务器，非静态文件的网络请求就必须通过他完成，他也可以充当静态文件服务器，但不是他的强项。uwsgi是使用python编写的，因此通过pip install uwsgi就可以了。(uwsgi必须安装在系统级别的Python环境中，不要安装到虚拟环境中)。
使用命令uwsgi --http :8000 --module `PROJECT`.wsgi --vritualenv=/root/.virtualenvs/django-env-py2。用uwsgi启动项目，如果能够在浏览器中访问到这个页面，说明uwsgi可以加载项目了。PROJECT.wsgi是Django项目下的wsgi文件。

编写uwsgi配置文件：

在项目的路径下面，创建一个文件叫做`PROJECT`_uwsgi.ini的文件，然后填写以下配置代码：

[uwsgi]

# Django相关的配置
# 必须全部为绝对路径
# 项目的路径
chdir           = /srv/`PROJECT`
# Django的wsgi文件
module          = `PROJECT`.wsgi
# Python虚拟环境的路径
home            = /root/.virtualenvs/django-env-py2

# 进程相关的设置
# 主进程
master          = true
# 最大数量的工作进程
processes       = 10
# socket文件路径，绝对路径
socket          = /srv/`PROJECT`/`PROJECT`.sock
# 设置socket的权限，防止无法访问sock文件的错误
chmod-socket    = 666
# 退出的时候是否清理环境
vacuum          = true

.sock文件是用于uwsgi与nginx程序间通信的媒介文件，必须保证二者都可以访问和修改该文件。
然后使用命令uwsgi --ini `PROJECT`_uwsgi.ini，看下是否还能启动这个项目。

安装nginx：

nginx是一个web服务器。用来加载静态文件和接收http请求的。通过命令sudo apt install nginx即可安装。
nginx常用命令：
- 启动nginx：service nginx start
- 关闭nginx：service nginx stop
- 重启nginx：service nginx restart

收集静态文件：

静态文件应该让nginx来服务，而不是让django来做。首先确保你的settings.py文件中有一个STATIC_ROOT配置，这个配置应该指定你的静态文件要放在哪个目录下。那么我们可以执行以下命令：python manage.py collectstatic来收集所有静态文件，将这些静态文件放在nginx指定的目录下。

编写nginx配置文件：

在/etc/nginx/conf.d目录下，新建一个文件，叫做`PROJECT`.conf，然后将以下代码：

upstream `PROJECT`{
    server unix:///srv/`PROJECT`/`PROJECT`.sock; 
}# 不需要手动创建sock文件

# 配置服务器
server {
    # 监听的端口号
    listen      80;
    # 域名 ALLOWED_HOST 空格隔开，与Django类似
    server_name 192.168.0.101; 
    charset     utf-8;

    # 最大的文件上传尺寸
    client_max_body_size 75M;  

    # 静态文件访问的url
    location /static {
        # 静态文件地址
        alias /srv/`PROJECT`/static_dist; 
    }

    # 最后，发送所有非静态文件请求到django服务器
    location / {
    	# 转发到sock文件，此处uwsgi_pass指向upstream，因此要一致
        uwsgi_pass  `PROJECT`;
        # uwsgi_params文件地址
        include     /etc/nginx/uwsgi_params; 
    }
}

写完配置文件后，为了测试配置文件是否设置成功，运行命令：service nginx configtest，如果不报错，说明成功。上述location是有先后优先级的。nginx自带守护进程。
每次修改完了配置文件，都要记得运行service nginx restart。

使用supervisor配置：

让supervisor管理uwsgi，可以在uwsgi发生意外的情况下，会自动的重启。

supervisor的安装：在系统级别的python环境下pip install supervisor。

在项目的根目录下创建一个文件叫做`Name`_supervisor.conf。内容如下：

# supervisor的程序名字
[program:mysite]
# supervisor执行的命令
command=uwsgi --ini `PROJECT`_uwsgi.ini
# 项目的目录
directory = /srv/`PROJECT` 
# 开始的时候等待多少秒
startsecs=0
# 停止的时候等待多少秒
stopwaitsecs=0  
# 自动开始
autostart=true
# 程序挂了后自动重启
autorestart=true
# 输出的log文件
stdout_logfile=/srv/`PROJECT`/log/supervisord.log
# 输出的错误文件
stderr_logfile=/srv/`PROJECT`/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

然后使用命令supervisord -c `Name`_supervisor.conf运行就可以了。
以后如果想要启动uwsgi，就可以通过命令supervisorctl -c supervisor.conf进入到管理控制台，然后可以执行相关的命令进行管理：

    * status				# 查看状态
    * start program_name	# 启动程序
    * restart program_name	# 重新启动程序
    * stop program_name		# 关闭程序
    * reload				# 重新加载配置文件
    * quit					# 退出控制台