文档: 设计文档与问题记录归档

docs/01-技术文档/团队级基建-部署与运维-2026-10-05.md

@@ -0,0 +1,36 @@
+# DevFlow 团队级基建 — 部署与运维
+
+> 2026-10-05 落地。架构定位见《数据存储架构-定稿-2026-10-05》(团队级 = 汇聚节点 + 对象存储)。
+
+## 资源清单
+
+| 资源 | 位置 | 版本/规格 | 用途 |
+|---|---|---|---|
+| PG 容器 `df-pg` | ecs-os(39.99.131.191) | PostgreSQL 18.6-alpine | devflow 团队库(服务端数据面) |
+| OSS 私有桶 `devflow-data` | 阿里云 cn-hongkong | 私有 ACL | 团队文件存储(温层,内容寻址) |
+| 域名 `df-oss.1216.top` | CNAME → devflow-data.oss-cn-hongkong.aliyuncs.com | HTTPS(泛域名证书已绑) | 桶访问入口 |
+
+## PG(df-pg)
+
+- 连接:`127.0.0.1:5432`(仅本机/内网,**不暴露公网**);服务端将来部署 ecs-os 时走 localhost
+- 库:`devflow`(容器首启自动创建);用户 postgres
+- 凭据:`/data/docker-apps/pg/.pg-credentials`(600 权限)
+- compose:`/data/docker-apps/pg/docker-compose.yml`(服务名=容器名 df-pg,数据卷自包含 `/data/docker-apps/pg/data`)
+- 备份:cron 每日 03:30 `/data/scripts/pg-backup.sh` → `/data/backup/pg/` 保留 7 份
+
+## OSS(devflow-data)
+
+- 访问:私有桶,读写须签名(oss2 AK:ops-kit/app.yml aliyun.accounts[4],即 zhub-site 归属主账号)
+- HTTPS:泛域名 `*.1216.top` 证书(suke-dev /etc/letsencrypt/live/1216.top)已绑 CNAME;归属验证 TXT 已用毕删除
+- 服务端用法:oss2 SDK 签发临时 URL 供客户端下载;上传走 SDK 直传
+- 续期注意:证书到期随泛域名统一续期(Let's Encrypt DNS-01),续期后需重新 put_bucket_cname(参考 cert-manage)
+
+## 升级记录
+
+- 2026-10-05 建 PG 16 当日即升 18.6(库空无损);compose 风格对齐 ecs-os 惯例(注释头/服务名=容器名/卷自包含);旧顶层卷 /data/pg-data 已清
+- 选型记录:文件桶定阿里云 OSS(七牛私有桶缺主账号 SK,qshell 双账号 uppt/lakeapp-suke 已确认;七牛保留公开 CDN 分工 img.1216.top)
+
+## 关联
+
+- 架构:《数据存储架构-定稿-2026-10-05》§六 团队级/平台级
+- 服务索引:kms/服务索引-全机器.md(df-oss/df-pg 两行)