OPC/chorus
2
0
Fork 0
Code Issues 11 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: clarify Portal YAML precedence (#56)

ila
2026-08-25 15:05:35 +08:00
parent 77dbfc1946
commit 15b778ecf2
1 changed files with 7 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Local-Development-and-Verification.-.md
+7 -6
@@ -318,12 +318,13 @@ git diff --check
内嵌 worker 的运行参数：
| 变量 | 非生产默认 | 生产要求 |
|---|---:|---|
| `CHORUS_WORKER_LEASE_SECONDS` | 60 | 必须显式设置，且大于 HTTP 超时 + 5 秒 |
| `CHORUS_WORKER_POLL_MILLISECONDS` | 250 | 必须显式设置 |
| `CHORUS_PROVIDER_HTTP_TIMEOUT_SECONDS` | 45 | 必须显式设置 |
| `CHORUS_PROVIDER_MAX_RESPONSE_BYTES` | 33554432 | 必须显式设置 |
| YAML 字段 | 环境覆盖变量 | 示例值与约束 |
|---|---|---|
| `worker.lease_seconds` | `CHORUS_WORKER_LEASE_SECONDS` | 60；必须大于 HTTP 超时 + 5 秒 |
| `worker.poll_milliseconds` | `CHORUS_WORKER_POLL_MILLISECONDS` | 250；正整数 |
| `provider.http_timeout_seconds` | `CHORUS_PROVIDER_HTTP_TIMEOUT_SECONDS` | 45；正整数 |
| `provider.max_response_bytes` | `CHORUS_PROVIDER_MAX_RESPONSE_BYTES` | 33554432；正整数 |
| `provider.allowed_ports` | `CHORUS_PROVIDER_ALLOWED_PORTS` | 默认示例为 80/443；仅显式加入所需公开端口 |
`CHORUS_TEST_DISABLE_WORKER=true` 仅供 `CHORUS_ENV=test` 的 Playwright fixture 使用。测试 helper 位于 `portal/web/e2e/fixture`，会按构造用户归属写入受控状态和测试图片；不得打包部署，也不得用于开发或生产数据。mock 上游的自动测试通过依赖注入连接本地 fixture，不允许把回环地址加入生产 SSRF 白名单。