django使用uwsgi+nginx+supervisor部署

已经学习django有两三个月了，不能说多精通，粗略了解了django。照着网上的教程，自己查资料，做了一个博客，好像所有的新手都是做这个，那我也做这个好了。第一次写博客代码的时候，有很多不足之处，毕竟是一次从上到下学习django的过程，所以就没有纠结那么多，有几处自己不是很满意的地方。再加上第一次部署的时候，踩到非常多的坑，几乎每走一步都会有，大大小小的，差点没把自己搞崩溃，中间又赶上春节，断断续续的终于把项目部署成功了。

今天将部署程序写出来：

1.项目代码写完之后，要确认你的项目没有bug。

· 在项目根目录下面创建一个requirements.txt文件，使用`pip freeze > requirements.txt`将当前环境的包导出到`requirements.txt`文件中，方便在部署的时候安装。      

· 在github上创建一个仓库，然后将你项目所在的根目录初始化为一个仓库。

     git init    # 初始化一个git仓库

     git remote add origin 仓库地址     #本地仓库与远程仓库关联。

     git add .   #  将本地文件添加，准备提交

     git commit -m 'first commit'   # 正式提交，但是还每提交到仓库，代码还是在本地仓库中

     git pull origin master --allow-unrelated-histories   #如果第一次从远程仓库拉代码，必须要加后面那一句，否则不成功。输入后会出来一个界面，输入:q退出就行，因为远程仓库创建时有一个README.md文件。

     git push origin master   # 推送代码到远程仓库，推送成功才是将代码真正推到远程仓库中了

2.服务器上安装

服务器上需要安装的东西就多了，如果没有服务器可以下载一个ubuntu虚拟机，也可以当作服务器使用。对于一个全新的虚拟机来说，需要以下步骤：

· 安装python，一般情况ubuntu虚拟机会自带python，不过版本是2.x的，不过有些项目是要使用3.x版本，所以需要安装

    sudo apt install python3

    sudo apt install python3-pip    # 安装pip3，方便下载python包

    pip3 install --upgrade pip3    # 将pip更新到最新版本

· 安装`virtualenv`以及`virutalenvwrapper`。并创建虚拟环境。
    pip install virtualenv
    pip install virtualenvwrapper  # 其实只使用这一行代码就可以安装virtualenv了
    sudo apt install vim  # 安装vim编辑器
    vim ~/.bashrc 进入文件中，填入以下三行代码：
         export WORKON_HOME=$HOME/.virtualenvs
         VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3   
         source /usr/local/bin/virtualenvwrapper.sh
    source ~/.bashrc

   这个时候 你就可以使用mkvirtualenv  xxx 来创建一个名字叫xxx的虚拟环境了，创建时候好像是自动进入虚拟环境，要是退出虚拟环境使用 deactivate命令。下次你想进入虚拟环境，使用workon xxx就可以了。

·安装git：

    sudo apt install git   # 同上，在服务器上初始化一个仓库，然后关联远程仓库就好了。

· 如果会使用Xshell，那么要安装下面的：

    sudo apt install openssh-server openssh-client

    service ssh restart

· 安装mysql(这个里面坑有点多，如果第一次安装说不定会很头疼)：

    sudo apt install mysql-server mysql-client

    sudo apt-get install libmysqld-dev 

3.使用workon xxx进入虚拟环境

cd /srv进入，然后mkdir xxxx 创建一个文件夹放置你的项目代码，git pull origin master将代码从远仓库拉下来，执行命令：pip3 install -r requirements.txt 就会安装你的项目所需要的包

4.创建一个数据库

与项目中的settings.py中的设置对应。

5.创建项目数据表

然后执行 python manage.py migrate ，如果提交代码时删掉了迁移简本，那么就要先使用python manage.py makemigrations创建迁移脚本，然后再使用上面的命令再数据库中创建表。

6.搜集静态文件

再项目目录下新建文件夹static_dist,然后再settings.py中添加一行代码，STATIC_ROOT = os.path.join(BASE_DIR, 'static_dist'),表示的是搜集文件的地址。

   python manage.py collectstatic

7.安装uwsgi

他是一个应用服务器，非静态文件的网络请求就得靠他完成。比如，用户请求页面上的某个新闻或者某些数据，nginx就无法满足了，因为它只处理静态文件跟接受http请求，所以nginx将请求分发给uwsgi服务器，接受请求后，uwsgi调用django代码，将数据查找并返回uwsgi，再返回给nginx。

   pip3 install uwsgi

8.编写uwsgi配置文件。

