这是我参与8月更文挑战的第31天，活动详情查看： 8月更文挑战

微信公众号搜索 程序媛小庄 人生苦短 一起学Python

项目简单说明

• 前后端分离项目上线部署文档
• vue+django+nginx+uwsgi

一：服务器准备篇

购买服务器

# 购买阿里云服务器
	公网ip
	安装Centos镜像
    root用户和密码
    安全组中开放常用端口：22、80、3306、6379等

远程连接工具准备

FinalShell：# ss连接
WinScp:		# 文件图形界面上传工具

安装软件前准备

# 更新系统软件包
yum update -y

# 安装开发工具包和可能使用的依赖
yum -y groupinstall "Development tools"
yum install openssl-devel bzip2-devel expat-devel gdbm-devel readline-devel sqlite-devel psmisc libffi-devel

# 安装的开发工具包中含有 git,检验是否是否安装成功
git

二：软件安装篇

安装MySQL

1）前往root用户家目录
>: cd ~

2）下载mysql57
>: wget http://dev.mysql.com/get/mysql57-community-release-el7-10.noarch.rpm

也可以本地上传，这条命令要在本地终端上执行
>: scp -r C:\Users\dell\Desktop\pkg\mysql57-community-release-el7-10.noarch.rpm root@39.99.192.127:~

3）安装mysql57
>: yum -y install mysql57-community-release-el7-10.noarch.rpm
>: yum -y install mysql-community-server

4）启动mysql57并查看启动状态
>: systemctl start mysqld.service
>: systemctl status mysqld.service

5）查看默认密码并登录
>: grep "password" /var/log/mysqld.log
>: mysql -uroot -p

6）修改密码：本地登陆和远程登陆
>: ALTER USER 'root'@'localhost' IDENTIFIED BY 'new password';
>: ALTER USER 'root'@'%' IDENTIFIED BY 'new password';
    
    
# 注意：
	mysql默认使用3306端口，
    如果需要远程链接mysql，需要在阿里云安全组中开放3306端口，如果使用的防火墙也需要再在防火墙中开放3306端口

安装Redis

1）前往root用户家目录
>: cd ~

2）下载redis-5.0.5
>: wget http://download.redis.io/releases/redis-5.0.5.tar.gz
>: scp -r C:\Users\dell\Desktop\pkg\redis-5.0.5.tar.gz root@39.99.192.127:~

3）解压安装包
>: tar -xf redis-5.0.5.tar.gz

4）进入目标文件
>: cd redis-5.0.5

5）编译环境
>: make

6）复制环境到指定路径完成安装，将编译好的文件夹拷贝到/usr/local/redis
>: cp -r ~/redis-5.0.5 /usr/local/redis

7）配置redis可以后台启动：修改下方内容
>: vim /usr/local/redis/redis.conf

daemonize yes
requirepass your_password


8）完成配置修改
>: esc
>: :wq

9）建立软连接
>: ln -s /usr/local/redis/src/redis-server /usr/bin/redis-server
>: ln -s /usr/local/redis/src/redis-cli /usr/bin/redis-cli

10）后台运行redis
>: cd /usr/local/redis
>: redis-server ./redis.conf &

ctrl + c

11）测试redis环境
>: redis-cli
>: auth your_password
ctrl + c

12）关闭redis服务
>: pkill -f redis -9
    
    
# 注意：
	redis默认使用6379端口，
    如果需要远程链接redis，需要在阿里云安全组中开放6379端口，如果使用的防火墙也需要再在防火墙中开放6379端口
    本地终端远程链接阿里云redis：redis-cli -h 公网ip -p your_password

安装Python3.6

1）前往root用户家目录
>: cd ~

2）下载 或 上传 Python3.6.7
# 服务器终端
>: wget https://www.python.org/ftp/python/3.6.7/Python-3.6.7.tar.xz

