mirror of
https://18126008609:longquanjian123@gitee.com/feigong123/aurask.git
synced 2026-04-19 20:03:53 +00:00
215 lines
5.4 KiB
Markdown
215 lines
5.4 KiB
Markdown
# Aurask k3s / DevCloud 部署说明
|
||
|
||
本文档基于当前仓库与 DevCloud 现网结构，兼顾两部分目标：
|
||
|
||
- 保留已落地的 DevCloud `base + production overlay` 部署方式
|
||
- 纳入本次新增的门户登录流、Google 登录、Langflow / AnythingLLM 嵌入配置
|
||
|
||
## 目录结构
|
||
|
||
```text
|
||
deploy/k3s/
|
||
README.md
|
||
base/
|
||
namespace.yaml
|
||
aurask-runtime-config.yaml
|
||
aurask-config.yaml
|
||
aurask-api-pvc.yaml
|
||
aurask-api.yaml
|
||
aurask-worker.yaml
|
||
aurask-web.yaml
|
||
aurask-manager.yaml
|
||
postgres.yaml
|
||
redis.yaml
|
||
kustomization.yaml
|
||
secrets.example.yaml
|
||
overlays/
|
||
production/
|
||
kustomization.yaml
|
||
aurask-api-production.yaml
|
||
aurask-worker-production.yaml
|
||
aurask-web-production.yaml
|
||
aurask-manager-production.yaml
|
||
postgres-production.yaml
|
||
redis-production.yaml
|
||
runtime-config-production.yaml
|
||
examples/
|
||
aurask-runtime-secrets.example.yaml
|
||
aurask-postgres-secret.example.yaml
|
||
aurask-redis-secret.example.yaml
|
||
```
|
||
|
||
## 当前 DevCloud 现网映射
|
||
|
||
### 域名与入口
|
||
|
||
- 公网域名：`https://aurask.xyz`
|
||
- `https://aurask.xyz/api/*` → `aurask-api`
|
||
- `https://aurask.xyz/*` → `aurask-web`
|
||
- 当前由前端宿主机 Caddy 转发到 DevCloud NodePort
|
||
|
||
### 已知镜像与端口
|
||
|
||
- API 镜像：`registry.mydevcloud.love/devcloud/aurask-api:latest`
|
||
- Web 镜像：`registry.mydevcloud.love/devcloud/aurask-web:latest`
|
||
- Manager 镜像：`registry.mydevcloud.love/devcloud/aurask-manager:latest`
|
||
- `aurask-api` NodePort：`30091`
|
||
- `aurask-web` NodePort：`30090`
|
||
- `aurask-manager` NodePort：`30092`
|
||
|
||
### 生产 overlay 节点绑定
|
||
|
||
- `aurask-api`：`devcloud-trade-agent-1`
|
||
- `aurask-worker`：`devcloud-trade-agent-1`
|
||
- `postgres`：`devcloud-trade-agent-1`
|
||
- `redis`：`devcloud-trade-agent-1`
|
||
- `aurask-web`：`devcloud-trade-agent-2`
|
||
- `aurask-manager`：`devcloud-trade-agent-2`
|
||
|
||
## Base 层职责
|
||
|
||
`deploy/k3s/base/` 保持通用资源，不直接写死生产节点：
|
||
|
||
- `namespace.yaml`：Aurask namespace
|
||
- `aurask-runtime-config.yaml`：桥接/运行时基础配置
|
||
- `aurask-config.yaml`：站点、门户、登录、嵌入默认配置
|
||
- `aurask-api-pvc.yaml`：MVP 状态文件持久化
|
||
- `aurask-api.yaml`：API Deployment + Service
|
||
- `aurask-worker.yaml`：Worker Deployment
|
||
- `aurask-web.yaml`：用户门户 Deployment + Service
|
||
- `aurask-manager.yaml`：管理员门户 Deployment + Service
|
||
- `postgres.yaml`：PostgreSQL / PGVector 基础资源
|
||
- `redis.yaml`：Redis 基础资源
|
||
|
||
## 本次新增的门户配置
|
||
|
||
### `aurask-config.yaml`
|
||
|
||
新增以下站点默认值：
|
||
|
||
- `AURASK_PUBLIC_BASE_URL=https://aurask.xyz`
|
||
- `AURASK_PUBLIC_API_BASE_URL=https://aurask.xyz/api`
|
||
- `AURASK_PUBLIC_LANGFLOW_URL=https://aurask.xyz/runtime/langflow/`
|
||
- `AURASK_PUBLIC_ANYTHINGLLM_URL=https://aurask.xyz/runtime/anythingllm/`
|
||
- `AURASK_DEVCLOUD_API_IMAGE=registry.mydevcloud.love/devcloud/aurask-api:latest`
|
||
- `AURASK_DEVCLOUD_WEB_IMAGE=registry.mydevcloud.love/devcloud/aurask-web:latest`
|
||
- `AURASK_DEVCLOUD_API_NODE_URL=http://45.113.2.55:30091`
|
||
- `AURASK_DEVCLOUD_WEB_NODE_URL=http://45.113.2.55:30090`
|
||
- `AURASK_GOOGLE_ENABLED=true`
|
||
- `AURASK_SESSION_TTL_DAYS=7`
|
||
|
||
### `secrets.example.yaml`
|
||
|
||
新增门户与外部组件需要的 Secret 占位：
|
||
|
||
- `AURASK_DATABASE_URL`
|
||
- `AURASK_ANYTHINGLLM_API_KEY`
|
||
- `AURASK_LANGFLOW_API_KEY`
|
||
- `AURASK_GOOGLE_CLIENT_ID`
|
||
|
||
说明：
|
||
|
||
- `secrets.example.yaml` 仅作模板，不应直接提交真实密钥
|
||
- 生产建议继续使用 `External Secrets Operator` 或 `SOPS + age`
|
||
|
||
## API / Web 部署说明
|
||
|
||
### `aurask-api`
|
||
|
||
职责：
|
||
|
||
- API Gateway
|
||
- Google 登录
|
||
- Session 签发与校验
|
||
- 配额、订单、支付、工作流入口
|
||
- 返回门户配置与嵌入 URL
|
||
|
||
配置说明：
|
||
|
||
- 继续挂载 `/data/state.json`，兼容当前 MVP `JsonStore`
|
||
- 同时读取：
|
||
- `aurask-runtime-config`
|
||
- `aurask-config`
|
||
- `aurask-runtime-secrets`
|
||
- `aurask-secrets`
|
||
|
||
### `aurask-web`
|
||
|
||
职责：
|
||
|
||
- 承载 `protal/`
|
||
- 对外提供 `/signin`
|
||
- 登录后提供 `Workflows` / `Knowledge Base` 双标签工作台
|
||
|
||
## 生产 overlay 说明
|
||
|
||
`deploy/k3s/overlays/production/` 负责绑定现网特定配置：
|
||
|
||
- NodeSelector
|
||
- NodePort
|
||
- 生产 runtime 开关
|
||
|
||
当前生产 overlay 已保留：
|
||
|
||
- `aurask-api-production.yaml`
|
||
- `aurask-worker-production.yaml`
|
||
- `aurask-web-production.yaml`
|
||
- `aurask-manager-production.yaml`
|
||
- `postgres-production.yaml`
|
||
- `redis-production.yaml`
|
||
- `runtime-config-production.yaml`
|
||
|
||
## 运行时嵌入建议
|
||
|
||
当前门户已经引用：
|
||
|
||
- `https://aurask.xyz/runtime/langflow/`
|
||
- `https://aurask.xyz/runtime/anythingllm/`
|
||
|
||
建议后续分两步完成：
|
||
|
||
1. 先由公网反代到内部运行时入口
|
||
2. 再收敛为 `aurask-api` 网关代理鉴权，避免直接暴露运行时
|
||
|
||
## 300 MAU 首版建议
|
||
|
||
### 集群规模
|
||
|
||
- `3` 台 k3s server
|
||
- `2` 台 general worker
|
||
- `2` 台 runtime worker
|
||
|
||
### 组件建议
|
||
|
||
- `aurask-api`
|
||
- `aurask-web`
|
||
- `aurask-worker`
|
||
- `aurask-manager`
|
||
- PostgreSQL + PGVector
|
||
- Redis
|
||
- 后续补充 Langflow / AnythingLLM 专用清单
|
||
|
||
## 部署方式
|
||
|
||
### 应用基础资源
|
||
|
||
```powershell
|
||
kubectl apply -k deploy/k3s/base
|
||
```
|
||
|
||
### 应用生产 overlay
|
||
|
||
```powershell
|
||
kubectl apply -k deploy/k3s/overlays/production
|
||
```
|
||
|
||
## 后续建议
|
||
|
||
建议继续推进：
|
||
|
||
1. 用 PostgreSQL Repository 替换 `JsonStore`
|
||
2. 让 `aurask-worker` 接入真实 Redis 队列消费
|
||
3. 为 Langflow / AnythingLLM 增加独立清单
|
||
4. 增加 Ingress / TLS / NetworkPolicy
|
||
5. 让运行时访问统一收敛到 Aurask 网关代理
|