docs(infra): 接入公网 RustFS 对象存储
ci / 质量门禁 (push) Canceled after 0s

背景:项目方提供公网 RustFS(https://oss.xinsenidea.com,桶 lingxi-dev)。
改动:.env.example 填入 endpoint / 桶名占位;README 与 A0 报告记录
对象存储接入方式与验证结果;真实密钥仅保存在本地 .env / .env.local。
影响面:环境变量样例与文档,无运行时代码变更。
回滚方式:还原 .env.example 与文档即可。
验证:list buckets、HEAD bucket、PUT/GET/DELETE 探针对象均成功;
format:check、lint、typecheck、test 全绿。
This commit is contained in:
Stev_Wang committed 2026-11-02 18:32:38 +08:00
1 parent 5628e158c0
commit 2f200fc9d9
3 files changed
+13 -13

No files matched your search

@@ -52,9 +52,9 @@
本地 PostgreSQL 与 Redis **复用本机已有 Docker 服务**,不另起容器:`docker-postgres-1`(PostgreSQL 18,`127.0.0.1:5432`,库 `lingxi`、用户 `postgres`、密码 `postgres`)与 `docker-redis-1`(`127.0.0.1:6379`)。仓库不包含任何数据库/缓存容器编排。CI services 使用标准 5432/6379,凭据同为 `postgres/postgres`。
### 4.2 对象存储待接入公网 RustFS
### 4.2 对象存储接入公网 RustFS
本地 Docker 不提供 S3 服务,`minio/minio` 镜像在当前网络也不可拉取。A0 代码不依赖对象存储(`/health` 只检查 DB 与 Redis),`.env.example` 保留 `S3_*` 占位;后续由项目方提供公网自建 RustFS 的 endpoint 与凭据后填写,应用侧继续只依赖 S3 协议。
本地 Docker 不提供 S3 服务,`minio/minio` 镜像在当前网络也不可拉取。项目方已提供公网 RustFS:`https://oss.xinsenidea.com`,桶 `lingxi-dev`。A0 代码不依赖对象存储(`/health` 只检查 DB 与 Redis),已在本地 `.env.local` / `.env` 配置 `S3_*` 并实测通过(list buckets、HEAD bucket、PUT / GET / DELETE 探针对象均成功)。三类产物(assets / renders / temp)暂共用 `lingxi-dev` 桶,A1 落地渲染链路时再按前缀或独立桶拆分。真实 access key / secret 不入库。
### 4.3 演示登录(A0 临时)
@@ -80,7 +80,7 @@ npm 上 `oasdiff` 为占位包(0.0.1-security),A0 暂用自研 `scripts/op
当前离线 Gitea 未部署 Actions runner,推送后远程 CI 会停留在 `queued`。A0 增加 `pnpm ci:local`:按 `.gitea/workflows/ci.yml` 的顺序在本地执行 compose、格式、Lint、类型、单测、构建、迁移与种子、集成、OpenAPI 契约与 e2e,全部通过才退出 0;runner 就绪后远程工作流可直接接管。
本地开发库为 `lingxi` / `postgres` / `postgres`,直接连接本机已有 PostgreSQL 容器;`.env.example` 与 CI services 保持一致;S3 待 RustFS 信息后配置。
本地开发库为 `lingxi` / `postgres` / `postgres`,直接连接本机已有 PostgreSQL 容器;`.env.example` 与 CI services 保持一致;对象存储已接入公网 RustFS(见 §4.2)。
### 4.8 前端视觉方向
@@ -98,7 +98,7 @@ npm 上 `oasdiff` 为占位包(0.0.1-security),A0 暂用自研 `scripts/op
1. **A1 必须移除演示登录**并接入真实 JWT / 刷新令牌 / 权限守卫。
2. 种子业务数据待 A1 / A3 / A4 / B0 表就绪后补齐(Q-A0-01)。
3. 对象存储待接入公网 RustFS;接入前不使用本地 S3 容器。
3. 对象存储为公网 RustFS 单桶,A1 需按产物类型落前缀或拆分桶,并在 CI 配置独立测试桶。
4. Web 主包约 599 kB(Semi 全量 CSS 689 kB),A0 接受;M1 前做路由级拆分与 Semi 按需样式。
5. 远程 CI 待 Gitea Actions runner 就绪后验证 services 与 Playwright 浏览器安装;当前以 `pnpm ci:local` 为准(已实测通过)。