feat(aia): Complete AIA V2.0 with universal streaming capabilities
Major Changes: - Add StreamingService with OpenAI Compatible format - Upgrade Chat component V2 with Ant Design X integration - Implement AIA module with 12 intelligent agents - Update API routes to unified /api/v1 prefix - Update system documentation Backend (~1300 lines): - common/streaming: OpenAI Compatible adapter - modules/aia: 12 agents, conversation service, streaming integration - Update route versions (RVW, PKB to v1) Frontend (~3500 lines): - modules/aia: AgentHub + ChatWorkspace (100% prototype restoration) - shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook - Update API endpoints to v1 Documentation: - AIA module status guide - Universal capabilities catalog - System overview updates - All module documentation sync Tested: Stream response verified, authentication working Status: AIA V2.0 core completed (85%)
This commit is contained in:
@@ -1,14 +1,14 @@
|
||||
# 馃帀 鍓嶇<E98D93>Nginx - 閮ㄧ讲鎴愬姛鎬荤粨
|
||||
|
||||
> **部署完成时间**:2025-12-25 19:55
|
||||
> **閮ㄧ讲瀹屾垚鏃堕棿**锛?025-12-25 19:55
|
||||
> **闀滃儚鐗堟湰**锛歷1.0
|
||||
> **鍐呯綉鍦板潃**锛歚http://172.17.173.72:80`
|
||||
> **部署状态**:✅ 运行中
|
||||
> **健康检查**:✅ 通过(HTTP 200)
|
||||
> **閮ㄧ讲鐘舵€?*锛氣渽 杩愯<E69DA9>涓?
|
||||
> **鍋ュ悍妫€鏌?*锛氣渽 閫氳繃锛圚TTP 200锛?
|
||||
|
||||
---
|
||||
|
||||
## 📊 一、部署信息概览
|
||||
## 馃搳 涓€銆侀儴缃蹭俊鎭<E4BF8A><E98EAD>瑙?
|
||||
|
||||
### 搴旂敤閰嶇疆
|
||||
```yaml
|
||||
@@ -20,14 +20,14 @@
|
||||
|
||||
### 瀹炰緥瑙勬牸
|
||||
```yaml
|
||||
CPU: 0.5核
|
||||
CPU: 0.5鏍?
|
||||
鍐呭瓨: 1GB
|
||||
实例数: 1个
|
||||
瀹炰緥鏁? 1涓?
|
||||
瑙勬牸閫夋嫨鐞嗙敱:
|
||||
- 鍓嶇<EFBFBD>鍙<EFBFBD>彁渚涢潤鎬佽祫婧愬拰浠g悊杞<EFBFBD>彂
|
||||
- 资源消耗极低
|
||||
- 0.5核完全足够
|
||||
- 对比:后端需要1核2GB,Python需要1核2GB
|
||||
- 璧勬簮娑堣€楁瀬浣?
|
||||
- 0.5鏍稿畬鍏ㄨ冻澶?
|
||||
- 瀵规瘮锛氬悗绔<EFBFBD>渶瑕?鏍?GB锛孭ython闇€瑕?鏍?GB
|
||||
```
|
||||
|
||||
### 闀滃儚淇℃伅
|
||||
@@ -44,32 +44,32 @@ CPU: 0.5核
|
||||
```yaml
|
||||
鍐呯綉鍦板潃: http://172.17.173.72:80
|
||||
VPC: vpc-2ze055cptkew9c38w4r06
|
||||
安全组: sg-2zedk6fi8sgmmcwdu7tu
|
||||
瀹夊叏缁? sg-2zedk6fi8sgmmcwdu7tu
|
||||
鍏<EFBFBD>綉璁块棶: 鏃狅紙浠呭唴缃戯級
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 二、部署过程
|
||||
## 馃殌 浜屻€侀儴缃茶繃绋?
|
||||
|
||||
### 部署时间线
|
||||
### 閮ㄧ讲鏃堕棿绾?
|
||||
|
||||
| 鏃堕棿 | 鎿嶄綔 | 缁撴灉 |
|
||||
|------|------|------|
|
||||
| 11:50 | 创建SAE应用 | ✅ |
|
||||
| 11:52 | 配置容器镜像和实例规格 | ✅ |
|
||||
| 11:53 | 配置环境变量(后端地址) | ✅ |
|
||||
| 11:54 | 配置健康检查 | ✅ |
|
||||
| 11:54 | 部署应用 | ✅ |
|
||||
| 11:55 | 容器启动成功 | ✅ |
|
||||
| 11:55 | 健康检查通过 | ✅ |
|
||||
| 12:00 | 完整链路测试通过 | ✅ |
|
||||
| 11:50 | 鍒涘缓SAE搴旂敤 | 鉁?|
|
||||
| 11:52 | 閰嶇疆瀹瑰櫒闀滃儚鍜屽疄渚嬭<EFBFBD>鏍?| 鉁?|
|
||||
| 11:53 | 閰嶇疆鐜<EFBFBD><EFBFBD>鍙橀噺锛堝悗绔<EFBFBD>湴鍧€锛?| 鉁?|
|
||||
| 11:54 | 閰嶇疆鍋ュ悍妫€鏌?| 鉁?|
|
||||
| 11:54 | 閮ㄧ讲搴旂敤 | 鉁?|
|
||||
| 11:55 | 瀹瑰櫒鍚<EFBFBD>姩鎴愬姛 | 鉁?|
|
||||
| 11:55 | 鍋ュ悍妫€鏌ラ€氳繃 | 鉁?|
|
||||
| 12:00 | 瀹屾暣閾捐矾娴嬭瘯閫氳繃 | 鉁?|
|
||||
|
||||
**鎬昏€楁椂**锛氱害10鍒嗛挓锛堜竴娆℃垚鍔燂紝闆堕棶棰橈級
|
||||
|
||||
---
|
||||
|
||||
## ✅ 三、部署验证
|
||||
## 鉁?涓夈€侀儴缃查獙璇?
|
||||
|
||||
### 1. 鍚<>姩鏃ュ織楠岃瘉
|
||||
|
||||
@@ -86,14 +86,14 @@ nginx: configuration file /etc/nginx/nginx.conf test is successful
|
||||
|
||||
**楠岃瘉缁撴灉**锛氣渽 鎵€鏈夐厤缃<E58EA4><E7BC83>纭<EFBFBD>紝鍚<E7B49D>姩鎴愬姛
|
||||
|
||||
### 2. 静态资源测试
|
||||
### 2. 闈欐€佽祫婧愭祴璇?
|
||||
|
||||
**测试命令**:
|
||||
**娴嬭瘯鍛戒护**锛?
|
||||
```bash
|
||||
curl -I http://172.17.173.72/
|
||||
```
|
||||
|
||||
**测试结果**:
|
||||
**娴嬭瘯缁撴灉**锛?
|
||||
```http
|
||||
HTTP/1.1 200 OK
|
||||
Server: nginx
|
||||
@@ -102,16 +102,16 @@ Content-Length: 458
|
||||
Cache-Control: no-cache, no-store, must-revalidate
|
||||
```
|
||||
|
||||
**验证结果**:✅ 静态资源正常提供
|
||||
**楠岃瘉缁撴灉**锛氣渽 闈欐€佽祫婧愭<E5A9A7>甯告彁渚?
|
||||
|
||||
### 3. React搴旂敤楠岃瘉
|
||||
|
||||
**测试命令**:
|
||||
**娴嬭瘯鍛戒护**锛?
|
||||
```bash
|
||||
curl http://172.17.173.72/ | head -20
|
||||
```
|
||||
|
||||
**测试结果**:
|
||||
**娴嬭瘯缁撴灉**锛?
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
@@ -131,19 +131,19 @@ curl http://172.17.173.72/ | head -20
|
||||
|
||||
### 4. 鍓嶇<E98D93>鈫掑悗绔<E68297>唬鐞嗘祴璇曪紙鍏抽敭锛侊級
|
||||
|
||||
**测试命令**:
|
||||
**娴嬭瘯鍛戒护**锛?
|
||||
```bash
|
||||
curl http://172.17.173.72/health
|
||||
```
|
||||
|
||||
**测试结果**:
|
||||
**娴嬭瘯缁撴灉**锛?
|
||||
```
|
||||
healthy
|
||||
```
|
||||
|
||||
**验证结果**:✅ 前端到后端的代理完全正常工作!
|
||||
**楠岃瘉缁撴灉**锛氣渽 鍓嶇<E98D93>鍒板悗绔<E68297>殑浠g悊瀹屽叏姝e父宸ヤ綔锛?
|
||||
|
||||
### 5. 健康检查日志
|
||||
### 5. 鍋ュ悍妫€鏌ユ棩蹇?
|
||||
|
||||
```bash
|
||||
127.0.0.1 - - [25/Dec/2025:11:55:01 +0800] "GET / HTTP/1.1" 200 304
|
||||
@@ -151,47 +151,47 @@ healthy
|
||||
127.0.0.1 - - [25/Dec/2025:11:55:11 +0800] "GET / HTTP/1.1" 200 304
|
||||
```
|
||||
|
||||
**验证结果**:✅ SAE健康检查正常,每5秒检查一次
|
||||
**楠岃瘉缁撴灉**锛氣渽 SAE鍋ュ悍妫€鏌ユ<E98F8C>甯革紝姣?绉掓<E7BB89>鏌ヤ竴娆?
|
||||
|
||||
---
|
||||
|
||||
## 🎯 四、关键配置
|
||||
## 馃幆 鍥涖€佸叧閿<E58FA7>厤缃?
|
||||
|
||||
### 鐜<><E9909C>鍙橀噺閰嶇疆
|
||||
|
||||
```bash
|
||||
# 后端服务IP(必需)
|
||||
# 鍚庣<EFBFBD>鏈嶅姟IP锛堝繀闇€锛?
|
||||
BACKEND_SERVICE_HOST=172.17.173.71
|
||||
|
||||
# 后端服务端口(可选,默认3001)
|
||||
# 鍚庣<EFBFBD>鏈嶅姟绔<EFBFBD>彛锛堝彲閫夛紝榛樿<EFBFBD>3001锛?
|
||||
BACKEND_SERVICE_PORT=3001
|
||||
```
|
||||
|
||||
**说明**:
|
||||
**璇存槑**锛?
|
||||
- 杩欎袱涓<E8A2B1>幆澧冨彉閲忓湪瀹瑰櫒鍚<E6AB92>姩鏃堕€氳繃 `envsubst` 娉ㄥ叆鍒癗ginx閰嶇疆
|
||||
- 涓嶉渶瑕侀噸鏂版瀯寤洪暅鍍忥紝鍙<E7B49D>渶閰嶇疆鐜<E79686><E9909C>鍙橀噺
|
||||
- 符合云原生12-Factor App原则
|
||||
- 绗﹀悎浜戝師鐢?2-Factor App鍘熷垯
|
||||
|
||||
### 健康检查配置
|
||||
### 鍋ュ悍妫€鏌ラ厤缃?
|
||||
|
||||
```yaml
|
||||
Liveness存活检查:
|
||||
Liveness瀛樻椿妫€鏌?
|
||||
鏂瑰紡: HTTP GET
|
||||
璺<EFBFBD>緞: /
|
||||
绔<EFBFBD>彛: 80
|
||||
初始延迟: 10秒
|
||||
检查间隔: 10秒
|
||||
超时时间: 3秒
|
||||
失败阈值: 3次
|
||||
鍒濆<EFBFBD>寤惰繜: 10绉?
|
||||
妫€鏌ラ棿闅? 10绉?
|
||||
瓒呮椂鏃堕棿: 3绉?
|
||||
澶辫触闃堝€? 3娆?
|
||||
|
||||
Readiness就绪检查:
|
||||
Readiness灏辩华妫€鏌?
|
||||
鏂瑰紡: HTTP GET
|
||||
璺<EFBFBD>緞: /
|
||||
绔<EFBFBD>彛: 80
|
||||
初始延迟: 5秒
|
||||
检查间隔: 5秒
|
||||
超时时间: 3秒
|
||||
失败阈值: 2次
|
||||
鍒濆<EFBFBD>寤惰繜: 5绉?
|
||||
妫€鏌ラ棿闅? 5绉?
|
||||
瓒呮椂鏃堕棿: 3绉?
|
||||
澶辫触闃堝€? 2娆?
|
||||
```
|
||||
|
||||
### Nginx浠g悊瑙勫垯
|
||||
@@ -224,141 +224,141 @@ location / {
|
||||
|
||||
---
|
||||
|
||||
## 📊 五、部署对比
|
||||
## 馃搳 浜斻€侀儴缃插<E7BC83>姣?
|
||||
|
||||
### 涓嶯ode.js鍚庣<E98D9A>閮ㄧ讲瀵规瘮
|
||||
|
||||
| 对比项 | Node.js后端 | 前端Nginx |
|
||||
| 瀵规瘮椤?| Node.js鍚庣<EFBFBD> | 鍓嶇<E98D93>Nginx |
|
||||
|--------|------------|-----------|
|
||||
| **复杂度** | ⭐⭐⭐⭐ | ⭐ |
|
||||
| **部署时间** | 约2小时(遇到4个问题) | 约10分钟(一次成功) |
|
||||
| **实例规格** | 1核2GB | 0.5核1GB |
|
||||
| **环境变量数** | 15+ | 2 |
|
||||
| **启动时间** | 约30秒 | 约5秒 |
|
||||
| **遇到的问题** | 4个(bash/config/pino/require) | 0个 |
|
||||
| **澶嶆潅搴?* | 猸愨瓙猸愨瓙 | 猸?|
|
||||
| **閮ㄧ讲鏃堕棿** | 绾?灏忔椂锛堥亣鍒?涓<>棶棰橈級 | 绾?0鍒嗛挓锛堜竴娆℃垚鍔燂級 |
|
||||
| **瀹炰緥瑙勬牸** | 1鏍?GB | 0.5鏍?GB |
|
||||
| **鐜<EFBFBD><EFBFBD>鍙橀噺鏁?* | 15+ | 2 |
|
||||
| **鍚<EFBFBD>姩鏃堕棿** | 绾?0绉?| 绾?绉?|
|
||||
| **閬囧埌鐨勯棶棰?* | 4涓<EFBFBD>紙bash/config/pino/require锛?| 0涓?|
|
||||
| **闀滃儚澶у皬** | 838MB | 91.9MB |
|
||||
| **健康检查路径** | `/health` | `/` |
|
||||
| **鍋ュ悍妫€鏌ヨ矾寰?* | `/health` | `/` |
|
||||
|
||||
**缁撹<E7BC81>**锛氬墠绔疦ginx閮ㄧ讲闈炲父绠€鍗曪紝涓€娆℃垚鍔燂紝闆堕棶棰橈紒
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ 六、完整架构
|
||||
## 馃彈锔?鍏<>€佸畬鏁存灦鏋?
|
||||
|
||||
### 褰撳墠閮ㄧ讲鏋舵瀯
|
||||
|
||||
```
|
||||
鐢ㄦ埛璇锋眰锛堟湭鏉ワ級
|
||||
↓
|
||||
[公网SLB] ← 待配置
|
||||
↓
|
||||
[前端Nginx] http://172.17.173.72:80 ✅ 已部署
|
||||
鈫?
|
||||
[鍏<EFBFBD>綉SLB] 鈫?寰呴厤缃?
|
||||
鈫?
|
||||
[鍓嶇<EFBFBD>Nginx] http://172.17.173.72:80 鉁?宸查儴缃?
|
||||
鈹溾攢鈹€ 闈欐€佽祫婧愶細/, /assets/*, /vite.svg
|
||||
└── API代理:/api/*, /health, /test/*
|
||||
↓
|
||||
[Node.js后端] http://172.17.173.71:3001 ✅ 已部署
|
||||
├── 连接数据库
|
||||
├── 调用Python微服务
|
||||
鈹斺攢鈹€ API浠g悊锛?api/*, /health, /test/*
|
||||
鈫?
|
||||
[Node.js鍚庣<EFBFBD>] http://172.17.173.71:3001 鉁?宸查儴缃?
|
||||
鈹溾攢鈹€ 杩炴帴鏁版嵁搴?
|
||||
鈹溾攢鈹€ 璋冪敤Python寰<EFBFBD>湇鍔?
|
||||
鈹斺攢鈹€ 涓氬姟閫昏緫澶勭悊
|
||||
↓ ↓
|
||||
鈫? 鈫?
|
||||
[PostgreSQL RDS] [Python寰<6E>湇鍔<E6B987>
|
||||
✅ 已部署 http://172.17.173.66:8000
|
||||
✅ 已部署
|
||||
鉁?宸查儴缃? http://172.17.173.66:8000
|
||||
鉁?宸查儴缃?
|
||||
```
|
||||
|
||||
### 鏈嶅姟娓呭崟
|
||||
|
||||
| 服务 | 内网地址 | 规格 | 状态 | 部署时间 |
|
||||
| 鏈嶅姟 | 鍐呯綉鍦板潃 | 瑙勬牸 | 鐘舵€?| 閮ㄧ讲鏃堕棿 |
|
||||
|------|---------|------|------|---------|
|
||||
| 前端Nginx | http://172.17.173.72:80 | 0.5核1GB | ✅ 运行中 | 2025-12-25 |
|
||||
| Node.js后端 | http://172.17.173.71:3001 | 1核2GB | ✅ 运行中 | 2025-12-25 |
|
||||
| Python微服务 | http://172.17.173.66:8000 | 1核2GB | ✅ 运行中 | 2025-12-24 |
|
||||
| PostgreSQL | pgm-xxx:5432 | 2核4GB | ✅ 运行中 | 2025-12-24 |
|
||||
| 鍓嶇<EFBFBD>Nginx | http://172.17.173.72:80 | 0.5鏍?GB | 鉁?杩愯<E69DA9>涓?| 2025-12-25 |
|
||||
| Node.js鍚庣<EFBFBD> | http://172.17.173.71:3001 | 1鏍?GB | 鉁?杩愯<E69DA9>涓?| 2025-12-25 |
|
||||
| Python寰<EFBFBD>湇鍔?| http://172.17.173.66:8000 | 1鏍?GB | 鉁?杩愯<E69DA9>涓?| 2025-12-24 |
|
||||
| PostgreSQL | pgm-xxx:5432 | 2鏍?GB | 鉁?杩愯<E69DA9>涓?| 2025-12-24 |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 七、下一步工作
|
||||
## 馃幆 涓冦€佷笅涓€姝ュ伐浣?
|
||||
|
||||
### 楂樹紭鍏堢骇 馃敶
|
||||
|
||||
- [ ] **閰嶇疆鍏<E79686>綉SLB**锛氱粦瀹氬墠绔<E5A2A0>湇鍔★紝鎻愪緵鍏<E7B7B5>綉璁块棶鍏ュ彛
|
||||
- [ ] **閰嶇疆鍩熷悕**锛氱敵璇峰煙鍚嶅苟缁戝畾鍒癝LB
|
||||
- [ ] **SSL证书**:配置HTTPS(阿里云免费SSL或Let's Encrypt)
|
||||
- [ ] **前端实例扩容**:从1个扩容到2个,实现高可用
|
||||
- [ ] **SSL璇佷功**锛氶厤缃瓾TTPS锛堥樋閲屼簯鍏嶈垂SSL鎴朙et's Encrypt锛?
|
||||
- [ ] **鍓嶇<EFBFBD>瀹炰緥鎵╁<EFBFBD>**锛氫粠1涓<31>墿瀹瑰埌2涓<32>紝瀹炵幇楂樺彲鐢?
|
||||
|
||||
### 涓<>紭鍏堢骇 馃煛
|
||||
|
||||
- [ ] **监控告警**:配置SAE应用监控和告警规则
|
||||
- [ ] **日志分析**:配置日志服务SLS,集中管理日志
|
||||
- [ ] **CDN加速**:配置阿里云CDN,加速静态资源访问
|
||||
- [ ] **鐩戞帶鍛婅<EFBFBD>**锛氶厤缃甋AE搴旂敤鐩戞帶鍜屽憡璀﹁<E79280>鍒?
|
||||
- [ ] **鏃ュ織鍒嗘瀽**锛氶厤缃<E58EA4>棩蹇楁湇鍔<E6B987>LS锛岄泦涓<E6B3A6><E6B693>鐞嗘棩蹇?
|
||||
- [ ] **CDN鍔犻€?*锛氶厤缃<E58EA4>樋閲屼簯CDN锛屽姞閫熼潤鎬佽祫婧愯<E5A9A7>闂?
|
||||
- [ ] **瀹夊叏鍔犲浐**锛氶厤缃甒AF闃茬伀澧欙紝闃叉姢甯歌<E794AF>鏀诲嚮
|
||||
|
||||
### 浣庝紭鍏堢骇 馃煝
|
||||
|
||||
- [ ] **鎬ц兘浼樺寲**锛氬惎鐢℉TTP/2锛屼紭鍖朜ginx閰嶇疆
|
||||
- [ ] **压力测试**:进行并发压力测试
|
||||
- [ ] **鍘嬪姏娴嬭瘯**锛氳繘琛屽苟鍙戝帇鍔涙祴璇?
|
||||
- [ ] **澶囦唤绛栫暐**锛氶厤缃<E58EA4>嚜鍔ㄥ<E98D94>浠藉拰鎭㈠<E98EAD>娴佺▼
|
||||
|
||||
---
|
||||
|
||||
## 📈 八、资源使用情况
|
||||
## 馃搱 鍏<>€佽祫婧愪娇鐢ㄦ儏鍐?
|
||||
|
||||
### 瀹炰緥璧勬簮
|
||||
|
||||
```yaml
|
||||
褰撳墠閰嶇疆:
|
||||
CPU: 0.5核
|
||||
CPU: 0.5鏍?
|
||||
鍐呭瓨: 1GB
|
||||
实例数: 1个
|
||||
瀹炰緥鏁? 1涓?
|
||||
|
||||
瀹為檯浣跨敤锛堥<EFBFBD>浼帮級:
|
||||
CPU使用率: <10%
|
||||
内存使用率: <30%
|
||||
CPU浣跨敤鐜? <10%
|
||||
鍐呭瓨浣跨敤鐜? <30%
|
||||
缃戠粶甯﹀<EFBFBD>: <10Mbps
|
||||
```
|
||||
|
||||
### 鎴愭湰浼扮畻
|
||||
|
||||
```yaml
|
||||
SAE成本(单实例):
|
||||
0.5核1GB: 约¥30-50/月
|
||||
SAE鎴愭湰锛堝崟瀹炰緥锛?
|
||||
0.5鏍?GB: 绾β?0-50/鏈?
|
||||
|
||||
扩容到2实例后:
|
||||
总成本: 约¥60-100/月
|
||||
鎵╁<EFBFBD>鍒?瀹炰緥鍚?
|
||||
鎬绘垚鏈? 绾β?0-100/鏈?
|
||||
|
||||
寤鸿<EFBFBD>:
|
||||
测试阶段使用1个实例
|
||||
娴嬭瘯闃舵<EFBFBD>浣跨敤1涓<EFBFBD>疄渚?
|
||||
鐢熶骇鐜<EFBFBD><EFBFBD>浣跨敤2涓<EFBFBD>疄渚嬶紙楂樺彲鐢<EFBFBD>級
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 九、故障排查指南
|
||||
## 馃敡 涔濄€佹晠闅滄帓鏌ユ寚鍗?
|
||||
|
||||
### 甯歌<E794AF>闂<EFBFBD><E99782>
|
||||
|
||||
#### 问题1:容器启动失败
|
||||
#### 闂<EFBFBD><EFBFBD>1锛氬<EFBFBD>鍣ㄥ惎鍔ㄥけ璐?
|
||||
|
||||
**症状**:容器反复重启
|
||||
**鐥囩姸**锛氬<E9949B>鍣ㄥ弽澶嶉噸鍚?
|
||||
|
||||
**可能原因**:
|
||||
- 环境变量 `BACKEND_SERVICE_HOST` 未配置
|
||||
**鍙<EFBFBD>兘鍘熷洜**锛?
|
||||
- 鐜<EFBFBD><EFBFBD>鍙橀噺 `BACKEND_SERVICE_HOST` 鏈<EFBFBD>厤缃?
|
||||
|
||||
**解决方法**:
|
||||
**瑙e喅鏂规硶**锛?
|
||||
```bash
|
||||
# 在SAE控制台检查环境变量配置
|
||||
# 确保 BACKEND_SERVICE_HOST 和 BACKEND_SERVICE_PORT 已正确配置
|
||||
# 鍦⊿AE鎺у埗鍙版<EFBFBD>鏌ョ幆澧冨彉閲忛厤缃?
|
||||
# 纭<EFBFBD>繚 BACKEND_SERVICE_HOST 鍜?BACKEND_SERVICE_PORT 宸叉<EFBFBD>纭<EFBFBD>厤缃?
|
||||
```
|
||||
|
||||
#### 问题2:健康检查失败
|
||||
#### 闂<EFBFBD><EFBFBD>2锛氬仴搴锋<EFBFBD>鏌ュけ璐?
|
||||
|
||||
**症状**:实例状态显示"不健康"
|
||||
**鐥囩姸**锛氬疄渚嬬姸鎬佹樉绀?涓嶅仴搴?
|
||||
|
||||
**可能原因**:
|
||||
- Nginx未正常启动
|
||||
- 健康检查路径错误
|
||||
**鍙<EFBFBD>兘鍘熷洜**锛?
|
||||
- Nginx鏈<EFBFBD><EFBFBD>甯稿惎鍔?
|
||||
- 鍋ュ悍妫€鏌ヨ矾寰勯敊璇?
|
||||
|
||||
**解决方法**:
|
||||
**瑙e喅鏂规硶**锛?
|
||||
```bash
|
||||
# 鏌ョ湅瀹瑰櫒鏃ュ織
|
||||
# 妫€鏌ユ槸鍚︽湁 "nginx: configuration file test is successful"
|
||||
@@ -366,19 +366,19 @@ SAE成本(单实例):
|
||||
|
||||
#### 闂<><E99782>3锛氬墠绔<E5A2A0>棤娉曚唬鐞嗗埌鍚庣<E98D9A>
|
||||
|
||||
**症状**:访问 `/health` 返回404或502
|
||||
**鐥囩姸**锛氳<E9949B>闂?`/health` 杩斿洖404鎴?02
|
||||
|
||||
**可能原因**:
|
||||
**鍙<EFBFBD>兘鍘熷洜**锛?
|
||||
- 鍚庣<E98D9A>鍦板潃閰嶇疆閿欒<E996BF>
|
||||
- 缃戠粶涓嶉€氾紙瀹夊叏缁勮<E7BC81>鍒欙級
|
||||
|
||||
**解决方法**:
|
||||
**瑙e喅鏂规硶**锛?
|
||||
```bash
|
||||
# 1. 检查启动日志中的 Backend Service 地址
|
||||
# 2. 测试后端是否可访问
|
||||
# 1. 妫€鏌ュ惎鍔ㄦ棩蹇椾腑鐨?Backend Service 鍦板潃
|
||||
# 2. 娴嬭瘯鍚庣<EFBFBD>鏄<EFBFBD>惁鍙<EFBFBD><EFBFBD>闂?
|
||||
curl http://172.17.173.71:3001/health
|
||||
|
||||
# 3. 检查安全组规则是否允许内网互通
|
||||
# 3. 妫€鏌ュ畨鍏ㄧ粍瑙勫垯鏄<EFBFBD>惁鍏佽<EFBFBD>鍐呯綉浜掗€?
|
||||
```
|
||||
|
||||
---
|
||||
@@ -387,24 +387,24 @@ curl http://172.17.173.71:3001/health
|
||||
|
||||
### 鎴愬姛鍥犵礌
|
||||
|
||||
1. **运行时配置**:后端地址通过环境变量注入,不写死在镜像中
|
||||
2. **简单架构**:Nginx极其稳定,配置简单
|
||||
3. **充分准备**:提前准备好所有配置信息
|
||||
4. **参考经验**:借鉴Node.js后端部署经验
|
||||
1. **杩愯<EFBFBD>鏃堕厤缃?*锛氬悗绔<E68297>湴鍧€閫氳繃鐜<E7B983><E9909C>鍙橀噺娉ㄥ叆锛屼笉鍐欐<E98D90>鍦ㄩ暅鍍忎腑
|
||||
2. **绠€鍗曟灦鏋?*锛歂ginx鏋佸叾绋冲畾锛岄厤缃<E58EA4>畝鍗?
|
||||
3. **鍏呭垎鍑嗗<EFBFBD>**锛氭彁鍓嶅噯澶囧ソ鎵€鏈夐厤缃<E58EA4>俊鎭?
|
||||
4. **鍙傝€冪粡楠?*锛氬€熼壌Node.js鍚庣<E98D9A>閮ㄧ讲缁忛獙
|
||||
|
||||
### 与Node.js对比的优势
|
||||
### 涓嶯ode.js瀵规瘮鐨勪紭鍔?
|
||||
|
||||
1. **零问题部署**:没有遇到任何问题,一次成功
|
||||
2. **资源节省**:只需要0.5核1GB
|
||||
3. **启动快速**:5秒即可启动
|
||||
4. **配置简单**:只需2个环境变量
|
||||
1. **闆堕棶棰橀儴缃?*锛氭病鏈夐亣鍒颁换浣曢棶棰橈紝涓€娆℃垚鍔?
|
||||
2. **璧勬簮鑺傜渷**锛氬彧闇€瑕?.5鏍?GB
|
||||
3. **鍚<EFBFBD>姩蹇<EFBFBD>€?*锛?绉掑嵆鍙<E5B586>惎鍔?
|
||||
4. **閰嶇疆绠€鍗?*锛氬彧闇€2涓<32>幆澧冨彉閲?
|
||||
|
||||
### 浜戝師鐢熻<E990A2>璁$殑浣撶幇
|
||||
|
||||
1. **配置外部化**:通过环境变量注入配置
|
||||
2. **无状态设计**:可以水平扩展
|
||||
3. **健康检查**:支持Liveness和Readiness探针
|
||||
4. **日志标准化**:输出到stdout/stderr
|
||||
1. **閰嶇疆澶栭儴鍖?*锛氶€氳繃鐜<E7B983><E9909C>鍙橀噺娉ㄥ叆閰嶇疆
|
||||
2. **鏃犵姸鎬佽<EFBFBD>璁?*锛氬彲浠ユ按骞虫墿灞?
|
||||
3. **鍋ュ悍妫€鏌?*锛氭敮鎸丩iveness鍜孯eadiness鎺㈤拡
|
||||
4. **鏃ュ織鏍囧噯鍖?*锛氳緭鍑哄埌stdout/stderr
|
||||
|
||||
---
|
||||
|
||||
@@ -416,25 +416,25 @@ curl http://172.17.173.71:3001/health
|
||||
# 鍓嶇<E98D93>Nginx锛堝叆鍙o級
|
||||
http://172.17.173.72:80
|
||||
|
||||
# Node.js后端(API)
|
||||
# Node.js鍚庣<EFBFBD>锛圓PI锛?
|
||||
http://172.17.173.71:3001
|
||||
|
||||
# Python微服务(文档处理)
|
||||
# Python寰<EFBFBD>湇鍔★紙鏂囨。澶勭悊锛?
|
||||
http://172.17.173.66:8000
|
||||
|
||||
# PostgreSQL数据库
|
||||
# PostgreSQL鏁版嵁搴?
|
||||
pgm-2zex1m2y3r23hdn5.pg.rds.aliyuncs.com:5432
|
||||
```
|
||||
|
||||
**配置公网访问时需要用到这些地址!**
|
||||
**閰嶇疆鍏<EFBFBD>綉璁块棶鏃堕渶瑕佺敤鍒拌繖浜涘湴鍧€锛?*
|
||||
|
||||
---
|
||||
|
||||
## 📚 十二、相关文档索引
|
||||
## 馃摎 鍗佷簩銆佺浉鍏虫枃妗g储寮?
|
||||
|
||||
### 鍓嶇<E98D93>閮ㄧ讲鏂囨。
|
||||
- [07-鍓嶇<E98D93>Nginx-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md](./07-鍓嶇<E98D93>Nginx-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md) - 瀹屾暣閮ㄧ讲姝ラ<E5A79D>
|
||||
- [06-前端Nginx-SAE容器部署指南.md](./06-前端Nginx-SAE容器部署指南.md) - 技术架构详解
|
||||
- [06-鍓嶇<EFBFBD>Nginx-SAE瀹瑰櫒閮ㄧ讲鎸囧崡.md](./06-鍓嶇<EFBFBD>Nginx-SAE瀹瑰櫒閮ㄧ讲鎸囧崡.md) - 鎶€鏈<E282AC>灦鏋勮<E98F8B>瑙?
|
||||
|
||||
### 鍚庣<E98D9A>閮ㄧ讲鏂囨。
|
||||
- [12-Node.js鍚庣<E98D9A>-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md](./12-Node.js鍚庣<E98D9A>-SAE閮ㄧ讲鎿嶄綔鎵嬪唽.md)
|
||||
@@ -445,28 +445,29 @@ pgm-2zex1m2y3r23hdn5.pg.rds.aliyuncs.com:5432
|
||||
|
||||
---
|
||||
|
||||
## 🎉 最终结论
|
||||
## 馃帀 鏈€缁堢粨璁?
|
||||
|
||||
**AI涓村簥鐮旂┒骞冲彴鏍稿績鏈嶅姟宸插叏閮ㄩ儴缃叉垚鍔燂紒**
|
||||
|
||||
✅ PostgreSQL数据库(2025-12-24)
|
||||
✅ Python微服务(2025-12-24)
|
||||
✅ Node.js后端(2025-12-25)
|
||||
✅ 前端Nginx(2025-12-25)
|
||||
鉁?PostgreSQL鏁版嵁搴擄紙2025-12-24锛?
|
||||
鉁?Python寰<EFBFBD>湇鍔★紙2025-12-24锛?
|
||||
鉁?Node.js鍚庣<EFBFBD>锛?025-12-25锛?
|
||||
鉁?鍓嶇<E98D93>Nginx锛?025-12-25锛?
|
||||
|
||||
**完整链路测试通过**:
|
||||
- 前端静态资源 ✅
|
||||
- 前端→后端代理 ✅
|
||||
- 后端→数据库 ✅
|
||||
- 后端→Python ✅
|
||||
**瀹屾暣閾捐矾娴嬭瘯閫氳繃**锛?
|
||||
- 鍓嶇<EFBFBD>闈欐€佽祫婧?鉁?
|
||||
- 鍓嶇<EFBFBD>鈫掑悗绔<EFBFBD>唬鐞?鉁?
|
||||
- 鍚庣<EFBFBD>鈫掓暟鎹<EFBFBD>簱 鉁?
|
||||
- 鍚庣<EFBFBD>鈫扨ython 鉁?
|
||||
|
||||
**系统状态**:全部运行正常,可以进行功能测试和业务验证!🎊
|
||||
**绯荤粺鐘舵€?*锛氬叏閮ㄨ繍琛屾<E7909B>甯革紝鍙<E7B49D>互杩涜<E69DA9>鍔熻兘娴嬭瘯鍜屼笟鍔¢獙璇侊紒馃帄
|
||||
|
||||
---
|
||||
|
||||
> **鏂囨。鐗堟湰**锛歷1.0
|
||||
> **创建时间**:2025-12-25 20:00
|
||||
> **维护者**:开发团队
|
||||
> **鍒涘缓鏃堕棿**锛?025-12-25 20:00
|
||||
> **缁存姢鑰?*锛氬紑鍙戝洟闃?
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user