# 本地终端，给服务器上传
>: scp -r 本地Python-3.6.7.tar.xz ssh root@39.99.192.127:服务器路径
>: scp -r C:\Users\dell\Desktop\pkg\Python-3.6.7.tar.xz ssh root@39.99.192.127~

3）解压安装包
>: tar -xf Python-3.6.7.tar.xz

4）进入目标文件
>: cd Python-3.6.7

5）配置安装路径：/usr/local/python3
>: ./configure --prefix=/usr/local/python3

6）编译并安装
>: make && sudo make install

7）建立软连接：终端命令 python3，pip3
>: ln -s /usr/local/python3/bin/python3.6 /usr/bin/python3
>: ln -s /usr/local/python3/bin/pip3.6 /usr/bin/pip3

8）删除安装包与文件：
>: rm -rf Python-3.6.7
>: rm -rf Python-3.6.7.tar.xz
    
    
# 注意：
	Centos默认安装了python2.7，我们不实用它但是不要强行删除卸载它；因为操作系统有部分需要依赖py2.7
    配置pip下载源，阿里云上可以不用配置，默认使用阿里源
    具体配置方式如下：
        1）创建pip配置路径
        	mkdir ~/.pip

        2）进入目录编辑配置文件：填入下方内容
        	cd ~/.pip && vim pip.conf

            [global]
            index-url = http://pypi.douban.com/simple
            [install]
            use-mirrors =true
            mirrors =http://pypi.douban.com/simple/
            trusted-host =pypi.douban.com
    

安装虚拟环境

1）安装依赖
>: pip3 install virtualenv
>: pip3 install virtualenvwrapper

2）建立虚拟环境软连接
>: ln -s /usr/local/python3/bin/virtualenv /usr/bin/virtualenv

3）配置虚拟环境：填入下方内容
>: vim ~/.bash_profile

VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
source /usr/local/python3/bin/virtualenvwrapper.sh

4）退出编辑状态
>: esc

5）保存修改并退出
>: :wq

6）更新配置文件内容，执行如下命令
>: source ~/.bash_profile

7）虚拟环境默认根目录：~/.virtualenvs
  查看确认：
    ll -a ~

安装Nginx

1）前往root用户家目录
>: cd ~

2）下载nginx1.13.7
>: wget http://nginx.org/download/nginx-1.13.7.tar.gz

3）解压安装包
>: tar -xf nginx-1.13.7.tar.gz

4）进入目标文件
>: cd nginx-1.13.7

5）配置安装路径：/usr/local/nginx
>: ./configure --prefix=/usr/local/nginx

6）编译并安装，这一步可能编译不成功，出现问题可参考本节补充的内容
>: make && sudo make install

7）建立软连接：终端命令 nginx
>: ln -s /usr/local/nginx/sbin/nginx /usr/bin/nginx

8）删除安装包与文件：
>: cd ~
>: rm -rf nginx-1.13.7
>: rm -rf nginx-1.13.7.tar.xz

9）测试Nginx环境，服务器运行nginx，本地访问服务器ip
>: nginx
>: 服务器绑定的域名 或 ip:80
        
        
# nginx常用指令
- 启动nginx
	nginx
- 关闭nginx
	nginx -s stop
- 重启nginx
	nginx -s reload
    
- 查看端口，强行关闭
	ps -aux | grep nginx
	kill <pid:进程编号>
        
        
"""
补充：
- 安装nginx时出现In function ‘ngx_murmur_hash2’等错误，参考：https://blog.csdn.net/zolewit/article/details/93595253
- 原因，是将警告当成了错误处理，打开/home/vagrant/nginx-1.11.2/objs/Makefile，
- 解决办法:
	- 进入nginx安装目录，vim打开objs/Makefile文件
	- 去掉或注释掉这一行： CFLAGS中的-Werror
    - 再重新make
"""

安装uwsgi

# 就是python的一个模块包，下载安装成一个可执行文件
1）在真实环境下安装
pip3 install uwsgi

