docs: self-host env for Lark APaaS templates
This commit is contained in:
@@ -9,6 +9,37 @@
|
||||
5. 健康检查:实现 `/healthz` 或约定路径,写入 `spec.healthcheckPath`。
|
||||
6. Dokploy **不要每次 cleanCache**。
|
||||
7. **有状态数据写挂载路径**(见下),不要只写容器可写层。
|
||||
8. **本控制面 = 自部署(self-host)**,不是飞书妙搭/TCE 平台托管。
|
||||
|
||||
### 飞书 APaaS / 妙搭模板(`@lark-apaas/*`)自部署
|
||||
|
||||
模板里的 `PlatformModule.forRoot()` 会启用平台 HttpClient(`platform.enabled: true`),启动时**必须**有:
|
||||
|
||||
```text
|
||||
FORCE_AUTHN_INNERAPI_DOMAIN=<基础域名>
|
||||
```
|
||||
|
||||
否则:
|
||||
|
||||
```text
|
||||
Error: 平台模式需要基础域名,请设置环境变量 FORCE_AUTHN_INNERAPI_DOMAIN
|
||||
```
|
||||
|
||||
**控制面在 `apply` 时自动注入**(无需用户填妙搭平台域名):
|
||||
|
||||
| 变量 | 值 |
|
||||
|------|-----|
|
||||
| `FORCE_AUTHN_INNERAPI_DOMAIN` | 应用公网 URL(`https://buxi*****.DOMAIN_ROOT`) |
|
||||
| `FORCE_FRAMEWORK_DISABLE_DATAPASS` | `true`(关掉 TCE datapass 中间件) |
|
||||
| `FORCE_FRAMEWORK_ENVIRONMENT` | 默认 `development` |
|
||||
| `SERVER_HOST` / `SERVER_PORT` / `PORT` | `0.0.0.0` + `spec.port` |
|
||||
| `COMPANY_DEPLOY_SELF_HOST` | `true` |
|
||||
|
||||
说明:
|
||||
|
||||
- 这只保证 **进程能启动**;飞书开放平台能力(多维表格等)仍需业务侧配置 `FEISHU_*` / 应用凭证。
|
||||
- 若应用硬依赖妙搭登录态,自部署还需业务改登录(本地账号 / 自建 OAuth),与控制面注入无关。
|
||||
- 已上线的老应用:再 `apply` 一次,或 Dokploy 手动补上表中变量后 Redeploy。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user