CentOS7 + Python3 + Django(rest_framework) + MariaDB + nginx + uwsgi 部署 API 开发环境

这是一个 Django 环境部署教程，也是一个我坑爹的 Django 环境部署记录：

开始撸代码以前有两点须要提醒：

1. 本教程完美适配如题开发环境但不局限于此环境，其余开发环境仅需将命令操做转换为当前环境下的命令便可；
2. 我写做的顺序是我我的体验比较好的操做顺序仅供参考；

开撸：

1. MariaDB 的安装与部署

# yum 安装
yum -y install mariadb mariadb-server mariadb-devel

# 安装完成MariaDB，首先启动MariaDB
systemctl start mariadb
# 设置开机启动
systemctl enable mariadb

# 接下来进行MariaDB的相关简单配置
mysql_secure_installation

#首先是设置密码，会提示先输入密码
Enter current password for root (enter for none):# 初次运行直接回车

#设置密码
Set root password? [Y/n] # 是否设置root用户密码，输入y并回车或直接回车
New password: # 设置root用户的密码
Re-enter new password: # 再输入一次你设置的密码

#其余配置
Remove anonymous users? [Y/n] # 是否删除匿名用户
Disallow root login remotely? [Y/n] #是否禁止root远程登陆
Remove test database and access to it? [Y/n] # 是否删除test数据库
Reload privilege tables now? [Y/n] # 是否从新加载权限表

#初始化MariaDB完成，接下来测试登陆
mysql -uroot -ppassword
复制代码

注意：切记安装 mariadb-devel （Ubuntu 下是 mysql-dev 或 libmysqlclient-dev）不然在下面安装 Python 的 mysqlclient 包的时候可能会出现 mysql_config not found 的错误。

2. Python3 的安装与部署

在 CentOS 中默认安装了 Python2 若是你是基于 Python2 开发的话能够直接使用，但也要注意版本尽可能升级到 Python2 的最新版。

2.1 安装 Python3 所需依赖

CentOS 里面是 XXX-devel，若是在 Ubuntu 下安装则要改为 XXX-dev。

# 为 CentOS 系统增长编译功能
yum install -y gcc-c++

# 安装这些模块都是为了成功编译安装 Python3，防止出现各类异常
yum install -y wget openssl-devel bzip2-devel expat-devel gdbm-devel readline-devel sqlite-devel xz-devel tk-devel gdbm-devel

# 3.7版本须要一个新的包libffi-devel，安装此包以后再次进行编译安装便可。
yum install -y libffi-devel

# 安装这个模块是为了让 uwsgi 支持使用 -x 选项，能经过 xml 文件启动项目
yum install -y libxml*
复制代码

各个依赖的用途我就不展开讲了，若是好奇的话能够去百度，度娘都知道。

提醒一点：若是你以前已经尝试过一次安装而且失败了，能够看一下是否是少装了某项依赖，在依赖完整的状况下，安装完 Python3 后会自动附带安装 pip。

2.2 编译安装 Python3.X

点击查看 Python 官方 FTP 地址

# 点击上面的官方 FTP 地址选择你想要的版本和压缩方式，获取下载链接
# 本例以 Python3.6.3 为例
# 在合适的路径（推荐在用户根路径下如 /home 或者 /root ）下执行下载命令：
wget https://www.python.org/ftp/python/3.6.3/Python-3.6.3.tgz

# 下载完成后执行解压命令：
tar -zxvf Python-3.6.3.tar.gz

# 进入解压后的 Python-3.6.3 文件，依次执行如下命令：
# 编译设置将 Python3 安装到 /usr/local/python3/ 路径下
./configure --prefix=/usr/local/python3
make
make install

# 建立 Python3 软链接，方便直接在命令行使用 Python3 和 pip3 直接调用 Python3 和 pip3
ln -s /usr/local/python3/bin/python3.6 /usr/bin/python3
ln -s /usr/local/python3/bin/pip3 /usr/bin/pip3
复制代码

3.3 利用 pip3 安装必要的 Python 包

# 升级 pip3 到最新版本
pip3 install --upgrade pip
# 安装须要的包（ django djangorestframework mysqlclient ) 
pip3 install django djangorestframework mysqlclient
# 建立 django-admin 软链接
ln -s /usr/local/python3/bin/django-admin /usr/bin/django-admin
复制代码

3. uwsgi 的安装

本文推荐使用 pip3 直接下载安装 uwsgi 若想使用其余安装方法请自行百度。

# 下载安装 uwsgi
pip3 install uwsgi
# 建立 uwsgi 软链接
ln -s /usr/local/python3/bin/uwsgi /usr/bin/uwsgi3
复制代码

4. Django 项目建立或下载

在适合的位置用 django-admin startproject myproject 建立本身的项目，或者用 Git , FTP上传工具 等上传、克隆本身的项目，本文采用新建项目的方式呈现此过程：