2）建立软连接
ln -s /usr/local/python3/bin/uwsgi /usr/bin/uwsgi

3) 测试是否安装成功,输入uwsgi回车后出现指令提示即可
uwsgi


"""
补充：
	- 待会本地项目上传到服务器是需要运行在虚拟环境中的，需要在虚拟环境中也安装uwsgi
"""

三：前端项目部署篇

前端项目上线前配置

vue项目中的：src/assets/js/settings.js
# 后端django项目运行的ip+端口
base_url: '39.99.192.127:8000',  // 真实环境：django项目就是跑在8000端口上的

前端项目打包成dist文件夹

# 本地项目根路径终所在端操
1）本地项目打包，前往my_procity项目目录下
>: cnpm run build

2）本地终端上传dist文件夹到远程服务器root家目录
>: scp -r dist root@39.99.192.127:~

3) 远程链接到服务器root家目录
>：cd ~
        
4）移动并重命名，将该dist文件夹移动到/home/下并改名成html文件夹
mv ~/dist /home/html

Nginx配置转发前端静态页面

1) 去向Nginx配置目录，备份配置，完全更新配置：使用插入模式并填入下方分割线一下的内容
>: cd /usr/local/nginx/conf
>: mv nginx.conf nginx.conf.bak
>: vim nginx.conf			
>: i

# ########################################## 我是分割线 ##########################################

events {
    worker_connections  1024;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    server {
        listen 80;
        server_name  127.0.0.1; 				# 改为自己的域名，没域名修改为127.0.0.1:80
        charset utf-8;
        location / {
            root /home/html; 					# html访问路径
            index index.html; 					# html文件名称
            try_files $uri $uri/ /index.html; 	  # 解决单页面应用刷新404问题
        }
    }
}   

2）按ESC键从插入模式切换到命令行模式，输入:wq，保存并退出vim
>: :wq

3）重启nginx
>: nginx -s reload
    
    
4）浏览器测试前端页面
	- 浏览器中输入公网ip地址，如果出现前段项目页面则标识nginx前端页面转发成功

四：后端项目部署篇

后端项目上线前准备

线上版配置文件

# 线上版配置文件设置settings/prod.py
# 复制本地开发时的配置文件settings/dev.py到prod.py修改补充如下内容

1) 关闭测试环境
DEBUG = False
ALLOWED_HOSTS = [
    '39.99.192.127'  # 公网ip地址，或者使用 '*'
]



2) 静态文件配置, 新增STATIC_ROOT、STATICFILES_DIRS
STATIC_URL = '/static/'
STATICFILES_DIRS = (os.path.join(BASE_DIR, "static"), )
STATIC_ROOT = '/home/project/my_proapi/my_proapi/static'  	
# STATIC_ROOT用于收集xadmin等使用的静态文件,该目录是后端项目的目录路径，static文件是用于nginx转发时找的文件夹


# 后台http根路径
BASE_URL = 'http://39.99.192.127:8000'
# 前台http根路径
my_pro_URL = 'http://39.99.192.127:80'

# 订单支付成功的后台异步回调接口
NOTIFY_URL = BASE_URL + '/order/success/'
# 订单支付成功的前台同步回调接口
RETURN_URL = my_pro_URL + '/order/pay/success/'

修改wsgi.py文件

# 该文件是uwsgi拉起django的文件
# 需要做上线修改的内容
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'my_proapi.settings.prod')

自动导出项目依赖模块

1）进入本地项目根目录终端

2）本地导出项目环境
>: pip3 freeze > requirements.txt

3）如果环境中有特殊的安装包，需要处理一下xadmin
requirements.txt中的
	xadmin==2.0.1
要被替换为
	https://codeload.github.com/sshwsfc/xadmin/zip/django2

git中设置忽略文件

# 忽略某些不需要上传到远程的文件及文件夹
1) 项目根路径下，新建 .gitignore文件
2) 打开填入一下内容
    /.idea
    /scripts
    my_pro.log
    *.pyc
    
    
