112 lines
3.7 KiB
Markdown
112 lines
3.7 KiB
Markdown
|
# 架构变化
|
|||
|
|
```
|
|||
|
|
用户访问域名
|
|||
|
|
↓
|
|||
|
|
腾讯云 CLB（负载均衡）
|
|||
|
|
↓
|
|||
|
|
Ingress Controller（Ingress Pod）
|
|||
|
|
↓
|
|||
|
|
前端 Nginx Pod（静态资源）
|
|||
|
|
↓
|
|||
|
|
后端服务 Pod
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 原架构：前后端一体反代
|
|||
|
|
|
|||
|
|
- 拓扑：
|
|||
|
|
DNS -> Nginx（域名证书 + 静态资源 + 反向代理） -> 后端服务
|
|||
|
|
- 特点：
|
|||
|
|
- 域名证书与反向代理配置在同一 Nginx 配置文件中
|
|||
|
|
- Nginx 承担两种职责：
|
|||
|
|
- 提供前端静态资源（HTML / JS / CSS）
|
|||
|
|
- 反向代理接口到后端服务
|
|||
|
|
|
|||
|
|
## Kubernetes 化后的角色拆分
|
|||
|
|
|
|||
|
|
| 原功能 | Kubernetes 中的角色 | 描述 |
|
|||
|
|
|---|---|---|
|
|||
|
|
| SSL 终止 / 域名路由 | Ingress Controller（如 NGINX Ingress、Traefik） | 负责 HTTPS 证书管理、域名路由与转发 |
|
|||
|
|
| 提供静态资源 | 前端 Pod（Nginx 容器） | 仅负责静态文件服务，不再负责后端代理 |
|
|||
|
|
| 应用后端 | 后端 Pod（Deployment + Service） | 提供 API 服务，由 Ingress 转发调用 |
|
|||
|
|
|
|||
|
|
## 前端 Pod 的 Docker 镜像
|
|||
|
|
- 仅提供静态资源，不负责代理：
|
|||
|
|
- 静态文件目录：`/usr/share/nginx/html/`，放编译好的前端静态文件
|
|||
|
|
- Nginx 配置：`/etc/nginx/conf.d/default.conf`，为简化版，仅用于静态服务
|
|||
|
|
- 示例 `default.conf`：
|
|||
|
|
```nginx
|
|||
|
|
server {
|
|||
|
|
listen 80;
|
|||
|
|
server_name _;
|
|||
|
|
|
|||
|
|
root /usr/share/nginx/html;
|
|||
|
|
index index.html;
|
|||
|
|
|
|||
|
|
location / {
|
|||
|
|
try_files $uri /index.html;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
- 该配置可放入 ConfigMap，或直接 bake 到镜像中。无需 `upstream` / `proxy_pass`，反代由 Ingress 处理。
|
|||
|
|
|
|||
|
|
## Ingress 取代原 nginx.conf 的“反向代理部分”
|
|||
|
|
- 示例 Ingress（由 Ingress Controller 生成对应的 Nginx 配置）：
|
|||
|
|
```yaml
|
|||
|
|
apiVersion: networking.k8s.io/v1
|
|||
|
|
kind: Ingress
|
|||
|
|
metadata:
|
|||
|
|
name: jennie-frontend
|
|||
|
|
namespace: jennie
|
|||
|
|
annotations:
|
|||
|
|
kubernetes.io/ingress.class: nginx
|
|||
|
|
cert-manager.io/cluster-issuer: letsencrypt-prod
|
|||
|
|
spec:
|
|||
|
|
tls:
|
|||
|
|
- hosts:
|
|||
|
|
- s1.jennie.im
|
|||
|
|
secretName: jennie-im-tls
|
|||
|
|
rules:
|
|||
|
|
- host: s1.jennie.im
|
|||
|
|
http:
|
|||
|
|
paths:
|
|||
|
|
- path: /
|
|||
|
|
pathType: Prefix
|
|||
|
|
backend:
|
|||
|
|
service:
|
|||
|
|
name: jennie-frontend
|
|||
|
|
port:
|
|||
|
|
number: 80
|
|||
|
|
- path: /api/
|
|||
|
|
pathType: Prefix
|
|||
|
|
backend:
|
|||
|
|
service:
|
|||
|
|
name: jennie-backend
|
|||
|
|
port:
|
|||
|
|
number: 8100
|
|||
|
|
- path: /sit-api/
|
|||
|
|
pathType: Prefix
|
|||
|
|
backend:
|
|||
|
|
service:
|
|||
|
|
name: sit-api
|
|||
|
|
port:
|
|||
|
|
number: 8070
|
|||
|
|
```
|
|||
|
|
- SSL 证书通过 Secret 提供，例如：
|
|||
|
|
`kubectl create secret tls jennie-im-tls --cert=... --key=...`
|
|||
|
|
- Ingress 的路由规则等同于原 `nginx.conf` 中的多个 `location` 块，Ingress Controller 自动生成底层配置。
|
|||
|
|
|
|||
|
|
## 请求流向对比
|
|||
|
|
- 旧：客户端 -> Nginx (SSL + 反代 + 静态资源) -> 后端
|
|||
|
|
- 新：客户端 -> Ingress Controller Pod (SSL 终止 + 路由) -> 前端 Pod 或 后端 Pod
|
|||
|
|
- 静态资源（/）由 Ingress 转发到前端 Pod
|
|||
|
|
- API 请求（/api/*）由 Ingress 转发到后端 Pod
|
|||
|
|
- 转发逻辑在 Ingress，不在前端 Pod 内
|
|||
|
|
|
|||
|
|
## ConfigMap、证书文件放置
|
|||
|
|
|
|||
|
|
| 项目 | 放置位置 | 说明 |
|
|||
|
|
|---|---|---|
|
|||
|
|
| 前端 `nginx.conf` | ConfigMap 或镜像内 | 若使用 Nginx 提供静态资源，可 bake 进镜像或挂载 ConfigMap |
|
|||
|
|
| SSL 证书 | Secret | `type: kubernetes.io/tls` |
|
|||
|
|
| Ingress 路由规则 | Ingress YAML | 替代原 `server` / `location` 的路由/反代配置 |
|