156 lines
2.6 KiB
Markdown
156 lines
2.6 KiB
Markdown
# 13 国内环境部署与运维
|
||
|
||
## 1. 目标
|
||
|
||
- 中国大陆访问稳定；
|
||
- 微信小程序合法域名可配置；
|
||
- TLS；
|
||
- 低维护成本；
|
||
- 可迁移；
|
||
- 可备份；
|
||
- 可回滚。
|
||
|
||
---
|
||
|
||
## 2. 推荐生产拓扑（初期）
|
||
|
||
```text
|
||
微信小程序
|
||
│ HTTPS
|
||
▼
|
||
Nginx / API Domain
|
||
│
|
||
▼
|
||
NestJS API (Docker)
|
||
├── MySQL
|
||
├── Redis
|
||
└── Tencent COS
|
||
|
||
管理后台
|
||
│ HTTPS
|
||
└────────► Nginx / API
|
||
```
|
||
|
||
管理后台静态资源可由 Nginx 或对象存储/CDN 托管。
|
||
|
||
---
|
||
|
||
## 3. 云厂商
|
||
|
||
优先腾讯云并非代码强绑定要求，而是微信生态和国内运维便利性考虑。
|
||
|
||
代码必须通过 Adapter 保持：
|
||
|
||
- COS 可替换 S3 兼容存储；
|
||
- Redis 可替换其他标准 Redis；
|
||
- MySQL 可迁移标准 MySQL；
|
||
- Nginx/Docker 不绑定专有 PaaS。
|
||
|
||
---
|
||
|
||
## 4. 国内依赖获取
|
||
|
||
开发机可根据实际环境配置：
|
||
|
||
- npm 国内镜像；
|
||
- Docker 镜像加速；
|
||
- 操作系统软件源镜像。
|
||
|
||
但：
|
||
|
||
- lockfile 必须提交；
|
||
- CI 至少验证标准 registry 可构建；
|
||
- 不依赖个人私服；
|
||
- 不在代码写死镜像地址。
|
||
|
||
---
|
||
|
||
## 5. 环境
|
||
|
||
### dev
|
||
|
||
开发者本机 Docker Compose。
|
||
|
||
### test
|
||
|
||
CI 自动化测试。
|
||
|
||
### staging
|
||
|
||
与生产拓扑尽量一致，使用测试小程序/测试账号。
|
||
|
||
### prod
|
||
|
||
真实用户。
|
||
|
||
严禁 dev 直连 prod 数据库。
|
||
|
||
---
|
||
|
||
## 6. 发布
|
||
|
||
建议：
|
||
|
||
1. CI build；
|
||
2. 生成 immutable image tag；
|
||
3. staging deploy；
|
||
4. migration precheck；
|
||
5. smoke test；
|
||
6. production backup；
|
||
7. production deploy；
|
||
8. health check；
|
||
9. E2E smoke；
|
||
10. 观察；
|
||
11. 出现严重问题回滚应用版本。
|
||
|
||
数据库 migration 必须设计可前后兼容，避免应用回滚后数据库不兼容。
|
||
|
||
---
|
||
|
||
## 7. 监控
|
||
|
||
至少：
|
||
|
||
- API availability
|
||
- 5xx rate
|
||
- P95 latency
|
||
- CPU/memory
|
||
- disk
|
||
- MySQL connection
|
||
- Redis connectivity
|
||
- job failures
|
||
- backup failures
|
||
|
||
告警进入实际有人查看的渠道。
|
||
|
||
---
|
||
|
||
## 8. 容灾
|
||
|
||
初期无需昂贵双活，但必须：
|
||
|
||
- 自动数据库备份；
|
||
- 异地/云端备份；
|
||
- IaC/部署脚本；
|
||
- Docker 镜像可重建；
|
||
- 文档化恢复；
|
||
- 定期演练。
|
||
|
||
---
|
||
|
||
## 9. 微信小程序上线准备
|
||
|
||
实际申请和上线阶段需要根据微信公众平台最新规则核对：
|
||
|
||
- 小程序主体
|
||
- 服务类目
|
||
- 隐私保护指引
|
||
- 用户信息/手机号等接口使用说明
|
||
- request/download/upload 合法域名
|
||
- HTTPS 证书
|
||
- 备案/域名要求
|
||
- 订阅消息模板
|
||
- 审核材料
|
||
|
||
微信平台规则可能变化，因此上线前必须重新查官方文档，不得只依赖本文件。
|