在『服务器部署 Vue 和 Django 项目的全记录』一文中,介绍了在服务器中使用 Nginx 部署前后端项目的过程。然而,当 Web 应用流量增多时,需要考虑负载均衡、流量分发、容灾等情况,原生的部署方式通常难以满足需求。此时,引入 Docker 部署多节点,能够在单台高性能服务器或服务器集群中搭建更完善的部署架构。
本文主要以 Vue 和 Django 项目为例介绍 Docker 部署的流程,稍带 Docker 简介和基础的 Nginx 负载均衡配置。
Docker 简介与安装
简单介绍 Docker 相关概念,具体需要读者另外学一学,推荐『Docker-从入门到实践』
Docker 是什么
Docker 是一个开源的应用容器引擎,可以让开发者打包应用和依赖到一个轻量级、可移植的容器中,并发布到任何流行的 Linux 机器上,也可以实现虚拟化。容器使用沙箱机制,相互之间不存在接口,其与宿主机通过端口转发进行通信,性能开销低。
Docker 部署 Web 应用有以下优点:
- 容器适合持续集成和持续交付(CI/CD)流程
- 响应式部署和扩展,其可移植性和轻量级的特性支持实时扩展或拆除服务
- Docker 轻巧快速,支持开发者在同一机器上运行更多工作负载
Docker 工作流程
Docker 包括三个概念:
- 镜像(Image):相当于一个 root 文件系统。
- 容器(Container):镜像和容器的关系类似于对象程序设计中的类和实例,镜像是静态的定义,容器是镜像运行时的实体。容器可以被创建、启动、停止、删除、暂停等。
- 仓库(Repository):仓库可看成一个代码控制中心,用来保存镜像。
Docker 的工作流程通常为:
- 从仓库中拉取(pull)官方或基准镜像
- 在 Dockerfile 中描述应用和安装依赖的指令,构建镜像
- 由镜像创建和运行容器
Docker 安装
见『Ubuntu 安装 Docker 环境』.
部署架构
在不考虑多节点负载均衡时,本文的部署架构如下:
前后端项目分离部署,分别部署在两个 Nginx 节点,对应两个域名或两个端口。
Nginx + Docker 部署前端
首先,Vue 项目打包为 dist 文件夹,同目录下新建 Dockerfile
、vhosts.conf
文件和 logs
文件夹,作用见下列代码块中的注释。
.├── dist # Vue 项目打包用以部署的文件夹├── Dockerfile # 用于建立 Docker 镜像├── vhosts.conf # 容器中启动 Nginx 服务的配置文件└── logs # 映射容器中的 Nginx 日志目录,以便在宿主机查看日志
Dockerfile
文件内容:
# 设置基础镜像FROM nginx:latest#设置CTS时区RUN cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo 'Asia/Shanghai' > /etc/timezone# 将dist文件中的内容复制到 /usr/share/nginx/html/ 这个目录下面COPY ./dist /usr/share/nginx/html/#用本地的 vhosts.conf 配置来替换 nginx 镜像里的默认配置COPY vhosts.conf /etc/nginx/conf.d/vhosts.conf
vhosts.conf
文件内容:
server { listen 80; server_name localhost; access_log /var/log/nginx/host.access.log main; error_log /var/log/nginx/error.log error; location / { root /usr/share/nginx/html; index index.html index.htm; try_files $uri $uri/ /index.html; } error_page 500 502 503 504 /50x.html; location = /50x.html { root /usr/share/nginx/html; }}
构建 Docker 镜像
在终端中输入以下命令,根据 Dockerfile
构建镜像。
docker build -f Dockerfile -t nginx/hsheng-mall:v1.0.0 .# 镜像名称:nginx/hsheng-mall# 版本号:v1.0.0
运行 Docker 容器
依据创建的镜像 nginx/hsheng-mall:v1.0.0
运行容器。
docker run -d -p 8081:80 --name=hsheng-mall -v /home/hsheng/www/hsheng-mall/logs:/var/log/nginx nginx/hsheng-mall:v1.0.0# 宿主机 8081 端口映射容器 80 端口# 容器名称:hsheng-mall# 宿主机 /home/hsheng/www/hsheng-mall/logs 目录映射容器 /var/log/nginx 目录# 镜像名称:nginx/hsheng-mall:v1.0.0
宿主机 Nginx 转发
与原生 Nginx 部署类似,在 /etc/nginx/conf.d
目录下创建配置文件 hsheng-mall.conf
,内容如下:
server { listen 443 ssl; # 端口,若部署 https 域名则为 443 server_name aaa.abc.com; # 域名或 IP location / { proxy_pass http://127.0.0.1:8081; # 转发本机(宿主机) 8081 端口,已与 Docker 端口建立映射 proxy_redirect default; } ssl_certificate /home/hsheng/www/hsheng-mall/ssl_certs/aaa.abc.com_bundle.crt; # ssl证书绝对路径 ssl_certificate_key /home/hsheng/www/hsheng-mall/ssl_certs/aaa.abc.com.key; # ssl证书私钥绝对路径 ssl_session_timeout 5m; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE; ssl_prefer_server_ciphers on;}server { listen 80; server_name aaa.abc.com; # 把http的域名请求转成https return 301 https://$host$request_uri;}
而后重启 Nginx 服务,即可通过 server_name
访问 Docker 的应用服务。
sudo nginx -s reload
Nginx + Docker 部署 uWSGI 后端
项目部署目录结构如下:
.├── src # Django 项目源码│ ├── manage.py│ ├── requirements.txt # Python 项目依赖包│ ├── uwsgi.ini # uWSGI 配置文件│ ├── start.sh # Django 服务启动脚本| └── ...├── Dockerfile # 用于建立 Docker 镜像└── logs # 映射容器中的 uWSGI 日志目录,以便在宿主机查看日志
Dockerfile
文件内容:
FROM python:3.8RUN cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo 'Asia/Shanghai' > /etc/timezoneRUN mkdir -p /var/www/html/backendCOPY ./src /var/www/html/backend/WORKDIR /var/www/html/backendRUN pip install -i https://pypi.doubanio.com/simple uwsgiRUN pip install -i https://pypi.doubanio.com/simple/ -r requirements.txt# Windows环境下编写的start.sh每行命令结尾有多余的\r字符,需移除RUN sed -i 's/\r//' ./start.shRUN chmod +x ./start.sh
uwsgi.ini
文件内容:
[uwsgi]socket = 0.0.0.0:8000 # 容器内 uWSGI 服务须为 0.0.0.0,以便与宿主机建立正常连接project = backendbase = /var/www/htmlbase-app = hshengmallchdir = %(base)/%(project)wsgi-file = %(base)/%(project)/%(base-app)/wsgi.pymaster = trueprocesses = 8threads = 4enable-threads = truebuffer-size = 65536post-buffering = 32768vacuum = truepidfile = %(base)/uwsgi/%(project)-master.piddaemonize = %(base)/uwsgi/uwsgi.logchmod-socket = 664# 设置一个请求的超时时间(秒),如果一个请求超过了这个时间,则请求被丢弃harakiri = 300# 当一个请求被harakiri杀掉会,会输出一条日志harakiri-verbose = true
start.sh
文件内容:
python manage.py makemigrations&&python manage.py migrate&&uwsgi --ini /var/www/html/backend/uwsgi.ini
构建 Docker 镜像
在终端中输入以下命令,根据 Dockerfile
构建镜像。
docker build -f Dockerfile -t python/hsheng-mall-backend:v1.0.0 .
运行 Docker 容器
依据创建的镜像 python/hsheng-mall-backend:v1.0.0
运行容器。
docker run -it -p 8001:8000 --name=hsheng-mall-backend -v /home/hsheng/www/hsheng-mall-backend/logs:/var/www/html/uwsgi -d python/hsheng-mall-backend:v1.0.0
启动服务
进入容器:
docker exec -it /bin/bash
运行启动脚本:
./start.sh
这样即成功启动了一个后端服务容器,若想做多节点负载均衡,可以修改端口映射关系,按上述步骤多创建和启动几个容器。
宿主机 Nginx 转发
在 /etc/nginx/conf.d
目录下创建配置文件 hsheng-mall-backend.conf
,内容如下:
server { listen 443 ssl; server_name api-aaa.abc.com; location / { include /etc/nginx/uwsgi_params; uwsgi_pass 127.0.0.1:8001; # 转发本机(宿主机) 8001 端口,已与 Docker 端口建立映射 } ssl_certificate /home/hsheng/www/hsheng-mall-backend/ssl_certs/api-aaa.abc.com_bundle.crt; ssl_certificate_key /home/hsheng/www/hsheng-mall-backend/ssl_certs/api-aaa.abc.com.key; ssl_session_timeout 5m; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE; ssl_prefer_server_ciphers on;}server { listen 80; server_name api-aaa.abc.com; return 301 https://$host$request_uri;}
而后重启 Nginx 服务,即可通过 server_name
请求后端服务。
sudo nginx -s reload
*Nginx 负载均衡
简略描述一个负载均衡的结构:Nginx + Docker 多节点部署架构。
前端节点为静态节点,通常只需要单个节点即可,可使用 CDN 加速优化访问。因此,当请求流量大时,主要通过增多后端 Docker+uWSGI 节点进行负载均衡。
为实现上图架构,首先根据本文第四章节「Docker 部署 uWSGI 后端节点」创建和启动 3 个 Docker 后端服务节点,分别映射至宿主机 8001 ~ 8003 端口。
而后,修改宿主机用于部署后端的 Nginx 配置文件,例如本文的 hsheng-mall-backend.conf
,添加 upstream
。修改后文件内容应为:
upstream uwsgicluster { server 127.0.0.1:8001; server 127.0.0.1:8002; server 127.0.0.1:8003;}server { listen 443 ssl; server_name api-aaa.abc.com; location / { include /etc/nginx/uwsgi_params; uwsgi_pass uwsgicluster # 转发上游集群 } ssl_certificate /home/hsheng/www/hsheng-mall-backend/ssl_certs/api-aaa.abc.com_bundle.crt; ssl_certificate_key /home/hsheng/www/hsheng-mall-backend/ssl_certs/api-aaa.abc.com.key; ssl_session_timeout 5m; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE; ssl_prefer_server_ciphers on;}server { listen 80; server_name api-aaa.abc.com; return 301 https://$host$request_uri;}
可以看到,与单节点不同之处在于,新增了 upstream
定义,并将 uwsgi_pass
修改为定义的 upstream
名称。
在配置文件中,还能设置各个节点的权重分配等,此处不展开介绍,默认为轮询方式,请求随机派发到各节点。