# 在合适的地方建立用来存放 Django 项目的目录
mkdir /var/www
# 进入目录
cd /var/www
# 建立 Django 项目
django-admin startproject myproject
# 进入项目
cd myproject
# 查看项目目录
ls
myproject manage.py
# 其中 myproject 为项目配置文件目录 manage.py 为 Django 命令行工具
# 记住我刚刚定义的几个名词：
# 项目目录：/var/www/myproject 
# 项目配置文件目录：/var/www/myproject/myproject 
# 这在后面的配置中有很大的做用千万别搞混
# 下面，进入项目配置文件目录修改部署须要的配置
cd myproject
vim settings.py
# 必须修改的有（本设置不适合在上线项目中使用）
# 1. 修改 ALLPWED_HOSTS = ['*']
# 2. 修改 DATABASES 以下（相应位置改成你的项目的相应值）：
DATABASES = {                                 
    'default': {                              
        'ENGINE': 'django.db.backends.mysql', # 数据库类型
        'NAME': 'test', # 项目数据库名称 
        'HOST': '127.0.0.1',  # 数据库地址 
        'PORT': '3306', # 端口号 
        'USER': 'root', # 数据库用户名 
        'PASSWORD': 'root', # 数据库密码 
    }                                         
}
# 注意：若是你是上传的本身在本地环境写好的程序别忘了同步数据库
复制代码

5. uwsgi 设置

在适当的目录下建立 uwsgi 配置文件。 本文采用 xml 配置文件，须要更多类型配置文件请自行百度。

# 进入项目目录
cd /var/www/myproject
# 建立编辑 uwsgi 配置文件（文件名自起）
vim uwsgiset.xml
# 内容以下
<uwsgi>
    <socket>127.0.0.1:8997</socket><!-- 内部端口，自定义 -->
    <chdir>/var/www/myproject</chdir><!-- 项目目录 -->
    <module>myproject.wsgi</module><!-- wsgi 启动文件 -->
    <processes>4</processes> <!-- 进程数 -->
    <daemonize>uwsgi.log</daemonize><!-- 日志文件路径 -->
    <pidfile>uwsgi.pid</pidfile><!-- uwsgi 管理文件路径，用来重启 uwsgi -->
</uwsgi>
# 更多配置信息请自行百度
# 在项目目录（ /var/www/myproject ）下启动：
uwsgi3 -x uwsgiset.xml
# 提醒 [uWSGI] parsing config file myproject.xml 则启用成功
# 注意仅仅是启用成功
复制代码

6. nginx 下载、设置和启用

# [必须]安装 nginx 须要先将官网下载的源码进行编译，编译依赖 gcc 环境，若是没有 gcc 环境，则须要安装：
yum install -y gcc-c++

# [必须]PCRE(Perl Compatible Regular Expressions) 是一个Perl库，包括 perl 兼容的正则表达式库。nginx 的 http 模块使用 pcre 来解析正则表达式，因此须要在 linux 上安装 pcre 库，pcre-devel 是使用 pcre 开发的一个二次开发库。nginx也须要此库。命令：
yum install -y pcre pcre-devel

# [自选]zlib 库提供了不少种压缩和解压缩的方式， nginx 使用 zlib 对 http 包的内容进行 gzip ，因此须要在 Centos 上安装 zlib 库。
yum install -y zlib zlib-devel

# [自选]nginx 不只支持 http 协议，还支持 https（即在ssl协议上传输http），因此须要在 Centos 安装 OpenSSL 库。
yum install -y openssl openssl-devel

# 官网下载 Ngxin
# 直接下载.tar.gz安装包，地址：https://nginx.org/en/download.html
# 推荐选择稳定版下载 ： 当前版本 1.12.2
# 下载连接： https://nginx.org/download/nginx-1.12.2.tar.gz
wget -c https://nginx.org/download/nginx-1.12.2.tar.gz

# 解压 用到了以前下载的zlib库 若没下载可选择其余方式解压
tar -zxvf nginx-1.12.2.tar.gz

# 编译前初始化配置
cd nginx-1.12.2 # 进入nginx目录
./configure # 使用默认配置

# 编译安装
make
make install

# 查找安装路径
[root@Ryoma nginx-1.12.2]#whereis nginx
nginx: /usr/local/nginx

# 启动、中止 nginx
cd /usr/local/nginx/sbin/ # 进入 nginx sbin 目录
./nginx # 启动 nginx
./nginx -s quit # 此方式中止步骤是待 nginx 进程处理任务完毕进行中止
./nginx -s stop # 此方式至关于先查出 nginx 进程id再使用kill命令强制杀掉进程
./nginx -s reload # 从新加载

#查询 nginx 进程：
ps aux|grep nginx

# 配置 nginx
vim /usr/local/nginx/conf/nginx.conf
# 我的配置图以下
复制代码

# :wq保存后进入 /usr/local/nginx/sbin/ 目录
# 先检查配置文件是否有错
./nginx -t
# 没有错就执行如下命令：
./nginx
# 终端没有任何提示就证实 nginx 启动成功，能够经过连接查看 nginx 是否启动成功:
# http://192.168.1.111 （请将该ip替换成你的服务器ip）
复制代码

若出现 nginx 错误，请自行查阅 nginx 错误日志 （默认在 /usr/local/ngxin/logs/error.log） 若出现 internal server error，请查看 uwsgi 日志 （位置请看 uwsgi xml 配置文件）

理论上来讲到这里你就能看到你的 Django 项目启动成功了，若是过程当中出现了任何你本身没法解决的问题，欢迎留言或邮件（ryomahan1996#gmail.com）联系我。