From 6fd8cf897e1f4e4ab20944d57fc2cb439fded057 Mon Sep 17 00:00:00 2001 From: Fam Zheng Date: Mon, 4 May 2026 10:57:30 +0100 Subject: [PATCH] Initial cube docs: README + oci migration todo MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit cube 是跑在 famzheng.me 节点上的小 app 平台，用来收纳从 oci 迁过来的 Fam 个人小工具。oci 主机本身留给 Hera，不退役。 - README.md：定位、迁移名单、注意事项 - doc/todo.md：迁移清单（portfolio / repo-vis / simpleasm / guitar / pyroblem） --- README.md | 32 ++++++++++++++++++++++++++++++++ doc/todo.md | 24 ++++++++++++++++++++++++ 2 files changed, 56 insertions(+) create mode 100644 README.md create mode 100644 doc/todo.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..2e37279 --- /dev/null +++ b/README.md @@ -0,0 +1,32 @@ +# cube + +Fam 的小 app 平台。 + +## 是什么 + +`cube` 是一个跑在 **`famzheng.me` 节点**（hostname `famzheng.com`，单节点 k3s + traefik + gitea，公网 IP `178.104.186.206`）上的小 app 平台，专门收纳 Fam 自己写的一堆小工具/玩具 web app。底层硬件、k3s、Gitea、act_runner 等基础设施详见 `~/.claude/memory/infra.md`。 + +主要任务：把目前散落在 `oci.euphon.net`（Oracle Cloud ARM VM）上**值得留下**的 Fam 个人小 app 迁过来。oci 主机本身不退役，留给 Hera 同学继续用。 + +## 当前状态 + +- 仓库刚初始化（2026-05-04），还没有任何部署清单 / 脚本。 +- 迁移名单和注意事项见 [`doc/todo.md`](doc/todo.md)。 + +## 迁移名单（截至 2026-05-04） + +- `portfolio`（host systemd `portfolio.service`，uvicorn `:8890`，**不在 k3s 里**） +- `repo-vis` +- `simpleasm` +- `guitar` +- `pyroblem`（详情待补） + +## 迁移注意事项 + +- **域名**：oci 上 ingress 都挂在 `*.oci.euphon.net` 等域名下。迁过来后切到 `*.famzheng.me`（cube 所在节点的主域），DNS 已是 wildcard A 记录，无需新加。 +- **portfolio 特殊**：host systemd 跑的，不在 k3s 里。迁移时要么沿用 systemd（直接放本机 `/home/fam` 下跑），要么打 docker image 进 k3s。 + +## 相关 + +- 宿主节点：`famzheng.me` / hostname `famzheng.com` —— 详见 `~/.claude/memory/infra.md` +- 迁移源：`oci.euphon.net`（ARM Ubuntu 22.04 + k3s） diff --git a/doc/todo.md b/doc/todo.md new file mode 100644 index 0000000..70014a6 --- /dev/null +++ b/doc/todo.md @@ -0,0 +1,24 @@ +# cube 迁移清单 + +把 oci 节点（`oci.euphon.net`，ARM Ubuntu 22.04 + k3s + traefik ingress）上 Fam 自己的小 web app 迁到 cube（跑在 `famzheng.me` 节点上）。整理时间 2026-05-04。 + +> oci 主机本身不退役 —— 留给 Hera 同学继续用。所以这里只列**要从 oci 迁出**的应用，留在 oci 的其他服务一律不提。 + +--- + +## 一、会迁 + +| 应用 | 当前域名 | 用途 | 备注 | +|---|---|---|---| +| `portfolio` | portfolio.oci.euphon.net | 投资组合追踪 | **不在 k3s 里**——host systemd `portfolio.service`，uvicorn `:8890`，python3 直跑 | +| `repo-vis` | repo-vis.oci.euphon.net | git 仓库可视化 | k3s ns `repo-vis` | +| `simpleasm` | asm.oci.euphon.net | 汇编教学/玩具 | k3s ns `simpleasm` | +| `guitar` | player.oci.euphon.net | 吉他 player（chord / tabs?） | 2 容器 sidecar | +| `pyroblem` | ? | ? | Fam 2026-05-04 补加，详情待补 | + +--- + +## 二、迁移注意事项 + +- **域名**：oci 上 ingress 都挂在 `*.oci.euphon.net` 等域名下。迁到 cube 后切到 `*.famzheng.me`（节点主域），DNS 已是 wildcard A 记录，无需新加。是否保留旧域名做 redirect 另议。 +- **portfolio 特殊**：host systemd 跑的，不在 k3s 里。迁过来要么沿用 systemd（直接放本机 `/home/fam` 下跑）、要么打 docker image 进 k3s。