在项目的路径下面，创建一个文件叫做xxx_uwsgi.ini的文件，名字随便取，但是必须添加ini后缀，然后填写以下代码：

[uwsgi]

    # Django相关的配置
    # 必须全部为绝对路径
    # 项目的路径
    chdir           = /srv/xxxx     #  必写   后面是项目的名称

    # Django的wsgi文件
    module          = xxxx.wsgi   #  必写  项目的wsgi文件

    # Python虚拟环境的路径
    home            = /root/.virtualenvs/xxx   #  必写  创建虚拟环境的时候要在root权限下才能从root路径下找到

    # 进程相关的设置
    # 主进程
    master          = true

    # 最大数量的工作进程
    processes       = 10

    # socket文件路径，绝对路径 与nginx用来通信的，只要uwsgi跟nginx都指定了同样的文件路径，这个文件就会自动创建。
    socket          = /srv/xxxx/123.sock   #  必写   名字也是自取，不要搞混淆了，用来与nginx进行通信的 ，nginx配置文件上也要写，必须保持一致。

    # 设置socket的权限
    chmod-socket    = 666   # 必写，有的写664，现在不知道有什么区别，待研究。  

    # 退出的时候是否清理环境
    vacuum          = true
    必写的参数必须要写，其他的可写可不写，会使用默认值。

9.安装nginx：是一个守护进程，挂掉后会自动重启，跟uwsgi不一样。

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

·编写nginx配置文件：
  在`/etc/nginx/conf.d`目录下，新建一个文件，叫做`1234.conf`，名字也是随便取，不能混淆，然后将以下代码粘贴进去：
        upstream blog {
               server unix:///srv/xxxx/123.sock; 
         }

        # 配置服务器
        server {
                # 监听的端口号
                listen      80;
                # 域名
                server_name 192.168.0.101;   #  根据虚拟机的IP
                charset     utf-8;

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

                # 图片，视频等访问url
                location /media{
                     alias /srv/xxxx/media;
                }  

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

                # 最后，发送所有非静态文件请求到django服务器
                location / {
                    uwsgi_pass  blog;    # 这个地方的blog跟上面的upstream后面的blog名字要相同
                    # uwsgi_params文件地址
                    include     /etc/nginx/uwsgi_params; 
                }
         } 

写完配置文件后，为了测试配置文件是否设置成功，运行命令：service nginx configtest，如果不报错，说明成功。
每次修改完了配置文件，都要记得运行service nginx restart。

10. 使用supervisor配置

    让supervisor管理uwsgi，可以在uwsgi发生意外的情况下，会自动的重启。
 	  1. `supervisor`的安装：在系统级别的python环境下`pip install supervisor`。
  	  2. 在项目的根目录下创建一个文件叫做`blog_supervisor.conf`。内容如下：
           ```
           # supervisor的程序名字
           [program:mysite]
           # supervisor执行的命令
           command=uwsgi --ini xxx_uwsgi.ini
           # 项目的目录
           directory = /srv/xxxx
           # 开始的时候等待多少秒
           startsecs=0
           # 停止的时候等待多少秒
           stopwaitsecs=0  
           # 自动开始
           autostart=true
           # 程序挂了后自动重启
           autorestart=true
           # 输出的log文件  要在项目目录下面创建一个log文件夹
           stdout_logfile=/srv/xxxx/log/supervisord.log
           # 输出的错误文件
           stderr_logfile=/srv/xxxx/log/supervisord.err
    
           # 服务器端 后面带了d
           [supervisord]
           # log的级别
           loglevel=info

           #客户端，后面带ctl
           # 使用supervisorctl的配置
           [supervisorctl]
           # 使用supervisorctl登录的地址和端口号
           serverurl = http://127.0.0.1:9001
 
           # 访问supervisord必须设置下面的内部服务器属性
           [inet_http_server]
           # supervisor的服务器
           port = :9001
           # 用户名和密码
           username = admin
           password = 1111

           # 登录supervisorctl的用户名和密码
           username = admin
           password = 1111

           # 官方文档上面就是这样的，直接填上就好
           [rpcinterface:supervisor]
           supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
         ```

     然后使用命令`supervisord -c blog_supervisor.conf`运行就可以了。
     以后如果想要启动`uwsgi`，就可以通过命令`supervisorctl -c blog_supervisor.conf`进入到管理控制台，然后可以执行相关的命令进行管理：
        * status                # 查看状态
        * start program_name    # 启动程序
        * restart program_name  # 重新启动程序
        * stop program_name     # 关闭程序
        * reload                # 重新加载配置文件
        * quit                  # 退出控制台

上面的内容就是我在部署时的步骤。