 anonsaber
|
978288f8d7
|
build+docs: 用 HostStack agent 源码实证校正部署事实，砍掉 dig 的 42.7MB 膨胀
从本机缓存的 registry.hoststack.dev/hoststack/agent 镜像里直接读出运行时
配置，纠正了此前靠猜的四条部署事实：
hoststack.yaml
- 撤回上一版把 install: 合并进 build.command 的"修正"——schema 里
install.command 本来就是合法键（agent 的 schema 与 yaml-parser.ts 均定义），
install/build/start 是三条独立命令
- 补上为什么这个文件不能删：runtime: rust 的框架默认 start 命令是
./target/release/app，与 Cargo 包名无关。删掉 YAML 后 Start Command
回落到 app，进程在绑定端口前就以 not found 退出
- 记录实测优先级：YAML 值生效，省略才回落框架默认值（Cargo.toml 只声明
[[bin]] message-weave，仓库里既无 app 目标也无 app.rs）
Dockerfile
- 移除 bind9-dnsutils：连带 libicudata.so.72（29.8MB）等多级依赖，实测
边际成本 42.7MB，是其余 7 个工具总和（19.7MB）的两倍多
- DNS 解析用基础镜像自带的 getent 已覆盖（getent hosts / ahostsv4 / ahostsv6）
- 注释写明 19.7MB 的实测口径
docs/deployment.md
- §5.1 重写：build 在 rust:slim-trixie、runner 是 debian:trixie-slim，
本仓库 Dockerfile 完全不被执行
- 修正"没有 install: 键"与"validate 拦未知键"两处错误说法：agent 部署路径
不应用 zod 校验，未知键被静默丢弃而非报错，validate 才是唯一防线
- §4.1 容器安全档改成源码实测值：readonlyRootfs/dropCapabilities/
noNewPrivileges 全为 true，pidsLimit 256，tmpfs 选项 rw,nosuid,nodev,
size=64m——原先写的 noexec 并不存在；并标注 dev 档 rootfs 可写
- §8.1 明确两条部署路径的镜像差异（bookworm vs trixie）
- §6 HEALTHCHECK 与二进制"内置 health 子命令"的过期说法
- 删除文档中指向不存在文件 app.rs 的引用
验证：GATE-DOCS PASS 6/6（PATH AUDIT 369 path-refs / 0）；
runtime 阶段实测构建成功且 curl/ps/pgrep/ss/ip/jq/nc/getent 齐备、
dig 按预期缺席、getent hosts 可解析、uid 999；
8 个工具 dpkg Installed-Size 合计 7935kB 而全量 du 差 62.3MB，
剔除 dig 后 19.7MB——这个差额就是本次砍掉的膨胀。
|
2026-09-29 12:15:52 +08:00 |
|
anonsaber
|
417f378d68
|
build+docs: 镜像内置只读诊断工具，清理 Dockerfile 的死 ENV 与文档过期表述
生产镜像此前只有 ca-certificates + tini，容器 rootfs 又只读，运维在容器内既
装不了 apt 也没有 curl/ps，排查只能靠宿主机的 /proc。把只读诊断工具装进
runtime 阶段，实测体积 +7.7 MB：
curl procps(ps/pgrep/free) iproute2(ss/ip) jq bind9-dnsutils(dig) netcat-openbsd(nc)
全部是只读查询能力，不引入包管理之外的写能力，也不新增 shell 解释器。
顺手修掉四处已被事实推翻的表述：
1. Dockerfile 的 ENV RUN_MODE=webhook 是死变量——该标识符随 Config::from_env()
删除后代码零读取，文档 5 处都记着已删除，镜像却还在设。删掉并留注释防回退。
2. deployment.md 说「runtime 只装了 ca-certificates tini」「镜像内没有 curl/wget」，
两处都是健康检查建议的承重理由，随内置 curl 一起更新为「技术上可行但不建议」。
3. deployment.md 说非 root 用户是 uid 1000，实际 useradd --system 给 uid 999，
已实测修正。
4. retired.md 里 compose healthcheck 示例的删除理由把「镜像无 curl」当主因，
真正的承重原因是 src/main.rs 没有 CLI 子命令解析，已改写并标注 curl 已内置。
同时补齐 hoststack.yaml 缺失的 install 段（cargo fetch --locked），并在 start 段
写清临时开 --debug 的确切改法与「必须在容器内探、别走公网域名」的约束。
验证：
- 包名与安装步骤在同一 debian:bookworm-slim 基础镜像内实测通过
- useradd 实测输出 uid=999，与设计一致
- docker build --check 无告警
- GATE-DOCS PASS 6/6（SECTION-REF 217 / 0，PATH AUDIT 364 / 0）
注：install: { command: ... } 的键名是按现有 build:/start: 的同构推断的，
若 HostStack 拒绝该键，删掉这两行即可，不影响 build/start。
|
2026-09-29 11:24:13 +08:00 |
|
anonsaber
|
4f5eb9293d
|
chore(worker): rename proxy to lb and ignore build cache
- cloudflare-worker: unify terminology proxy -> lb/forward
(PROXIED_ROUTES -> LB_ROUTES, proxyWithFailover -> forwardWithFailover,
proxy.js -> lb.js, related tests and README); renames/wording only, no behavior change
- Dockerfile: crates.io index mirror rsproxy.cn -> mirrors.ustc.edu.cn
- .gitignore: ignore build verification cache .gate-cache/ (cargo registry + rustup, ~1.5G)
|
2026-09-27 12:52:55 +08:00 |
|
anonsaber
|
c75858fda0
|
refactor: rename project to MessageWeave
|
2026-09-25 10:29:18 +08:00 |
|
anonsaber
|
fc43c6bf93
|
build: use rsproxy for container dependencies
|
2026-09-25 09:21:43 +08:00 |
|
anonsaber
|
dceecaf2f4
|
feat: initial MessageWeave release
|
2026-09-25 09:14:04 +08:00 |