# 需要注意的是：空文件夹不会被git管理，所以最好间package,包含__init__.py文件夹

项目提交到远程仓库

1）去向本地项目仓库
>: cd 项目根目录

2）本地版本库操作
>: git status
>: git add .
>: git commit -m '项目2.0上线'

3）提交到远程版本库
>: git pull origin master
>: git push origin master

后端项目线上准备

git克隆下载线上项目代码

1）创建存放后台项目的目录
>: mkdir /home/project

2）进入后台项目管理目录同步git仓库中的项目
>: cd /home/project
>: git clone https://gitee.com/doctor_owen/my_proapi.git		# 替换为你自己项目的git地址

创建项目虚拟环境

1）创建线上my_pro项目虚拟环境并进入虚拟环境
>: mkvirtualenv my_pro
>: workon my_pro

2): 在虚拟环境中也安装uwsgi
>: pip install uwsgi
    
2）安装所需项目依赖模块requirements.txt
>: cd requirements.txt所在目录
>: pip install -r requirements.txt
    
    
# 如果出现django版本和模块冲突的问题，可以再手动pip下载安装   

数据库设置

1）管理员连接数据库
>: mysql -uroot -pOwen1234?

2）创建数据库
>: create database my_proapi default charset=utf8;

3）设置权限账号密码：账号密码要与项目中配置的一致
>: grant all privileges on my_proapi.* to 'my_proapi'@'%' identified by 'my_pro123?';
>: grant all privileges on my_proapi.* to 'my_proapi'@'localhost' identified by 'my_pro123?';
>: flush privileges;

4）退出mysql
>: quit;

数据库迁移

# 必须在my_pro虚拟环境下
1）数据库迁移
>: cd /home/project/my_proapi/
>: python manage_prod.py makemigrations    
>: python manage_prod.py migrate

2）创建超级用户
>: python manage_prod.py createsuperuser
# 账号密码：admin|Admin123


"""
注意：django版本问题的报错：

- 如果django不是2.0.7的其他版本，数据库迁移保存解决方案：修改源码
    1）修改base.py源码
    >: vim /root/.virtualenvs/my_pro/lib/python3.6/site-packages/django/db/backends/mysql/base.py
    方案：36，37行注释掉

    2）修改operations.py源码
    >: vim /root/.virtualenvs/my_pro/lib/python3.6/site-packages/django/db/backends/mysql/operations.py
    方案：146行修改
        query = query.encode()
"""

创建超级用户

2）创建超级用户
>: python manage_prod.py createsuperuser
# 账号密码：admin|Admin123

后端项目Nginx和uwsgi配置

uwsgi配置

1）进行uwsgi服务配置，新建如下文件，并添加分割线一下的内容
>: vim /home/project/my_proapi/my_proapi.xml

# ####################################### 我是分割线 ############################################
<uwsgi>    
   <socket>127.0.0.1:8808</socket> 		<!-- 内部端口，自定义 --> 
   <chdir>/home/project/my_proapi/		</chdir> <!-- 项目路径 -->            
   <module>my_proapi.wsgi</module>  		<!-- my_proapi为wsgi.py所在目录名--> 
   <processes>4</processes> 			<!-- 进程数 -->     
   <daemonize>uwsgi.log</daemonize> 	<!-- 日志文件 -->
</uwsgi>

Nginx更新配置

# 增加nginx分发后端项目的配置

1）去向Nginx配置目录，备份配置，完全更新配置：填入分割线以下的内容
>: vim /usr/local/nginx/conf/nginx.conf

