feat(admin): Add user management and upgrade to module permission system
Features - User Management (Phase 4.1): - Database: Add user_modules table for fine-grained module permissions - Database: Add 4 user permissions (view/create/edit/delete) to role_permissions - Backend: UserService (780 lines) - CRUD with tenant isolation - Backend: UserController + UserRoutes (648 lines) - 13 API endpoints - Backend: Batch import users from Excel - Frontend: UserListPage (412 lines) - list/filter/search/pagination - Frontend: UserFormPage (341 lines) - create/edit with module config - Frontend: UserDetailPage (393 lines) - details/tenant/module management - Frontend: 3 modal components (592 lines) - import/assign/configure - API: GET/POST/PUT/DELETE /api/admin/users/* endpoints Architecture Upgrade - Module Permission System: - Backend: Add getUserModules() method in auth.service - Backend: Login API returns modules array in user object - Frontend: AuthContext adds hasModule() method - Frontend: Navigation filters modules based on user.modules - Frontend: RouteGuard checks requiredModule instead of requiredVersion - Frontend: Remove deprecated version-based permission system - UX: Only show accessible modules in navigation (clean UI) - UX: Smart redirect after login (avoid 403 for regular users) Fixes: - Fix UTF-8 encoding corruption in ~100 docs files - Fix pageSize type conversion in userService (String to Number) - Fix authUser undefined error in TopNavigation - Fix login redirect logic with role-based access check - Update Git commit guidelines v1.2 with UTF-8 safety rules Database Changes: - CREATE TABLE user_modules (user_id, tenant_id, module_code, is_enabled) - ADD UNIQUE CONSTRAINT (user_id, tenant_id, module_code) - INSERT 4 permissions + role assignments - UPDATE PUBLIC tenant with 8 module subscriptions Technical: - Backend: 5 new files (~2400 lines) - Frontend: 10 new files (~2500 lines) - Docs: 1 development record + 2 status updates + 1 guideline update - Total: ~4900 lines of code Status: User management 100% complete, module permission system operational
This commit is contained in:
@@ -1,34 +1,36 @@
|
||||
# Python 敺格<EFBFBD><EFBFBD>?SAE <20>函蔡<E587BD>滢<EFBFBD><E6BBA2>见<EFBFBD>
|
||||
# Python 微服务 SAE 部署操作手册
|
||||
|
||||
**文档版本**: v1.0
|
||||
**创建时间**: 2024-12-24
|
||||
**<EFBFBD><EFBFBD>鍂<EFBFBD><EFBFBD>凒**: AI銝游<EFBFBD><EFBFBD>𠉛弦撟喳蝱 - Python敺格<EFBFBD><EFBFBD>∴<EFBFBD>extraction_service嚗?
|
||||
**<EFBFBD>臬<EFBFBD>蝐餃<EFBFBD>**: 瘚贝<EFBFBD><EFBFBD>臬<EFBFBD>嚗<EFBFBD>蝠<EFBFBD>讐<EFBFBD>SAE嚗?
|
||||
**<EFBFBD>格<EFBFBD>霂餉<EFBFBD>?*: 餈鞟輕撌亦<E6928C>撣<EFBFBD><E692A3><EFBFBD><EFBFBD><EFBFBD>穃極蝔见<E89D94>
|
||||
**适用范围**: AI临床研究平台 - Python微服务(extraction_service)
|
||||
**环境类型**: 测试环境(轻量版SAE)
|
||||
**目标读者**: 运维工程师、开发工程师
|
||||
|
||||
---
|
||||
|
||||
## 📋 目录
|
||||
|
||||
1. [<EFBFBD>滨蔭璉<EFBFBD><EFBFBD>交<EFBFBD><EFBFBD>騟(#<23>滨蔭璉<E894AD><E79289>交<EFBFBD><E4BAA4>?
|
||||
2. [<EFBFBD>𥕦遣SAE摨𠉛鍂嚗Áeb<EFBFBD>批<EFBFBD><EFBFBD>堆<EFBFBD>](#<23>𥕦遣sae摨𠉛鍂web<65>批<EFBFBD><E689B9>?
|
||||
3. [<EFBFBD>函蔡<EFBFBD>𡡞<EFBFBD>霂<EFBFBD>(#<23>函蔡<E587BD>𡡞<EFBFBD>霂?
|
||||
1. [前置检查清单](#前置检查清单)
|
||||
2. [创建SAE应用(Web控制台)](#创建sae应用web控制台)
|
||||
3. [部署后验证](#部署后验证)
|
||||
4. [集成配置](#集成配置)
|
||||
5. [常见问题排查](#常见问题排查)
|
||||
|
||||
---
|
||||
|
||||
## <EFBFBD>滨蔭璉<EFBFBD><EFBFBD>交<EFBFBD><EFBFBD>?
|
||||
### <20>?敹<><E695B9>韏<EFBFBD><E99F8F>蝖株恕
|
||||
## 前置检查清单
|
||||
|
||||
<EFBFBD>典<EFBFBD>憪见<EFBFBD>撱搴AE摨𠉛鍂<EFBFBD>㵪<EFBFBD>霂瑞&霈支誑銝贝<EFBFBD>皞𣂼歇<EFBFBD><EFBFBD><EFBFBD>撠梁貌嚗?
|
||||
| 韏<><E99F8F>蝐餃<E89D90> | 蝖株恕憿?| <20>瑕<EFBFBD>雿滨蔭 |
|
||||
### ✅ 必需资源确认
|
||||
|
||||
在开始创建SAE应用前,请确认以下资源已准备就绪:
|
||||
|
||||
| 资源类型 | 确认项 | 获取位置 |
|
||||
|---------|-------|---------|
|
||||
| **Docker<EFBFBD>𨅯<EFBFBD>** | <EFBFBD>?撌脫綫<E884AB><E7B6AB>秐ACR | [<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>.md - 2.1 ACR摰孵膥<E5ADB5>𨅯<EFBFBD>隞枏<E99A9E>](./00-<2D>函蔡餈𥕦漲<F0A595A6>餉<EFBFBD>.md#21-acr摰孵膥<EFBFBD>𨅯<EFBFBD>隞枏<EFBFBD>) |
|
||||
| **VPC蝵𤑳<EFBFBD>** | <EFBFBD>?VPC ID<EFBFBD><EFBFBD>Switch ID | [<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>.md - 2.2 VPC蝵𤑳<EFBFBD>](./00-<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>.md#22-vpc蝵𤑳<EFBFBD>銝篺at蝵穃<EFBFBD>) |
|
||||
| **摰匧<EFBFBD>蝏?* | <20>?摰匧<E691B0>蝏<EFBFBD>D | [<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>.md - 2.2 VPC蝵𤑳<EFBFBD>](./00-<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>.md#22-vpc蝵𤑳<EFBFBD>銝篺at蝵穃<EFBFBD>) |
|
||||
| **OSS摮睃<EFBFBD>** | <EFBFBD>?AccessKey<EFBFBD><EFBFBD>ucket<EFBFBD>滨妍 | [<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>.md - 2.5 OSS撖寡情摮睃<EFBFBD>](./00-<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>.md#25-oss撖寡情摮睃<EFBFBD>) |
|
||||
| **SAE<EFBFBD>賢<EFBFBD>蝛粹𡢿** | <EFBFBD>?<3F>賢<EFBFBD>蝛粹𡢿ID | [<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>.md - 2.4 SAE摨𠉛鍂](./00-<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>.md#24-sae-serverless摨𠉛鍂) |
|
||||
| **Docker镜像** | ✅ 已推送至ACR | [部署进度总览.md - 2.1 ACR容器镜像仓库](./00-部署进度总览.md#21-acr容器镜像仓库) |
|
||||
| **VPC网络** | ✅ VPC ID、vSwitch ID | [部署进度总览.md - 2.2 VPC网络](./00-部署进度总览.md#22-vpc网络与nat网关) |
|
||||
| **安全组** | ✅ 安全组ID | [部署进度总览.md - 2.2 VPC网络](./00-部署进度总览.md#22-vpc网络与nat网关) |
|
||||
| **OSS存储** | ✅ AccessKey、Bucket名称 | [部署进度总览.md - 2.5 OSS对象存储](./00-部署进度总览.md#25-oss对象存储) |
|
||||
| **SAE命名空间** | ✅ 命名空间ID | [部署进度总览.md - 2.4 SAE应用](./00-部署进度总览.md#24-sae-serverless应用) |
|
||||
|
||||
### 📦 镜像信息
|
||||
|
||||
@@ -37,51 +39,56 @@
|
||||
crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/python-extraction:v1.0
|
||||
|
||||
镜像版本:v1.0
|
||||
<EFBFBD>𨅯<EFBFBD>憭批<EFBFBD>嚗?.12GB
|
||||
<EFBFBD>蠘<EFBFBD>霂湔<EFBFBD>嚗䥪DF/Docx<63>𣂼<EFBFBD> + <20>唳旿皜<E697BF><E79A9C>嚗īandas/polars嚗?```
|
||||
镜像大小:1.12GB
|
||||
功能说明:PDF/Docx提取 + 数据清洗(pandas/polars)
|
||||
```
|
||||
|
||||
### 🌐 网络配置信息
|
||||
|
||||
```
|
||||
VPC ID:vpc-2ze055cptkew9c38w4r06
|
||||
vSwitch ID嚗鯝sw-2zevacop039bxrmj6yc0c嚗<EFBFBD>虾<EFBFBD>典躹F嚗?摰匧<E691B0>蝏<EFBFBD>D嚗窃g-2zedk6fi8sgmmcwdu7tu
|
||||
vSwitch ID:vsw-2zevacop039bxrmj6yc0c(可用区F)
|
||||
安全组ID:sg-2zedk6fi8sgmmcwdu7tu
|
||||
命名空间:cn-beijing:test-airesearch
|
||||
```
|
||||
|
||||
### <EFBFBD><EFBFBD>儭?OSS<53>滨蔭靽⊥<E99DBD>
|
||||
### 🗄️ OSS配置信息
|
||||
|
||||
```
|
||||
OSS_ACCESS_KEY_ID:LTAI5tB2Dt3NdvBL3G7nYGv7
|
||||
OSS_ACCESS_KEY_SECRET嚗?iSN9k39RkApP93QjUhC1DcPIeMG4V
|
||||
OSS_ACCESS_KEY_SECRET:1iSN9k39RkApP93QjUhC1DcPIeMG4V
|
||||
OSS_BUCKET:ai-clinical-research
|
||||
OSS_ENDPOINT:oss-cn-beijing-internal.aliyuncs.com
|
||||
```
|
||||
|
||||
<EFBFBD>𩤃<EFBFBD> **摰匧<E691B0>霅血<E99C85>**嚗鋫ccessKey<65>舀<EFBFBD><E88880>煺縑<E785BA>荔<EFBFBD>隞<EFBFBD>銁SAE<41>臬<EFBFBD><E887AC>㗛<EFBFBD>銝剝<E98A9D>蝵殷<E89DB5>銝滩<E98A9D><E6BBA9>𣂷漱<F0A382B7>蚣it<69>𡝗<EFBFBD><F0A19D97>啣<EFBFBD><E595A3>亙<EFBFBD>嚗?
|
||||
⚠️ **安全警告**:AccessKey是敏感信息,仅在SAE环境变量中配置,不要提交到Git或打印到日志!
|
||||
|
||||
---
|
||||
|
||||
## 创建SAE应用(Web控制台)
|
||||
|
||||
### 甇仿炊 1嚗朞<E59A97><E69C9E>兄AE<41>批<EFBFBD><E689B9>?
|
||||
### 步骤 1:进入SAE控制台
|
||||
|
||||
1. 登录 [阿里云控制台](https://homenew.console.aliyun.com/)
|
||||
2. <20>𦦵揣撟嗉<E6929F><E59789>?**Serverless 摨𠉛鍂撘閙<EFBFBD> SAE**
|
||||
3. 蝖株恕<E6A0AA>啣<EFBFBD>銝?**<2A>𤾸<EFBFBD>2嚗<32><E59A97>鈭穿<E988AD>**
|
||||
2. 搜索并进入 **Serverless 应用引擎 SAE**
|
||||
3. 确认地域为 **华北2(北京)**
|
||||
4. 选择命名空间 **test-airesearch**
|
||||
|
||||
---
|
||||
|
||||
### 甇仿炊 2嚗𡁜<E59A97>撱箏<E692B1><E7AE8F>?
|
||||
### 步骤 2:创建应用
|
||||
|
||||
#### 2.1 基本信息配置
|
||||
|
||||
点击 **创建应用** 按钮,填写以下信息:
|
||||
|
||||
| <EFBFBD>滨蔭憿?| <20>?| 霂湔<E99C82> |
|
||||
| 配置项 | 值 | 说明 |
|
||||
|--------|---|------|
|
||||
| **摨𠉛鍂<EFBFBD>滨妍** | `python-extraction-test` | 撱箄悅<EFBFBD>?`-test` <20>𡒊<EFBFBD><F0A1928A>箏<EFBFBD>瘚贝<E7989A><E8B49D>臬<EFBFBD> |
|
||||
| **摨𠉛鍂蝐餃<EFBFBD>** | **頧駁<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?* | 瘚贝<E7989A><E8B49D>臬<EFBFBD>雿輻鍂頧駁<E9A0A7><E9A781><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>鞉𧋦 |
|
||||
| **应用名称** | `python-extraction-test` | 建议加 `-test` 后缀区分测试环境 |
|
||||
| **应用类型** | **轻量版应用** | 测试环境使用轻量版,节省成本 |
|
||||
| **部署方式** | **镜像** | 选择容器镜像部署 |
|
||||
|
||||
<EFBFBD>孵稬 **銝衤<E98A9D>甇?*
|
||||
点击 **下一步**
|
||||
|
||||
---
|
||||
|
||||
@@ -89,45 +96,47 @@ OSS_ENDPOINT:oss-cn-beijing-internal.aliyuncs.com
|
||||
|
||||
##### 镜像配置
|
||||
|
||||
| <EFBFBD>滨蔭憿?| <20>?| 霂湔<E99C82> |
|
||||
| 配置项 | 值 | 说明 |
|
||||
|--------|---|------|
|
||||
| **<EFBFBD>𨅯<EFBFBD><EFBFBD>交<EFBFBD>** | 摰孵膥<EFBFBD>𨅯<EFBFBD><EFBFBD>滚𦛚 ACR嚗<52><E59A97><EFBFBD>㗇𥋘"<22>芸<EFBFBD>銋厰<E98A8B><E58EB0>?嚗?| |
|
||||
| **<EFBFBD>𨅯<EFBFBD><EFBFBD>啣<EFBFBD>** | `crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/python-extraction:v1.0` | <EFBFBD>𩤃<EFBFBD> 敹<>◆雿輻鍂VPC<50><43><EFBFBD><EFBFBD>啣<EFBFBD><br><3E>𩤃<EFBFBD> 敹<>◆<EFBFBD><E29786>鉄<EFBFBD><E98984>𧋦<EFBFBD>?`:v1.0` |
|
||||
| **<EFBFBD>𨅯<EFBFBD><EFBFBD><EFBFBD>𧋦** | `v1.0` | <EFBFBD>箏<EFBFBD><EFBFBD><EFBFBD>𧋦<EFBFBD>瘀<EFBFBD>銝滩<EFBFBD>雿輻鍂 `:latest`<br><EFBFBD>𩤃<EFBFBD> 憒<><E68692>銝齿<E98A9D>摰𡁶<E691B0><F0A181B6>砍噡嚗玺AE隡𡁻<E99AA1>霈支蝙<E694AF>?`:latest` 撖潸稲<E6BDB8>匧<EFBFBD>憭梯揖 |
|
||||
| **<EFBFBD>𨅯<EFBFBD>隞枏<EFBFBD>霈方<EFBFBD>** | **<EFBFBD><EFBFBD>閬<EFBFBD><EFBFBD>蝵?* | <20>𩤃<EFBFBD> **<2A>喲睸甇仿炊**嚗𡁻<E59A97>蝵唧CR霈輸䔮<E8BCB8>剛<EFBFBD>嚗<EFBFBD><E59A97>銝𧢲䲮嚗?|
|
||||
| **镜像来源** | 容器镜像服务 ACR(或选择"自定义镜像") | |
|
||||
| **镜像地址** | `crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/python-extraction:v1.0` | ⚠️ 必须使用VPC内网地址<br>⚠️ 必须包含版本号 `:v1.0` |
|
||||
| **镜像版本** | `v1.0` | 固定版本号,不要使用 `:latest`<br>⚠️ 如果不指定版本号,SAE会默认使用 `:latest` 导致拉取失败 |
|
||||
| **镜像仓库认证** | **需要配置** | ⚠️ **关键步骤**:配置ACR访问凭证(见下方) |
|
||||
|
||||
##### 🔑 镜像仓库认证配置(关键步骤)
|
||||
|
||||
**<2A>𩤃<EFBFBD> 憒<><E68692><EFBFBD>箇緵 `insufficient_scope: authorization failed` <20>躰秤嚗<E7A7A4><E59A97>憿駁<E686BF>蝵格迨憿?*
|
||||
**⚠️ 如果出现 `insufficient_scope: authorization failed` 错误,必须配置此项**
|
||||
|
||||
<EFBFBD>曉<EFBFBD> **"<22>𨅯<EFBFBD>隞枏<E99A9E>霈方<E99C88>"** <20>?**"蝘<><E89D98><EFBFBD>𨅯<EFBFBD>隞枏<E99A9E>"** <20>滨蔭憿對<E686BF>
|
||||
找到 **"镜像仓库认证"** 或 **"私有镜像仓库"** 配置项:
|
||||
|
||||
| <EFBFBD>滨蔭憿?| <20>?| 霂湔<E99C82> |
|
||||
| 配置项 | 值 | 说明 |
|
||||
|--------|---|------|
|
||||
| **<EFBFBD>𨅯<EFBFBD>隞枏<EFBFBD><EFBFBD>啣<EFBFBD>** | `crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com` | <EFBFBD>芸‵<EFBFBD>筻egistry<EFBFBD>笔<EFBFBD>嚗䔶<EFBFBD><EFBFBD><EFBFBD>鉄<EFBFBD>賢<EFBFBD>蝛粹𡢿/隞枏<E99A9E><E69E8F>?|
|
||||
| **<EFBFBD>冽<EFBFBD><EFBFBD>?* | `gofeng117@163.com` | ACR<EFBFBD>餃<EFBFBD><EFBFBD>冽<EFBFBD><EFBFBD>?|
|
||||
| **镜像仓库地址** | `crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com` | 只填写Registry域名,不包含命名空间/仓库名 |
|
||||
| **用户名** | `gofeng117@163.com` | ACR登录用户名 |
|
||||
| **密码** | `fengzhibo117` | ACR登录密码 |
|
||||
|
||||
<EFBFBD>働 **霂湔<E99C82>**嚗?- 餈嗘<E9A488><E59798>剛<EFBFBD><E5899B>其<EFBFBD>SAE<41>匧<EFBFBD>蝘<EFBFBD><E89D98><EFBFBD>𨅯<EFBFBD>
|
||||
- 撖<><E69296>隡朞◤SAE<41>惩<EFBFBD>摮睃<E691AE>嚗䔶<E59A97>隡𡁏<E99AA1><F0A1818F>?- <20>剛<EFBFBD><E5899B>交<EFBFBD>嚗靀<E59A97>函蔡餈𥕦漲<F0A595A6>餉<EFBFBD> - 2.1 ACR摰孵膥<E5ADB5>𨅯<EFBFBD>隞枏<E99A9E>](./00-<2D>函蔡餈𥕦漲<F0A595A6>餉<EFBFBD>.md#21-acr摰孵膥<E5ADB5>𨅯<EFBFBD>隞枏<E99A9E>)
|
||||
💡 **说明**:
|
||||
- 这些凭证用于SAE拉取私有镜像
|
||||
- 密码会被SAE加密存储,不会泄露
|
||||
- 凭证来源:[部署进度总览 - 2.1 ACR容器镜像仓库](./00-部署进度总览.md#21-acr容器镜像仓库)
|
||||
|
||||
##### 应用实例配置
|
||||
|
||||
| <EFBFBD>滨蔭憿?| <20>?| 霂湔<E99C82> |
|
||||
| 配置项 | 值 | 说明 |
|
||||
|--------|---|------|
|
||||
| **CPU** | 1<EFBFBD>?| `1000 millicores` |
|
||||
| **CPU** | 1核 | `1000 millicores` |
|
||||
| **内存** | 2GB | `2048 MB` |
|
||||
| **摰硺<EFBFBD><EFBFBD>?* | 1 | <20>𩤃<EFBFBD> 敹<>◆<EFBFBD>喳<EFBFBD>1銝芸<E98A9D>靘页<E99D98>0銝芸<E98A9D>靘?<3F>滚𦛚<E6BB9A>𨀣迫 |
|
||||
| **实例数** | 1 | ⚠️ 必须至少1个实例,0个实例=服务停止 |
|
||||
|
||||
##### 应用访问设置
|
||||
|
||||
| <EFBFBD>滨蔭憿?| <20>?| 霂湔<E99C82> |
|
||||
| 配置项 | 值 | 说明 |
|
||||
|--------|---|------|
|
||||
| **容器端口** | `8000` | Python FastAPI服务端口 |
|
||||
| **协议类型** | HTTP | |
|
||||
| **<EFBFBD>臬炏撘<EFBFBD><EFBFBD>臬<EFBFBD>蝵𤏸挪<EFBFBD>?* | **<EFBFBD>?* | 隞<><E99A9E>蝵𤏸挪<F0A48FB8>殷<EFBFBD>鋡俏ode.js<6A>𡒊垢靚<E59EA2>鍂 |
|
||||
| **是否开启公网访问** | **否** | 仅内网访问,被Node.js后端调用 |
|
||||
|
||||
<EFBFBD>孵稬 **銝衤<E98A9D>甇?*
|
||||
点击 **下一步**
|
||||
|
||||
---
|
||||
|
||||
@@ -135,8 +144,9 @@ OSS_ENDPOINT:oss-cn-beijing-internal.aliyuncs.com
|
||||
|
||||
##### 环境变量
|
||||
|
||||
<EFBFBD>孵稬 **瘛餃<E7989B><E9A483>臬<EFBFBD><E887AC>㗛<EFBFBD>**嚗屸<E59A97>𣂷葵瘛餃<E7989B>隞乩<E99A9E><E4B9A9>滨蔭嚗?
|
||||
| <20>㗛<EFBFBD><E3979B>?| <20>㗛<EFBFBD><E3979B>?| 霂湔<E99C82> |
|
||||
点击 **添加环境变量**,逐个添加以下配置:
|
||||
|
||||
| 变量名 | 变量值 | 说明 |
|
||||
|--------|--------|------|
|
||||
| `LOG_LEVEL` | `INFO` | 日志级别 |
|
||||
| `TEMP_DIR` | `/tmp/extraction_service` | 临时文件目录 |
|
||||
@@ -148,72 +158,86 @@ OSS_ENDPOINT:oss-cn-beijing-internal.aliyuncs.com
|
||||
| `OSS_BUCKET` | `ai-clinical-research` | OSS Bucket名称 |
|
||||
| `OSS_ENDPOINT` | `oss-cn-beijing-internal.aliyuncs.com` | OSS内网Endpoint |
|
||||
|
||||
<EFBFBD>𩤃<EFBFBD> **瘜冽<E7989C>**嚗?- <20>臬<EFBFBD><E887AC>㗛<EFBFBD>銝剔<E98A9D> `OSS_ACCESS_KEY_SECRET` <20>舀<EFBFBD><E88880>煺縑<E785BA>荔<EFBFBD>SAE隡朞䌊<E69C9E>典<EFBFBD>撖?- <20><><EFBFBD>厩㴓憓<E3B493><E68693><EFBFBD>誯<EFBFBD><E8AAAF>臭誑<E887AD>典<EFBFBD><E585B8>券<EFBFBD>蝵脣<E89DB5>靽格㺿
|
||||
⚠️ **注意**:
|
||||
- 环境变量中的 `OSS_ACCESS_KEY_SECRET` 是敏感信息,SAE会自动加密
|
||||
- 所有环境变量都可以在应用部署后修改
|
||||
|
||||
##### <EFBFBD>亙熒璉<EFBFBD><EFBFBD>?
|
||||
| <20>滨蔭憿?| <20>?| 霂湔<E99C82> |
|
||||
##### 健康检查
|
||||
|
||||
| 配置项 | 值 | 说明 |
|
||||
|--------|---|------|
|
||||
| **<EFBFBD>亙熒璉<EFBFBD><EFBFBD>交䲮撘?* | HTTP | |
|
||||
| **<EFBFBD>亙熒璉<EFBFBD><EFBFBD>亥楝敺?* | `/api/health` | FastAPI<EFBFBD>亙熒璉<EFBFBD><EFBFBD>亦垢<EFBFBD>?|
|
||||
| **<EFBFBD>亙熒璉<EFBFBD><EFBFBD>亦垢<EFBFBD>?* | `8000` | |
|
||||
| **<EFBFBD>嘥<EFBFBD>撱嗉<EFBFBD><EFBFBD>園𡢿** | `40` 蝘?| 蝏䠷<E89D8F><E4A0B7>𤩺<EFBFBD><F0A4A9BA>硋<EFBFBD><E7A18B>滚𦛚<E6BB9A>臬𢆡<E887AC>蹱𧒄<E8B9B1>?|
|
||||
| **璉<EFBFBD><EFBFBD>仿𡢿<EFBFBD>?* | `30` 蝘?| |
|
||||
| **璉<EFBFBD><EFBFBD>亥<EFBFBD><EFBFBD>?* | `10` 蝘?| |
|
||||
| **<EFBFBD>亙熒<EFBFBD><EFBFBD><EFBFBD>?* | `2` 甈?| 餈䂿賒2甈⊥<E79488><E28AA5>蠘<EFBFBD>銝箏<E98A9D>摨?|
|
||||
| **銝滚<EFBFBD>摨琿<EFBFBD><EFBFBD>?* | `3` 甈?| 餈䂿賒3甈∪仃韐亥<E99F90>銝箔<E98A9D><E7AE94>亙熒 |
|
||||
| **健康检查方式** | HTTP | |
|
||||
| **健康检查路径** | `/api/health` | FastAPI健康检查端点 |
|
||||
| **健康检查端口** | `8000` | |
|
||||
| **初始延迟时间** | `40` 秒 | 给镜像拉取和服务启动留时间 |
|
||||
| **检查间隔** | `30` 秒 | |
|
||||
| **检查超时** | `10` 秒 | |
|
||||
| **健康阈值** | `2` 次 | 连续2次成功视为健康 |
|
||||
| **不健康阈值** | `3` 次 | 连续3次失败视为不健康 |
|
||||
|
||||
<EFBFBD>孵稬 **銝衤<E98A9D>甇?*
|
||||
点击 **下一步**
|
||||
|
||||
---
|
||||
|
||||
#### 2.4 网络配置
|
||||
|
||||
| <EFBFBD>滨蔭憿?| <20>?| 霂湔<E99C82> |
|
||||
| 配置项 | 值 | 说明 |
|
||||
|--------|---|------|
|
||||
| **专有网络VPC** | `vpc-2ze055cptkew9c38w4r06` | ai-clinical-vpc |
|
||||
| **虚拟交换机vSwitch** | `vsw-2zevacop039bxrmj6yc0c` | 可用区F |
|
||||
| **摰匧<EFBFBD>蝏?* | `sg-2zedk6fi8sgmmcwdu7tu` | |
|
||||
| **SLB<EFBFBD>祉<EFBFBD>霈輸䔮** | **銝漤<E98A9D>蝵?* | 隞<><E99A9E>蝵𤏸挪<F0A48FB8>?|
|
||||
| **安全组** | `sg-2zedk6fi8sgmmcwdu7tu` | |
|
||||
| **SLB公网访问** | **不配置** | 仅内网访问 |
|
||||
|
||||
<EFBFBD>孵稬 **銝衤<E98A9D>甇?*
|
||||
点击 **下一步**
|
||||
|
||||
---
|
||||
|
||||
#### 2.5 摨𠉛鍂<EFBFBD>笔𦶢<EFBFBD>冽<EFBFBD><EFBFBD>滨蔭嚗<EFBFBD>虾<EFBFBD>㚁<EFBFBD>雿輻鍂暺䁅恕<EFBFBD>喳虾嚗?
|
||||
| <20>滨蔭憿?| 暺䁅恕<E48185>?| 霂湔<E99C82> |
|
||||
|--------|--------|------|
|
||||
| **<2A>臬𢆡頞<F0A286A1>𧒄<EFBFBD>園𡢿** | 300蝘?| <20>𨅯<EFBFBD>颲<EFBFBD>之嚗屸<E59A97>閬<EFBFBD><E996AC><EFBFBD>踹鍳<E8B8B9>冽𧒄<E586BD>?|
|
||||
| **隡㗛<E99AA1><E3979B>𨀣㦤頞<E3A6A4>𧒄** | 30蝘?| 蝏坔<E89D8F><E59D94>典<EFBFBD><E585B8><EFBFBD><EFBFBD>敶枏<E695B6>霂瑟<E99C82><E7919F><EFBFBD>𧒄<EFBFBD>?|
|
||||
#### 2.5 应用生命周期配置(可选,使用默认即可)
|
||||
|
||||
<EFBFBD>孵稬 **銝衤<E98A9D>甇?*
|
||||
| 配置项 | 默认值 | 说明 |
|
||||
|--------|--------|------|
|
||||
| **启动超时时间** | 300秒 | 镜像较大,需要较长启动时间 |
|
||||
| **优雅停机超时** | 30秒 | 给应用处理完当前请求的时间 |
|
||||
|
||||
点击 **下一步**
|
||||
|
||||
---
|
||||
|
||||
#### 2.6 确认配置
|
||||
|
||||
1. 仔细检查所有配置项是否正确
|
||||
2. <20>孵<EFBFBD>蝖株恕嚗? - <20>?<3F>𨅯<EFBFBD><F0A885AF>啣<EFBFBD>雿輻鍂VPC<50><43><EFBFBD><EFBFBD>啣<EFBFBD>
|
||||
- <20>?摰硺<E691B0><E7A1BA>?= 1嚗<31><E59A97><EFBFBD>?嚗? - <20>?OSS<53>臬<EFBFBD><E887AC>㗛<EFBFBD>撌脤<E6928C>蝵? - <20>?<3F>亙熒璉<E78692><E79289>亥楝敺<E6A59D>蛹 `/api/health`
|
||||
2. 特别确认:
|
||||
- ✅ 镜像地址使用VPC内网地址
|
||||
- ✅ 实例数 = 1(不是0)
|
||||
- ✅ OSS环境变量已配置
|
||||
- ✅ 健康检查路径为 `/api/health`
|
||||
3. 点击 **创建应用**
|
||||
|
||||
---
|
||||
|
||||
### 甇仿炊 3嚗𡁶<E59A97>敺<EFBFBD><E695BA>蝵脣<E89DB5><E884A3>?
|
||||
<EFBFBD>函蔡餈<EFBFBD><EFBFBD>憭抒漲<EFBFBD><EFBFBD>閬?**3-5<><35><EFBFBD>**嚗玺AE隡朞䌊<E69C9E>冽<EFBFBD>銵䔶誑銝𧢲郊撉歹<E69289>
|
||||
### 步骤 3:等待部署完成
|
||||
|
||||
部署过程大约需要 **3-5分钟**,SAE会自动执行以下步骤:
|
||||
|
||||
```
|
||||
1. <20>匧<EFBFBD>Docker<65>𨅯<EFBFBD>嚗<EFBFBD>漲2-3<><33><EFBFBD>嚗屸<E59A97><E5B1B8>?.12GB嚗? <20>婙<EFBFBD> 雿輻鍂VPC<50><43><EFBFBD>嚗屸<E59A97>笔漲颲<E6BCB2>翰
|
||||
1. 拉取Docker镜像(约2-3分钟,镜像1.12GB)
|
||||
└─ 使用VPC内网,速度较快
|
||||
2. 启动容器(约30秒)
|
||||
└─ 执行Dockerfile中的CMD命令
|
||||
3. <20>亙熒璉<E78692><E79289>伐<EFBFBD>蝥?-2<><32><EFBFBD>嚗? <20>婙<EFBFBD> 蝑匧<E89D91>40蝘鍦<E89D98>撘<EFBFBD>憪𧢲<E686AA><F0A7A2B2>?/api/health
|
||||
4. 摨𠉛鍂餈鞱<E9A488>銝哨<E98A9D><E593A8>函蔡<E587BD>𣂼<EFBFBD>嚗? <20>婙<EFBFBD> 摰硺<E691B0><E7A1BA>嗆<EFBFBD><E59786><EFBFBD>銝?餈鞱<E9A488>銝?
|
||||
3. 健康检查(约1-2分钟)
|
||||
└─ 等待40秒后开始检查 /api/health
|
||||
4. 应用运行中(部署成功)
|
||||
└─ 实例状态变为"运行中"
|
||||
```
|
||||
|
||||
**摰墧𧒄<EFBFBD>烐綉<EFBFBD>函蔡餈𥕦漲**嚗?- SAE<41>批<EFBFBD><E689B9>?<3F>?摨𠉛鍂霂行<E99C82> <20>?<3F>䀹凒霈啣<E99C88> <20>?<3F>亦<EFBFBD>霂行<E99C82>
|
||||
**实时监控部署进度**:
|
||||
- SAE控制台 → 应用详情 → 变更记录 → 查看详情
|
||||
|
||||
**<EFBFBD>亦<EFBFBD><EFBFBD>函蔡<EFBFBD>亙<EFBFBD>**嚗?- SAE<41>批<EFBFBD><E689B9>?<3F>?摨𠉛鍂霂行<E99C82> <20>?<3F>亙<EFBFBD><E4BA99>亥砭 <20>?摰墧𧒄<E5A2A7>亙<EFBFBD>
|
||||
**查看部署日志**:
|
||||
- SAE控制台 → 应用详情 → 日志查询 → 实时日志
|
||||
|
||||
**憸<EFBFBD><EFBFBD><EFBFBD>亙<EFBFBD><EFBFBD><EFBFBD>捆**嚗?```log
|
||||
**预期日志内容**:
|
||||
```log
|
||||
INFO: Started server process [1]
|
||||
INFO: Waiting for application startup.
|
||||
INFO: Application startup complete.
|
||||
@@ -222,58 +246,73 @@ INFO: Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
|
||||
|
||||
---
|
||||
|
||||
## <EFBFBD>函蔡<EFBFBD>𡡞<EFBFBD>霂?
|
||||
## 部署后验证
|
||||
|
||||
### 步骤 1:获取内网访问地址
|
||||
|
||||
**⚠️ 关键步骤:必须从SAE控制台获取真实内网IP**
|
||||
|
||||
#### <EFBFBD>瑕<EFBFBD><EFBFBD>寞<EFBFBD>嚗?
|
||||
1. SAE<41>批<EFBFBD><E689B9>?<3F>?摨𠉛鍂<F0A0899B>𡑒” <20>?<3F>孵稬 `python-extraction-test`
|
||||
2. 餈𥕦<EFBFBD>摨𠉛鍂霂行<EFBFBD>憿?3. <20>曉<EFBFBD> **摰硺<E691B0><E7A1BA>𡑒”** <20>?**<2A>箸𧋦靽⊥<E99DBD>**
|
||||
#### 获取方法:
|
||||
|
||||
1. SAE控制台 → 应用列表 → 点击 `python-extraction-test`
|
||||
2. 进入应用详情页
|
||||
3. 找到 **实例列表** 或 **基本信息**
|
||||
4. 查看 **内网IP地址**
|
||||
|
||||
**憸<EFBFBD><EFBFBD><EFBFBD>澆<EFBFBD>**嚗?```
|
||||
<EFBFBD><EFBFBD><EFBFBD>IP嚗?72.17.x.x
|
||||
蝡臬藁嚗?000
|
||||
**预期格式**:
|
||||
```
|
||||
内网IP:172.17.x.x
|
||||
端口:8000
|
||||
完整地址:http://172.17.x.x:8000
|
||||
```
|
||||
|
||||
**<2A>𩤃<EFBFBD> <20>滩<EFBFBD>**嚗?- <20>?銝滩<E98A9D><E6BBA9>𨀣<EFBFBD><F0A880A3>笔<EFBFBD>嚗<EFBFBD><E59A97> `extraction-service.internal`嚗?- <20>?銝滩<E98A9D>雿輻鍂 `localhost:8000`
|
||||
- <20>?敹<>◆雿輻鍂SAE<41>批<EFBFBD><E689B9>唳遬蝷箇<E89DB7><E7AE87>笔<EFBFBD>IP<49>啣<EFBFBD>
|
||||
**⚠️ 重要**:
|
||||
- ❌ 不要猜测域名(如 `extraction-service.internal`)
|
||||
- ❌ 不要使用 `localhost:8000`
|
||||
- ✅ 必须使用SAE控制台显示的真实IP地址
|
||||
|
||||
**霈啣<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>啣<EFBFBD>**嚗?```
|
||||
# <20>?撌脰繮<E884B0>硋<EFBFBD>蝵穃𧑐<E7A983><F0A79190>嚗?024-12-24嚗㚁<E59A97>
|
||||
**记录内网地址**:
|
||||
```
|
||||
# ✅ 已获取内网地址(2024-12-24):
|
||||
PYTHON_SERVICE_INTERNAL_IP=172.17.173.66:8000
|
||||
PYTHON_SERVICE_URL=http://172.17.173.66:8000
|
||||
```
|
||||
|
||||
<EFBFBD>𩤃<EFBFBD> **<2A>滩<EFBFBD><E6BBA9>鞾<EFBFBD>**嚗?- 甇文𧑐<E69687><F0A79190>隞<EFBFBD>銁VPC<50><43><EFBFBD><EFBFBD>航挪<E888AA>?- Node.js<6A>𡒊垢<F0A1928A><E59EA2>閬<EFBFBD><E996AC>蝵格迨<E6A0BC>啣<EFBFBD>雿靝蛹<E99D9D>臬<EFBFBD><E887AC>㗛<EFBFBD>
|
||||
- 憒<><E68692>摰硺<E691B0><E7A1BA>滚鍳嚗䬠P<E4ACA0>啣<EFBFBD><E595A3>航<EFBFBD>隡𡁜<E99AA1><F0A1819C>吔<EFBFBD><E59094><EFBFBD><EFBFBD>齿鰵<E9BDBF>瑕<EFBFBD>嚗?
|
||||
⚠️ **重要提醒**:
|
||||
- 此地址仅在VPC内网可访问
|
||||
- Node.js后端需要配置此地址作为环境变量
|
||||
- 如果实例重启,IP地址可能会变化(需重新获取)
|
||||
|
||||
---
|
||||
|
||||
### 甇仿炊 2嚗𡁜<E59A97>摨瑟<E691A8><E7919F>交<EFBFBD>霂?
|
||||
#### <20>寞<EFBFBD> 1嚗帋<E59A97>SAE<41>批<EFBFBD><E689B9>唳<EFBFBD>霂𤏪<E99C82><F0A48FAA>刻<EFBFBD>嚗?
|
||||
1. SAE<41>批<EFBFBD><E689B9>?<3F>?摨𠉛鍂霂行<E99C82> <20>?摰硺<E691B0><E7A1BA>𡑒”
|
||||
2. <20>孵稬摰硺<E691B0><E7A1BA>?**Webshell** <20>厰僼嚗<E583BC><E59A97><EFBFBD>𨀣𣈲<F0A880A3><F0A388B2><EFBFBD>
|
||||
### 步骤 2:健康检查测试
|
||||
|
||||
#### 方法 1:从SAE控制台测试(推荐)
|
||||
|
||||
1. SAE控制台 → 应用详情 → 实例列表
|
||||
2. 点击实例的 **Webshell** 按钮(如果支持)
|
||||
3. 执行命令(使用Python测试,因为容器中没有curl):
|
||||
```bash
|
||||
python -c "import urllib.request; print(urllib.request.urlopen('http://localhost:8000/api/health').read().decode())"
|
||||
```
|
||||
|
||||
<EFBFBD>𩤃<EFBFBD> **瘜冽<E7989C>**嚗𡁜<E59A97><F0A1819C>𣈯<EFBFBD><F0A388AF>?`curl: command not found`嚗諹秩<EFBFBD>𤾸捆<EFBFBD>其葉瘝⊥<EFBFBD>摰㕑<EFBFBD>curl撌亙<EFBFBD>嚗<EFBFBD>移蝞<EFBFBD><EFBFBD>𨅯<EFBFBD>嚗㚁<EFBFBD>霂瑚蝙<EFBFBD>其<EFBFBD><EFBFBD>Y<EFBFBD>Python<EFBFBD>賭誘<EFBFBD>?
|
||||
⚠️ **注意**:如果遇到 `curl: command not found`,说明容器中没有安装curl工具(精简镜像),请使用上面的Python命令。
|
||||
|
||||
#### 方法 2:从本地测试(需要临时配置)
|
||||
|
||||
<EFBFBD>𩤃<EFBFBD> **瘜冽<E7989C>**嚗𡁶眏鈭窰ython<6F>滚𦛚隞<F0A69B9A>銁VPC<50><43><EFBFBD>嚗峕𧋦<E5B395>唳<EFBFBD>瘜閧凒<E996A7>亥挪<E4BAA5>殷<EFBFBD><E6AEB7><EFBFBD>閬<EFBFBD>誑銝衤遙銝<E98199><E98A9D>寞<EFBFBD>嚗?
|
||||
⚠️ **注意**:由于Python服务仅在VPC内网,本地无法直接访问,需要以下任一方法:
|
||||
|
||||
**选项A:通过Node.js后端转发(推荐)**
|
||||
- 待Node.js后端部署后,通过后端间接测试
|
||||
|
||||
**<EFBFBD>厰★B嚗帋葩<EFBFBD>園<EFBFBD>蝵桀<EFBFBD>蝵騌LB嚗<EFBFBD><EFBFBD>霂訫<EFBFBD><EFBFBD>𣂼<EFBFBD><EFBFBD>𣳇膄嚗?*
|
||||
1. SAE<EFBFBD>批<EFBFBD><EFBFBD>?<3F>?摨𠉛鍂霂行<E99C82> <20>?摨𠉛鍂霈輸䔮霈曄蔭
|
||||
**选项B:临时配置公网SLB(测试完成后删除)**
|
||||
1. SAE控制台 → 应用详情 → 应用访问设置
|
||||
2. 点击 **绑定SLB**
|
||||
3. 创建或选择公网SLB
|
||||
4. 测试完成后立即删除SLB
|
||||
|
||||
**憸<EFBFBD><EFBFBD><EFBFBD>滚<EFBFBD>**嚗?```json
|
||||
**预期响应**:
|
||||
```json
|
||||
{
|
||||
"status": "healthy",
|
||||
"checks": {
|
||||
@@ -283,7 +322,7 @@ PYTHON_SERVICE_URL=http://172.17.173.66:8000
|
||||
},
|
||||
"nougat": {
|
||||
"available": false,
|
||||
"error": "Nougat<EFBFBD>芸<EFBFBD>鋆<EFBFBD><EFBFBD>撌脩宏<EFBFBD>支誑<EFBFBD>誩<EFBFBD><EFBFBD>𨅯<EFBFBD>嚗?
|
||||
"error": "Nougat未安装(已移除以减小镜像)"
|
||||
},
|
||||
"temp_dir": {
|
||||
"path": "/tmp/extraction_service",
|
||||
@@ -296,34 +335,40 @@ PYTHON_SERVICE_URL=http://172.17.173.66:8000
|
||||
|
||||
---
|
||||
|
||||
### 甇仿炊 3嚗𡁏䰻<F0A1818F>见<EFBFBD><E8A781>冽𠯫敹?
|
||||
1. SAE<41>批<EFBFBD><E689B9>?<3F>?摨𠉛鍂霂行<E99C82> <20>?<3F>亙<EFBFBD><E4BA99>亥砭
|
||||
### 步骤 3:查看应用日志
|
||||
|
||||
1. SAE控制台 → 应用详情 → 日志查询
|
||||
2. 选择 **实时日志**
|
||||
3. 确认日志中包含:
|
||||
|
||||
```log
|
||||
<EFBFBD>?甇<>虜<EFBFBD>臬𢆡<E887AC><F0A286A1><EFBFBD>嚗?INFO: Started server process [1]
|
||||
✅ 正常启动标志:
|
||||
INFO: Started server process [1]
|
||||
INFO: Application startup complete.
|
||||
INFO: Uvicorn running on http://0.0.0.0:8000
|
||||
|
||||
<EFBFBD>?<3F>亙熒璉<E78692><E79289>交𠯫敹梹<E695B9>瘥?0蝘雴<E89D98>甈∴<E79488>嚗?INFO: 172.17.x.x:xxxx - "GET /api/health HTTP/1.1" 200 OK
|
||||
✅ 健康检查日志(每30秒一次):
|
||||
INFO: 172.17.x.x:xxxx - "GET /api/health HTTP/1.1" 200 OK
|
||||
|
||||
<EFBFBD>?憒<><E68692><EFBFBD>箇緵<E7AE87>躰秤嚗?ERROR: ImportError: libXXX.so: cannot open shared object file
|
||||
<20>?霂湔<E99C82>蝟餌<E89D9F>靘肽<E99D98>蝻箏仃嚗峕<E59A97><E5B395>主ockerfile
|
||||
❌ 如果出现错误:
|
||||
ERROR: ImportError: libXXX.so: cannot open shared object file
|
||||
→ 说明系统依赖缺失,检查Dockerfile
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 甇仿炊 4嚗𡁶<E59A97><F0A181B6>批<EFBFBD><E689B9>函𠶖<E587BD>?
|
||||
SAE<EFBFBD>批<EFBFBD><EFBFBD>?<3F>?摨𠉛鍂霂行<E99C82> <20>?<3F>箸𧋦靽⊥<E99DBD>
|
||||
### 步骤 4:监控应用状态
|
||||
|
||||
**<2A>喲睸<E596B2><E79DB8><EFBFBD>**嚗?| <20><><EFBFBD> | 甇<>虜<EFBFBD>?| 霂湔<E99C82> |
|
||||
SAE控制台 → 应用详情 → 基本信息
|
||||
|
||||
**关键指标**:
|
||||
| 指标 | 正常值 | 说明 |
|
||||
|------|--------|------|
|
||||
| **摨𠉛鍂<EFBFBD>嗆<EFBFBD>?* | 餈鞱<E9A488>銝?| 蝏輯𠧧 |
|
||||
| **摰硺<EFBFBD><EFBFBD>?* | 1/1 | 1銝芸<EFBFBD>靘贝<EFBFBD>銵䔶葉 |
|
||||
| **<EFBFBD>亙熒摰硺<EFBFBD><EFBFBD>?* | 1 | <20>亙熒璉<E78692><E79289>仿<EFBFBD>朞<EFBFBD> |
|
||||
| **CPU雿輻鍂<EFBFBD>?* | < 20% | 蝛粹𤦭<EFBFBD>嗆<EFBFBD>?|
|
||||
| **<EFBFBD><EFBFBD><EFBFBD>雿輻鍂<EFBFBD>?* | < 50% | 蝥?GB嚗㇊ython<6F>箇<EFBFBD>+靘肽<E99D98>嚗?|
|
||||
| **应用状态** | 运行中 | 绿色 |
|
||||
| **实例数** | 1/1 | 1个实例运行中 |
|
||||
| **健康实例数** | 1 | 健康检查通过 |
|
||||
| **CPU使用率** | < 20% | 空闲状态 |
|
||||
| **内存使用率** | < 50% | 约1GB(Python基础+依赖) |
|
||||
|
||||
---
|
||||
|
||||
@@ -331,18 +376,22 @@ SAE控制
|
||||
|
||||
### 步骤 1:更新Node.js后端环境变量
|
||||
|
||||
<EFBFBD>沐ode.js<EFBFBD>𡒊垢<EFBFBD><EFBFBD>AE摨𠉛鍂銝哨<EFBFBD>瘛餃<EFBFBD>隞乩<EFBFBD><EFBFBD>臬<EFBFBD><EFBFBD>㗛<EFBFBD>嚗?
|
||||
在Node.js后端的SAE应用中,添加以下环境变量:
|
||||
|
||||
```bash
|
||||
# Python微服务内网地址
|
||||
EXTRACTION_SERVICE_URL=http://172.17.x.x:8000
|
||||
|
||||
# 瘜冽<EFBFBD>嚗?# 1. <20>踵揢銝箏<E98A9D><E7AE8F><EFBFBD>繮<EFBFBD>𣇉<EFBFBD><F0A38789><EFBFBD><EFBFBD>IP
|
||||
# 2. 銝滩<EFBFBD><EFBFBD>惩偏<EFBFBD>冽<EFBFBD><EFBFBD>?/
|
||||
# 注意:
|
||||
# 1. 替换为实际获取的内网IP
|
||||
# 2. 不要加尾部斜杠 /
|
||||
```
|
||||
|
||||
**<EFBFBD>滨蔭雿滨蔭**嚗?- SAE<41>批<EFBFBD><E689B9>?<3F>?Node.js<6A>𡒊垢摨𠉛鍂 <20>?摨𠉛鍂<F0A0899B>滨蔭 <20>?<3F>臬<EFBFBD><E887AC>㗛<EFBFBD> <20>?瘛餃<E7989B>
|
||||
**配置位置**:
|
||||
- SAE控制台 → Node.js后端应用 → 应用配置 → 环境变量 → 添加
|
||||
|
||||
**<EFBFBD>滨蔭<EFBFBD>擧<EFBFBD>雿?*嚗?- <20>滚鍳Node.js<6A>𡒊垢摨𠉛鍂嚗𠄎AE隡朞䌊<E69C9E>券<EFBFBD><E588B8>荔<EFBFBD>
|
||||
**配置后操作**:
|
||||
- 重启Node.js后端应用(SAE会自动重启)
|
||||
|
||||
---
|
||||
|
||||
@@ -362,7 +411,8 @@ router.get('/test-python-service', async (req, res) => {
|
||||
try {
|
||||
const extractionServiceUrl = process.env.EXTRACTION_SERVICE_URL || 'http://localhost:8000';
|
||||
|
||||
// 1. 瘚贝<EFBFBD><EFBFBD>亙熒璉<EFBFBD><EFBFBD>? const healthRes = await axios.get(`${extractionServiceUrl}/api/health`);
|
||||
// 1. 测试健康检查
|
||||
const healthRes = await axios.get(`${extractionServiceUrl}/api/health`);
|
||||
|
||||
res.json({
|
||||
success: true,
|
||||
@@ -381,11 +431,13 @@ router.get('/test-python-service', async (req, res) => {
|
||||
export default router;
|
||||
```
|
||||
|
||||
**瘚贝<EFBFBD><EFBFBD>寞<EFBFBD>**嚗?```bash
|
||||
**测试方法**:
|
||||
```bash
|
||||
# 从前端或Postman访问
|
||||
GET https://your-backend-domain.com/api/test-python-service
|
||||
|
||||
# 憸<EFBFBD><EFBFBD><EFBFBD>滚<EFBFBD>嚗?{
|
||||
# 预期响应:
|
||||
{
|
||||
"success": true,
|
||||
"message": "Python service is healthy",
|
||||
"data": { "status": "healthy", ... }
|
||||
@@ -396,45 +448,58 @@ GET https://your-backend-domain.com/api/test-python-service
|
||||
|
||||
### 步骤 3:端到端功能测试
|
||||
|
||||
瘚贝<EFBFBD>摰峕㟲銝𡁜𦛚瘚<EFBFBD><EFBFBD>嚗?
|
||||
测试完整业务流程:
|
||||
|
||||
#### 测试场景 1:PDF文本提取
|
||||
|
||||
**瘚<EFBFBD><EFBFBD>**嚗?```
|
||||
**流程**:
|
||||
```
|
||||
前端上传PDF
|
||||
<EFBFBD>?Node.js<EFBFBD>𡒊垢<EFBFBD>交𤣰
|
||||
<EFBFBD>?HTTP POST 頧砍<EFBFBD><EFBFBD>?Python<EFBFBD>滚𦛚 (EXTRACTION_SERVICE_URL)
|
||||
<EFBFBD>?Python<EFBFBD>滚𦛚<EFBFBD>𣂼<EFBFBD><EFBFBD><EFBFBD>𧋦
|
||||
<EFBFBD>?餈𥪜<E9A488>JSON蝏𤘪<EFBFBD>
|
||||
<EFBFBD>?<3F>𡒊垢憭<E59EA2><E686AD>撟嗉<E6929F><E59789>𧼮<EFBFBD>蝡?```
|
||||
→ Node.js后端接收
|
||||
→ HTTP POST 转发到 Python服务 (EXTRACTION_SERVICE_URL)
|
||||
→ Python服务提取文本
|
||||
→ 返回JSON结果
|
||||
→ 后端处理并返回前端
|
||||
```
|
||||
|
||||
**瘚贝<EFBFBD>甇仿炊**嚗?1. <20>典<EFBFBD>蝡臭<E89DA1>隡牐<E99AA1>銝芸<E98A9D><E88AB8><EFBFBD>DF<44><46>辣嚗? 5MB嚗?2. <20>亦<EFBFBD>Node.js<6A>𡒊垢<F0A1928A>亙<EFBFBD>嚗? ```log
|
||||
**测试步骤**:
|
||||
1. 在前端上传一个小的PDF文件(< 5MB)
|
||||
2. 查看Node.js后端日志:
|
||||
```log
|
||||
INFO: Calling Python service: http://172.17.x.x:8000/api/extract/pdf
|
||||
INFO: Python service responded in 2.3s
|
||||
```
|
||||
3. <EFBFBD>亦<EFBFBD>Python<EFBFBD>滚𦛚<EFBFBD>亙<EFBFBD>嚗? ```log
|
||||
3. 查看Python服务日志:
|
||||
```log
|
||||
INFO: Request: POST /api/extract/pdf
|
||||
INFO: File size: 1.2MB, filename: test.pdf
|
||||
INFO: Using PyMuPDF extraction
|
||||
INFO: Response: 200 (took 2.10s)
|
||||
```
|
||||
|
||||
#### 瘚贝<EFBFBD><EFBFBD>箸艶 2嚗𡁏㺭<F0A1818F>格<EFBFBD>瘣梹<E798A3>DC撌亙<E6928C>嚗?
|
||||
**瘚<><E7989A>**嚗?```
|
||||
#### 测试场景 2:数据清洗(DC工具)
|
||||
|
||||
**流程**:
|
||||
```
|
||||
前端上传Excel
|
||||
<EFBFBD>?<3F>𡒊垢靚<E59EA2>鍂 Python<EFBFBD>滚𦛚 /api/operations/fillna
|
||||
<EFBFBD>?Python雿輻鍂pandas/polars憭<EFBFBD><EFBFBD>
|
||||
<EFBFBD>?餈𥪜<E9A488>皜<EFBFBD><E79A9C><EFBFBD>𡒊<EFBFBD><F0A1928A>唳旿
|
||||
→ 后端调用 Python服务 /api/operations/fillna
|
||||
→ Python使用pandas/polars处理
|
||||
→ 返回清洗后的数据
|
||||
```
|
||||
|
||||
**瘚贝<EFBFBD>甇仿炊**嚗?1. <20>求C璅∪<E79285>銝𠹺<E98A9D>Excel<65><6C>辣
|
||||
2. <EFBFBD>扯<EFBFBD><EFBFBD>唳旿皜<EFBFBD><EFBFBD><EFBFBD>滢<EFBFBD>嚗<EFBFBD><EFBFBD>fillna嚗?3. 撉諹<E69289>餈𥪜<E9A488>蝏𤘪<E89D8F><F0A498AA>臬炏甇<E7828F>&
|
||||
**测试步骤**:
|
||||
1. 在DC模块上传Excel文件
|
||||
2. 执行数据清洗操作(如fillna)
|
||||
3. 验证返回结果是否正确
|
||||
|
||||
---
|
||||
|
||||
## 常见问题排查
|
||||
|
||||
### <EFBFBD>桅<EFBFBD> 1嚗𡁻<E59A97><F0A181BB>𤩺<EFBFBD><F0A4A9BA>硋仃韐伐<E99F90>insufficient_scope: authorization failed嚗?
|
||||
**<2A><>𠶖**嚗?```
|
||||
### 问题 1:镜像拉取失败(insufficient_scope: authorization failed)
|
||||
|
||||
**症状**:
|
||||
```
|
||||
Error: ImagePullBackOff
|
||||
Failed to pull image: insufficient_scope: authorization failed
|
||||
pull access denied, repository does not exist or may require authorization
|
||||
@@ -442,71 +507,84 @@ pull access denied, repository does not exist or may require authorization
|
||||
|
||||
**根本原因**:SAE没有权限访问ACR私有镜像仓库
|
||||
|
||||
**閫<EFBFBD><EFBFBD>甇仿炊**嚗?
|
||||
**<2A>寞<EFBFBD>1嚗𡁻<E59A97>蝵桅<E89DB5><E6A185>譍<EFBFBD>摨栞恕霂<E68195><E99C82><EFBFBD>刻<EFBFBD>嚗?*
|
||||
**解决步骤**:
|
||||
|
||||
1. SAE<41>批<EFBFBD><E689B9>?<3F>?摨𠉛鍂霂行<E99C82> <20>?<3F>孵稬"<22>函蔡摨𠉛鍂"<22>?蝻𤥁<E89DBB>摨𠉛鍂"
|
||||
2. <20>?**"<22>𨅯<EFBFBD><F0A885AF>滨蔭"** <20>典<EFBFBD>嚗峕𪄳<E5B395>?**"<22>𨅯<EFBFBD>隞枏<E99A9E>霈方<E99C88>"** <20>?**"蝘<><E89D98><EFBFBD>𨅯<EFBFBD>隞枏<E99A9E>"**
|
||||
3. <EFBFBD>滨蔭隞乩<EFBFBD>靽⊥<EFBFBD>嚗? ```
|
||||
**方法1:配置镜像仓库认证(推荐)**
|
||||
|
||||
1. SAE控制台 → 应用详情 → 点击"部署应用"或"编辑应用"
|
||||
2. 在 **"镜像配置"** 部分,找到 **"镜像仓库认证"** 或 **"私有镜像仓库"**
|
||||
3. 配置以下信息:
|
||||
```
|
||||
镜像仓库地址:crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com
|
||||
用户名:gofeng117@163.com
|
||||
密码:fengzhibo117
|
||||
```
|
||||
4. 靽嘥<EFBFBD><EFBFBD>滨蔭撟園<EFBFBD><EFBFBD>圈<EFBFBD>蝵?
|
||||
4. 保存配置并重新部署
|
||||
|
||||
**方法2:使用RAM角色授权(生产环境推荐)**
|
||||
|
||||
1. RAM<EFBFBD>批<EFBFBD><EFBFBD>?<3F>?<3F>𥕦遣閫坿𠧧 <20>?<3F>㗇𥋘"<22>輸<EFBFBD>鈭烐<E988AD><E78390>? <20>?<3F>𦯀縑<F0A6AF80>滚𦛚<E6BB9A>?SAE"
|
||||
1. RAM控制台 → 创建角色 → 选择"阿里云服务" → 受信服务选"SAE"
|
||||
2. 为角色添加权限:`AliyunContainerRegistryReadOnlyAccess`
|
||||
3. SAE摨𠉛鍂<EFBFBD>滨蔭 <20>?擃条漣霈曄蔭 <20>?蝏穃<E89D8F>RAM閫坿𠧧
|
||||
3. SAE应用配置 → 高级设置 → 绑定RAM角色
|
||||
|
||||
**<EFBFBD>寞<EFBFBD>3嚗朞挽蝵唧CR隞枏<EFBFBD>銝箏<EFBFBD>撘<EFBFBD>嚗<EFBFBD><EFBFBD>瘚贝<EFBFBD><EFBFBD>臬<EFBFBD>嚗?*
|
||||
**方法3:设置ACR仓库为公开(仅测试环境)**
|
||||
|
||||
<EFBFBD>𩤃<EFBFBD> 銝齿綫<E9BDBF>鞟<EFBFBD>鈭抒㴓憓<E3B493>蝙<EFBFBD>剁<EFBFBD>摰匧<E691B0>憌𡡞埯嚗?
|
||||
1. ACR<43>批<EFBFBD><E689B9>?<3F>?銝芯犖摰硺<E691B0> <20>?隞枏<E99A9E><E69E8F>𡑒”
|
||||
⚠️ 不推荐生产环境使用(安全风险)
|
||||
|
||||
1. ACR控制台 → 个人实例 → 仓库列表
|
||||
2. 找到 `ai-clinical/python-extraction`
|
||||
3. 隞枏<EFBFBD>霈曄蔭 <20>?霈輸䔮<E8BCB8>批<EFBFBD> <20>?<3F>嫣蛹"<22>砍<EFBFBD>"
|
||||
3. 仓库设置 → 访问控制 → 改为"公开"
|
||||
|
||||
---
|
||||
|
||||
### <EFBFBD>桅<EFBFBD> 2嚗𡁜<E59A97><F0A1819C>典鍳<E585B8>典仃韐伐<E99F90><E4BC90>嗡<EFBFBD><E597A1>笔<EFBFBD>嚗?
|
||||
**<2A><>𠶖**嚗?```
|
||||
### 问题 2:应用启动失败(其他原因)
|
||||
|
||||
**症状**:
|
||||
```
|
||||
SAE控制台显示:应用启动失败
|
||||
实例状态:异常
|
||||
```
|
||||
|
||||
**<EFBFBD>埝䰻甇仿炊**嚗?
|
||||
**排查步骤**:
|
||||
|
||||
**1. 查看部署日志**
|
||||
```
|
||||
SAE<EFBFBD>批<EFBFBD><EFBFBD>?<3F>?摨𠉛鍂霂行<E99C82> <20>?<3F>䀹凒霈啣<E99C88> <20>?<3F>亦<EFBFBD>霂行<E99C82>
|
||||
SAE控制台 → 应用详情 → 变更记录 → 查看详情
|
||||
```
|
||||
|
||||
**2. 撣貉<EFBFBD><EFBFBD>躰秤<EFBFBD>𡃏圾<EFBFBD>單䲮瘜?*嚗?
|
||||
**2. 常见错误及解决方法**:
|
||||
|
||||
| 错误信息 | 原因 | 解决方法 |
|
||||
|---------|------|---------|
|
||||
| `ImagePullBackOff` + `failed to resolve reference "...:latest"` | **镜像地址未指定版本号** | **在镜像地址末尾添加 `:v1.0`**<br>完整地址:`...python-extraction:v1.0` |
|
||||
| `ImagePullBackOff` + `insufficient_scope: authorization failed` | **ACR霈輸䔮<EFBFBD><EFBFBD><EFBFBD>銝滩雲嚗<EFBFBD><EFBFBD>撣貉<EFBFBD>嚗?* | **<EFBFBD>滨蔭<EFBFBD>𨅯<EFBFBD>隞枏<EFBFBD>霈方<EFBFBD>**<br>1. SAE摨𠉛鍂<F0A0899B>滨蔭 <20>?<3F>𨅯<EFBFBD><F0A885AF>滨蔭<br>2. <20>滨蔭<E6BBA8>𨅯<EFBFBD>隞枏<E99A9E>霈方<E99C88><br>3. <20>冽<EFBFBD><E586BD>㵪<EFBFBD>`gofeng117@163.com`<br>4. 撖<EFBFBD><EFBFBD>嚗䫤fengzhibo117` |
|
||||
| `ImagePullBackOff` + `insufficient_scope: authorization failed` | **ACR访问权限不足(最常见)** | **配置镜像仓库认证**<br>1. SAE应用配置 → 镜像配置<br>2. 配置镜像仓库认证<br>3. 用户名:`gofeng117@163.com`<br>4. 密码:`fengzhibo117` |
|
||||
| `ImagePullBackOff` + `pull access denied` | 镜像仓库认证失败 | 检查用户名/密码是否正确 |
|
||||
| `ImagePullBackOff` | <EFBFBD>𨅯<EFBFBD><EFBFBD>啣<EFBFBD><EFBFBD>躰秤 | 蝖株恕雿輻鍂VPC<50><43><EFBFBD><EFBFBD>啣<EFBFBD>嚗<EFBFBD>蒂-vpc<70>𡒊<EFBFBD>嚗?|
|
||||
| `ImagePullBackOff` | 镜像地址错误 | 确认使用VPC内网地址(带-vpc后缀) |
|
||||
| `ImportError: libXXX.so` | 系统依赖缺失 | 检查Dockerfile,确保安装了所有运行时依赖 |
|
||||
| `OOMKilled` | <EFBFBD><EFBFBD><EFBFBD>銝滩雲 | 憓𧼮<E68693><F0A7BCAE><EFBFBD><EFBFBD><EFBFBD>滨蔭嚗?GB <EFBFBD>?4GB嚗?|
|
||||
| `Health check failed` | <EFBFBD>亙熒璉<EFBFBD><EFBFBD>交𧊋<EFBFBD>朞<EFBFBD> | 璉<><E79289>?`/api/health` 蝡舐<EFBFBD><EFBFBD>臬炏甇<EFBFBD>虜 |
|
||||
| `OOMKilled` | 内存不足 | 增加内存配置(2GB → 4GB) |
|
||||
| `Health check failed` | 健康检查未通过 | 检查 `/api/health` 端点是否正常 |
|
||||
|
||||
**3. 查看容器日志**
|
||||
```
|
||||
SAE<EFBFBD>批<EFBFBD><EFBFBD>?<3F>?摨𠉛鍂霂行<E99C82> <20>?<3F>亙<EFBFBD><E4BA99>亥砭 <20>?摰墧𧒄<E5A2A7>亙<EFBFBD>
|
||||
SAE控制台 → 应用详情 → 日志查询 → 实时日志
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### <EFBFBD>桅<EFBFBD> 3嚗𡁜<E59A97>摨瑟<E691A8><E7919F>亙仃韐?
|
||||
**<2A><>𠶖**嚗?```
|
||||
摰硺<EFBFBD><EFBFBD>𡑒”<EFBFBD>曄內嚗𡁜<EFBFBD>摨瑟<EFBFBD><EFBFBD>亙仃韐?摰硺<E691B0><E7A1BA>滚<EFBFBD><E6BB9A>滚鍳
|
||||
### 问题 3:健康检查失败
|
||||
|
||||
**症状**:
|
||||
```
|
||||
实例列表显示:健康检查失败
|
||||
实例反复重启
|
||||
```
|
||||
|
||||
**<EFBFBD>埝䰻甇仿炊**嚗?
|
||||
**排查步骤**:
|
||||
|
||||
**1. 确认服务是否正常启动**
|
||||
```bash
|
||||
# <EFBFBD>亦<EFBFBD><EFBFBD>亙<EFBFBD>銝剜糓<EFBFBD>行<EFBFBD>嚗?INFO: Uvicorn running on http://0.0.0.0:8000
|
||||
# 查看日志中是否有:
|
||||
INFO: Uvicorn running on http://0.0.0.0:8000
|
||||
```
|
||||
|
||||
**2. 确认端口是否正确**
|
||||
@@ -515,45 +593,53 @@ SAE控制
|
||||
# 检查健康检查端口配置:8000
|
||||
```
|
||||
|
||||
**3. <EFBFBD>见𢆡瘚贝<EFBFBD><EFBFBD>亙熒璉<EFBFBD><EFBFBD>亦垢<EFBFBD>?*
|
||||
**3. 手动测试健康检查端点**
|
||||
```bash
|
||||
# 在SAE Webshell中执行:
|
||||
curl http://localhost:8000/api/health
|
||||
```
|
||||
|
||||
**4. 靚<EFBFBD>㟲<EFBFBD>亙熒璉<EFBFBD><EFBFBD>亙<EFBFBD><EFBFBD>?*
|
||||
**4. 调整健康检查参数**
|
||||
```
|
||||
初始延迟时间:40秒 → 60秒(如果镜像拉取慢)
|
||||
检查超时:10秒 → 20秒
|
||||
```
|
||||
<EFBFBD>嘥<EFBFBD>撱嗉<EFBFBD><EFBFBD>園𡢿嚗?0蝘?<3F>?60蝘𡜐<E89D98>憒<EFBFBD><E68692><EFBFBD>𨅯<EFBFBD><F0A885AF>匧<EFBFBD><E58CA7>g<EFBFBD>
|
||||
璉<EFBFBD><EFBFBD>亥<EFBFBD><EFBFBD>塚<EFBFBD>10蝘?<3F>?20蝘?```
|
||||
|
||||
---
|
||||
|
||||
### 问题 4:Node.js后端无法连接Python服务
|
||||
|
||||
**<EFBFBD><EFBFBD>𠶖**嚗?```
|
||||
**症状**:
|
||||
```
|
||||
后端日志:Connection refused
|
||||
<EFBFBD>?ECONNREFUSED: connect ECONNREFUSED 172.17.x.x:8000
|
||||
或
|
||||
ECONNREFUSED: connect ECONNREFUSED 172.17.x.x:8000
|
||||
```
|
||||
|
||||
**<EFBFBD>埝䰻甇仿炊**嚗?
|
||||
**排查步骤**:
|
||||
|
||||
**1. 确认内网地址是否正确**
|
||||
```bash
|
||||
# <EFBFBD>?<3F>躰秤<E8BAB0>滨蔭嚗<E894AD><E59A97>瘚讠<E7989A><E8AEA0>笔<EFBFBD>嚗?EXTRACTION_SERVICE_URL=http://python-extraction.internal:8000
|
||||
# ❌ 错误配置(猜测的域名)
|
||||
EXTRACTION_SERVICE_URL=http://python-extraction.internal:8000
|
||||
|
||||
# <EFBFBD>?甇<>&<EFBFBD>滨蔭嚗𠄎AE<41>批<EFBFBD><E689B9>唳遬蝷箇<E89DB7><E7AE87>笔<EFBFBD>IP嚗?EXTRACTION_SERVICE_URL=http://172.17.10.5:8000
|
||||
# ✅ 正确配置(SAE控制台显示的真实IP)
|
||||
EXTRACTION_SERVICE_URL=http://172.17.10.5:8000
|
||||
```
|
||||
|
||||
**2. 确认Python服务是否运行**
|
||||
```
|
||||
SAE<EFBFBD>批<EFBFBD><EFBFBD>?<3F>?Python摨𠉛鍂 <20>?摰硺<E691B0><E7A1BA>𡑒”
|
||||
<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>餈鞱<EFBFBD>銝?<3F>?```
|
||||
|
||||
**3. 蝖株恕摰匧<E691B0>蝏<EFBFBD><E89D8F><EFBFBD>?*
|
||||
```
|
||||
SAE<EFBFBD>批<EFBFBD><EFBFBD>?<3F>?Python摨𠉛鍂 <20>?蝵𤑳<E89DB5><F0A491B3>滨蔭 <20>?摰匧<E691B0>蝏?<3F>亦<EFBFBD>閫<EFBFBD><E996AB>嚗𡁜<E59A97>霈禽PC<50><43>挪<EFBFBD>?8000蝡臬藁
|
||||
SAE控制台 → Python应用 → 实例列表
|
||||
状态:运行中 ✅
|
||||
```
|
||||
|
||||
**4. 瘚贝<EFBFBD><EFBFBD><EFBFBD><EFBFBD>餈鮋<EFBFBD>𡁏<EFBFBD>?*
|
||||
**3. 确认安全组规则**
|
||||
```
|
||||
SAE控制台 → Python应用 → 网络配置 → 安全组
|
||||
入站规则:允许VPC内访问 8000端口
|
||||
```
|
||||
|
||||
**4. 测试内网连通性**
|
||||
```bash
|
||||
# 在Node.js后端容器中执行(通过SAE Webshell):
|
||||
curl http://172.17.x.x:8000/api/health
|
||||
@@ -563,14 +649,18 @@ curl http://172.17.x.x:8000/api/health
|
||||
|
||||
### 问题 5:PDF提取超时
|
||||
|
||||
**<EFBFBD><EFBFBD>𠶖**嚗?```
|
||||
**症状**:
|
||||
```
|
||||
后端日志:Request timeout after 300s
|
||||
Python日志:Processing large PDF...
|
||||
```
|
||||
|
||||
**<EFBFBD>笔<EFBFBD>**嚗?- <20><>辣餈<E8BEA3>之嚗? 50MB嚗?- PDF<44><46>鉄憭折<E686AD><E68A98>曄<EFBFBD>
|
||||
**原因**:
|
||||
- 文件过大(> 50MB)
|
||||
- PDF包含大量图片
|
||||
|
||||
**解决方法**:
|
||||
|
||||
**閫<><E996AB><EFBFBD>寞<EFBFBD>**嚗?
|
||||
**1. 增加超时时间**
|
||||
```bash
|
||||
# Node.js后端环境变量
|
||||
@@ -595,18 +685,21 @@ async def extract_pdf(file: UploadFile):
|
||||
|
||||
---
|
||||
|
||||
### <EFBFBD>桅<EFBFBD> 6嚗𡁜<E59A97>摮䀹滯<E480B9>綽<EFBFBD>OOM嚗?
|
||||
**<2A><>𠶖**嚗?```
|
||||
### 问题 6:内存溢出(OOM)
|
||||
|
||||
**症状**:
|
||||
```
|
||||
容器自动重启
|
||||
日志显示:Killed (signal 9)
|
||||
实例监控:内存使用率 > 95%
|
||||
```
|
||||
|
||||
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>**嚗?
|
||||
**解决方法**:
|
||||
|
||||
**1. 增加内存配置**
|
||||
```
|
||||
SAE<EFBFBD>批<EFBFBD><EFBFBD>?<3F>?摨𠉛鍂<F0A0899B>滨蔭 <20>?閫<>聢
|
||||
<EFBFBD><EFBFBD><EFBFBD>嚗?GB <EFBFBD>?4GB
|
||||
SAE控制台 → 应用配置 → 规格
|
||||
内存:2GB → 4GB
|
||||
```
|
||||
|
||||
**2. 优化代码(流式处理)**
|
||||
@@ -624,61 +717,74 @@ from fastapi import FastAPI
|
||||
from starlette.middleware.base import BaseHTTPMiddleware
|
||||
|
||||
app = FastAPI()
|
||||
# <EFBFBD>𣂼<EFBFBD>撟嗅<EFBFBD>餈墧𦻖<EFBFBD>?app.add_middleware(ConnectionLimitMiddleware, max_connections=10)
|
||||
# 限制并发连接数
|
||||
app.add_middleware(ConnectionLimitMiddleware, max_connections=10)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 附录
|
||||
|
||||
### A. 敹恍<EFBFBD>笔𦶢隞文<EFBFBD><EFBFBD>?
|
||||
**<2A>亦<EFBFBD>摨𠉛鍂靽⊥<E99DBD>**嚗?```bash
|
||||
### A. 快速命令参考
|
||||
|
||||
**查看应用信息**:
|
||||
```bash
|
||||
# 阿里云CLI
|
||||
aliyun sae DescribeApplicationStatus --AppId <app-id>
|
||||
```
|
||||
|
||||
**<EFBFBD>亦<EFBFBD>摰硺<EFBFBD><EFBFBD>𡑒”**嚗?```bash
|
||||
**查看实例列表**:
|
||||
```bash
|
||||
# 阿里云CLI
|
||||
aliyun sae DescribeApplicationInstances --AppId <app-id>
|
||||
```
|
||||
|
||||
**<EFBFBD>滚鍳摨𠉛鍂**嚗?```
|
||||
SAE<EFBFBD>批<EFBFBD><EFBFBD>?<3F>?摨𠉛鍂霂行<E99C82> <20>?<3F>滚鍳摨𠉛鍂
|
||||
**重启应用**:
|
||||
```
|
||||
SAE控制台 → 应用详情 → 重启应用
|
||||
```
|
||||
|
||||
**<EFBFBD>亦<EFBFBD>摰墧𧒄<EFBFBD>亙<EFBFBD>**嚗?```
|
||||
SAE<EFBFBD>批<EFBFBD><EFBFBD>?<3F>?摨𠉛鍂霂行<E99C82> <20>?<3F>亙<EFBFBD><E4BA99>亥砭 <20>?摰墧𧒄<E5A2A7>亙<EFBFBD>
|
||||
**查看实时日志**:
|
||||
```
|
||||
SAE控制台 → 应用详情 → 日志查询 → 实时日志
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### B. 环境变量配置清单
|
||||
|
||||
| <EFBFBD>㗛<EFBFBD><EFBFBD>?| 敹<><E695B9> | 暺䁅恕<E48185>?| 霂湔<E99C82> |
|
||||
| 变量名 | 必需 | 默认值 | 说明 |
|
||||
|--------|-----|--------|------|
|
||||
| `LOG_LEVEL` | <EFBFBD>?| `INFO` | <EFBFBD>亙<EFBFBD>蝥批<EFBFBD>嚗㇄EBUG/INFO/WARNING/ERROR嚗?|
|
||||
| `TEMP_DIR` | <EFBFBD>?| `/tmp/extraction_service` | 銝湔𧒄<EFBFBD><EFBFBD>辣<EFBFBD>桀<EFBFBD> |
|
||||
| `TZ` | <EFBFBD>?| `UTC` | <EFBFBD>嗅躹嚗<EFBFBD>遣霈?`Asia/Shanghai`嚗?|
|
||||
| `SERVICE_NAME` | <EFBFBD>?| - | <EFBFBD>滚𦛚<EFBFBD>滨妍嚗<EFBFBD>鍂鈭擧𠯫敹埈<EFBFBD>霂<EFBFBD><EFBFBD> |
|
||||
| `SERVICE_VERSION` | <EFBFBD>?| - | <EFBFBD>滚𦛚<EFBFBD><EFBFBD>𧋦嚗<EFBFBD>鍂鈭擧𠯫敹埈<EFBFBD>霂<EFBFBD><EFBFBD> |
|
||||
| `OSS_ACCESS_KEY_ID` | <EFBFBD>?| - | OSS霈輸䔮撖<EFBFBD>𤨎ID |
|
||||
| `OSS_ACCESS_KEY_SECRET` | <EFBFBD>?| - | OSS霈輸䔮撖<EFBFBD>𤨎Secret |
|
||||
| `OSS_BUCKET` | <EFBFBD>?| - | OSS Bucket<EFBFBD>滨妍 |
|
||||
| `OSS_ENDPOINT` | <EFBFBD>?| - | OSS Endpoint嚗<EFBFBD>遣霈桀<EFBFBD>蝵𡢅<EFBFBD> |
|
||||
| `LOG_LEVEL` | 否 | `INFO` | 日志级别(DEBUG/INFO/WARNING/ERROR) |
|
||||
| `TEMP_DIR` | 否 | `/tmp/extraction_service` | 临时文件目录 |
|
||||
| `TZ` | 否 | `UTC` | 时区(建议 `Asia/Shanghai`) |
|
||||
| `SERVICE_NAME` | 否 | - | 服务名称(用于日志标识) |
|
||||
| `SERVICE_VERSION` | 否 | - | 服务版本(用于日志标识) |
|
||||
| `OSS_ACCESS_KEY_ID` | 是 | - | OSS访问密钥ID |
|
||||
| `OSS_ACCESS_KEY_SECRET` | 是 | - | OSS访问密钥Secret |
|
||||
| `OSS_BUCKET` | 是 | - | OSS Bucket名称 |
|
||||
| `OSS_ENDPOINT` | 是 | - | OSS Endpoint(建议内网) |
|
||||
|
||||
---
|
||||
|
||||
### C. <EFBFBD>函蔡璉<EFBFBD><EFBFBD>交<EFBFBD><EFBFBD>?
|
||||
**<2A>函蔡<E587BD>?*嚗?- [ ] 蝖株恕Docker<65>𨅯<EFBFBD>撌脫綫<E884AB><E7B6AB>秐ACR
|
||||
### C. 部署检查清单
|
||||
|
||||
**部署前**:
|
||||
- [ ] 确认Docker镜像已推送至ACR
|
||||
- [ ] 确认VPC、vSwitch、安全组ID
|
||||
- [ ] 确认OSS AccessKey有效
|
||||
- [ ] 蝖株恕SAE<EFBFBD>賢<EFBFBD>蝛粹𡢿撌脣<EFBFBD>撱?
|
||||
**<2A>函蔡銝?*嚗?- [ ] <20>𨅯<EFBFBD><F0A885AF>啣<EFBFBD>雿輻鍂VPC<50><43><EFBFBD><EFBFBD>啣<EFBFBD>
|
||||
- [ ] 摰硺<E691B0><E7A1BA>?= 1嚗<31><E59A97><EFBFBD>?嚗?- [ ] 摰孵膥蝡臬藁 = 8000
|
||||
- [ ] <EFBFBD>亙熒璉<EFBFBD><EFBFBD>亥楝敺?= `/api/health`
|
||||
- [ ] 确认SAE命名空间已创建
|
||||
|
||||
**部署中**:
|
||||
- [ ] 镜像地址使用VPC内网地址
|
||||
- [ ] 实例数 = 1(不是0)
|
||||
- [ ] 容器端口 = 8000
|
||||
- [ ] 健康检查路径 = `/api/health`
|
||||
- [ ] 环境变量配置完整
|
||||
|
||||
**<EFBFBD>函蔡<EFBFBD>?*嚗?- [ ] 摨𠉛鍂<F0A0899B>嗆<EFBFBD>?= 餈鞱<E9A488>銝?- [ ] <20>亙熒璉<E78692><E79289>仿<EFBFBD>朞<EFBFBD>
|
||||
**部署后**:
|
||||
- [ ] 应用状态 = 运行中
|
||||
- [ ] 健康检查通过
|
||||
- [ ] 日志显示服务正常启动
|
||||
- [ ] 记录内网IP地址
|
||||
- [ ] 更新Node.js后端环境变量
|
||||
@@ -687,40 +793,52 @@ SAE控制
|
||||
|
||||
### D. 成本预估
|
||||
|
||||
**瘚贝<EFBFBD><EFBFBD>臬<EFBFBD>嚗<EFBFBD>蝠<EFBFBD>讐<EFBFBD>SAE嚗?*嚗?```
|
||||
閫<EFBFBD>聢嚗?<3F>?GB <20> 1摰硺<E691B0>
|
||||
韐寧鍂嚗𡁶漲 瞼60/<2F>?```
|
||||
**测试环境(轻量版SAE)**:
|
||||
```
|
||||
规格:1核2GB × 1实例
|
||||
费用:约 ¥60/月
|
||||
```
|
||||
|
||||
**隡睃<EFBFBD>撱箄悅**嚗?- 瘚贝<E7989A><E8B49D>嗆挾<E59786>臭誑<E887AD>见𢆡<E8A781>𨀣迫摨𠉛鍂嚗<E98D82><E59A97>甇W<E79487>銝滩恣韐對<E99F90>
|
||||
- 憭𣈯𡢿<EFBFBD>硋𪂹<EFBFBD>怠<EFBFBD>甇W<EFBFBD><EFBFBD>刻<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?- <20>煺漣<E785BA>臬<EFBFBD>撱箄悅雿輻鍂<E8BCBB><E98D82>僑<EFBFBD><E58391><EFBFBD>隡䀹<E99AA1>
|
||||
**优化建议**:
|
||||
- 测试阶段可以手动停止应用(停止后不计费)
|
||||
- 夜间或周末停止应用节省成本
|
||||
- 生产环境建议使用包年包月优惠
|
||||
|
||||
---
|
||||
|
||||
### E. 相关文档
|
||||
|
||||
- [<EFBFBD>函蔡餈𥕦漲<EFBFBD>餉<EFBFBD>](./00-<2D>函蔡餈𥕦漲<F0A595A6>餉<EFBFBD>.md) - <20><><EFBFBD>㕑<EFBFBD>皞鞾<E79A9E><E99EBE>䰻銵?- [Python敺格<E695BA><E6A0BC>?SAE摰孵膥<E5ADB5>函蔡<E587BD><E894A1><EFBFBD>](./04-Python敺格<E695BA><E6A0BC>?SAE摰孵膥<E5ADB5>函蔡<E587BD><E894A1><EFBFBD>.md) - <20><><EFBFBD>舀沲<E88880><E6B2B2>祕閫?- [敹恍<E695B9>罸<EFBFBD>蝵淞OP](./01-敹恍<E695B9>罸<EFBFBD>蝵淞OP-<2D>嗅抅蝖<E68A85><E89D96>?md) - 摰峕㟲<E5B395>函蔡瘚<E894A1><E7989A>
|
||||
- [部署进度总览](./00-部署进度总览.md) - 所有资源速查表
|
||||
- [Python微服务-SAE容器部署指南](./04-Python微服务-SAE容器部署指南.md) - 技术架构详解
|
||||
- [快速部署SOP](./01-快速部署SOP-零基础版.md) - 完整部署流程
|
||||
|
||||
---
|
||||
|
||||
**<EFBFBD><EFBFBD>﹝蝏湔擪**嚗?- <20>𥕦遣<F0A595A6>園𡢿嚗?024-12-24
|
||||
**文档维护**:
|
||||
- 创建时间:2024-12-24
|
||||
- 最后更新:2024-12-24
|
||||
- 銝𧢲活摰⊥䰻嚗?025-01-24
|
||||
- 下次审查:2025-01-24
|
||||
|
||||
---
|
||||
|
||||
**<EFBFBD>函蔡摰峕<EFBFBD><EFBFBD>𠬍<EFBFBD>霂瑁扇敶蓥誑銝衤縑<EFBFBD>?*嚗?
|
||||
**部署完成后,请记录以下信息**:
|
||||
|
||||
```
|
||||
<EFBFBD>函蔡<EFBFBD>園𡢿嚗?024-12-24 19:43
|
||||
部署时间:2024-12-24 19:43
|
||||
内网IP地址:http://172.17.173.66:8000
|
||||
擐𡝗活<EFBFBD>亙熒璉<EFBFBD><EFBFBD>仿<EFBFBD>朞<EFBFBD><EFBFBD>園𡢿嚗?024-12-24 19:44
|
||||
首次健康检查通过时间:2024-12-24 19:44
|
||||
SAE应用名称:python-extraction-test
|
||||
应用类型:轻量版应用
|
||||
閫<EFBFBD>聢<EFBFBD>滨蔭嚗?<3F>?GB <EFBFBD> 1摰硺<EFBFBD>
|
||||
<EFBFBD>函蔡<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?<3F>𣂼<EFBFBD>
|
||||
憭<EFBFBD>釣嚗?- 閫<><E996AB>鈭<EFBFBD>CR<43>𨅯<EFBFBD><F0A885AF>匧<EFBFBD><E58CA7><EFBFBD><EFBFBD><EFBFBD>桅<EFBFBD>嚗<EFBFBD><E59A97>蝵桐<E89DB5><E6A190>𨅯<EFBFBD>隞枏<E99A9E>霈方<E99C88>嚗?- 閫<><E996AB>鈭<EFBFBD><E988AD><EFBFBD>𤩺<EFBFBD>蝑暸䔮憸矋<E686B8><E79F8B><EFBFBD><EFBFBD>鈭?v1.0<EFBFBD><EFBFBD>𧋦嚗?- 摨𠉛鍂甇<E98D82>虜餈鞱<E9A488>嚗?銝沿vicorn worker餈𤤿<E9A488>
|
||||
规格配置:1核2GB × 1实例
|
||||
部署状态:✅ 成功
|
||||
备注:
|
||||
- 解决了ACR镜像拉取权限问题(配置了镜像仓库认证)
|
||||
- 解决了镜像标签问题(指定了:v1.0版本)
|
||||
- 应用正常运行,2个uvicorn worker进程
|
||||
- OpenBLAS警告可忽略(不影响功能)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
> **<EFBFBD>鞟內**嚗𡁻<E59A97>蝵脣<E89DB5><E884A3>𣂼<EFBFBD>嚗諹窈<E8ABB9>𦠜𧒄<F0A6A09C>湔鰵 [<5B>函蔡餈𥕦漲<F0A595A6>餉<EFBFBD>.md](./00-<2D>函蔡餈𥕦漲<F0A595A6>餉<EFBFBD>.md) 銝剔<E98A9D><E58994><EFBFBD><EFBFBD><EFBFBD>啣<EFBFBD>嚗?
|
||||
> **提示**:部署完成后,请及时更新 [部署进度总览.md](./00-部署进度总览.md) 中的内网地址!
|
||||
|
||||
|
||||
Reference in New Issue
Block a user