这是我参与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 中
结语
文章首发于微信公众号程序媛小庄，同步于掘金。
码字不易，转载请说明出处，走过路过的小伙伴们伸出可爱的小指头点个赞再走吧(╹▽╹)