# ########################################## 我是分割线 ##############################################
events {
    worker_connections  1024;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    server {
        listen 80;
        server_name  127.0.0.1; # 改为自己的域名，没域名修改为127.0.0.1:80
        charset utf-8;
        location / {
            root /home/html; # html访问路径
            index index.html; # html文件名称
            try_files $uri $uri/ /index.html; # 解决单页面应用刷新404问题
        }
    }
    # 新增的server
    server {
        listen 8000;
        server_name  127.0.0.1; # 改为自己的域名，没域名修改为127.0.0.1:80
        charset utf-8;
        location / {
           include uwsgi_params;
           uwsgi_pass 127.0.0.1:8808;  # 端口要和uwsgi里配置的一样
           uwsgi_param UWSGI_SCRIPT my_proapi.wsgi;  #wsgi.py所在的目录名+.wsgi
           uwsgi_param UWSGI_CHDIR /home/project/my_proapi/; # 项目路径
        }
    }
} 

启动uwsgi和nginx测试

"""
1）启动uwsgi
>: uwsgi -x /home/project/my_proapi/my_proapi.xml

2）重启nginx
>: nginx -s reload
"""

后端样式静态文件收集

迁移静态文件样式

1）项目目录下没有 static 文件夹需要新建
>: mkdir /home/project/my_proapi/my_proapi/static

2）完成静态文件迁移
>: python /home/project/my_proapi/manage_prod.py collectstatic
    
    
# 执行静态文件收集命令需要实现在配置文件/manage_prod.py中设置好两个参数：
	- STATICFILES_DIRS = (os.path.join(BASE_DIR, "static"), )
	- STATIC_ROOT = '/home/project/my_proapi/my_proapi/static'  	
# STATIC_ROOT用于收集xadmin等使用的静态文件,该目录是后端项目的目录路径，static文件是用于nginx转发时找的文件夹

nginx配置更新静态文件

1）修改nginx配置
>: vim /usr/local/nginx/conf/nginx.conf

events {
    worker_connections  1024;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    server {
        listen 80;
        server_name  127.0.0.1; # 改为自己的域名，没域名修改为127.0.0.1:80
        charset utf-8;
        location / {
            root /home/html; # html访问路径
            index index.html; # html文件名称
            try_files $uri $uri/ /index.html; # 解决单页面应用刷新404问题
        }
    }
    server {
        listen 8000;
        server_name  127.0.0.1; # 改为自己的域名，没域名修改为127.0.0.1:80
        charset utf-8;
        location / {
           include uwsgi_params;
           uwsgi_pass 127.0.0.1:8808;  # 端口要和uwsgi里配置的一样
           uwsgi_param UWSGI_SCRIPT my_proapi.wsgi;  #wsgi.py所在的目录名+.wsgi
           uwsgi_param UWSGI_CHDIR /home/project/my_proapi/; # 项目路径
        }
        # 新增的配置静态文件
        location /static {
            alias /home/project/my_proapi/my_proapi/static;
        }
    }
}

2）退出
>: esc
>: :wq

启动服务

1）关闭 uwsgi，重新启动 uwsgi
pkill -f uwsgi -9
uwsgi -x /home/project/my_proapi/my_proapi.xml


2）关闭 nginx，重新启动 nginx
nginx -s stop
nginx

五：线上项目测试

1）本地浏览器访问xadmin后台
http://39.99.192.127:8000/xadmin

2）登录，录入测试数据
# 账号密码：admin|Admin123

3）或是导出本地数据库为sql，再在线上导入sql
>: mysql -h 39.99.192.127 -P 3306 -u my_pro -p
>: my_pro123?
>: use my_pro
>: 复制之前的数据备份

六：重点

# 1、真实环境和虚拟环境都要安装uwsgi，将真实环境下的uwsgi建立软连接

# 2、redis服务一定要后台启动：redis-server &

# 3、uwsgi启动django项目一定要进入虚拟环境下，因为环境都是安装在虚拟环境中

# 4、服务器的日志都会被记录在于uwsgi配置文件 my_proapi.xml 同类目下的 uwsgi.log 中

结语

文章首发于微信公众号程序媛小庄，同步于掘金。

码字不易，转载请说明出处，走过路过的小伙伴们伸出可爱的小指头点个赞再走吧(╹▽╹)