使用手册
任务导向的运维文档:我现在要做一件具体的事,该敲什么命令。与 GitHub 仓库 docs/design/ 里面向开发者的架构设计文档不同,这里回答的是"怎么运行它",不是"系统为什么长这样"。
- 备份与恢复 — 备份哪些东西、
mechctl backup create、恢复步骤 - 证书 — 自签 CA、mTLS 节点证书、轮换、吊销、CA 丢失的灾难恢复
- 升级 — 控制面(mechd/mechlet 自身)升级步骤,区别于组件升级
- 故障排查 —
/healthzvs/readyz、日志、--local诊断、常见故障信号
这里没有的
这四份文档只覆盖备份恢复/证书/升级/故障排查——更完整的内容分布在别处:
- 快速上手:GitHub README
- CLI 命令参考:
docs/design/11-cli.md - Web UI 说明:
docs/design/24-web-ui.md - 安全模型与信任边界:
docs/design/08-security.md、SECURITY.md - 版本号与发布政策:
CONTRIBUTING.md
权威版本在核心仓
这四份文档的权威版本在核心仓的 docs/ops/——离线优先是 Mecharion 的核心原则,运维方在完全没有网络的现场也应当能从本地的 git 仓库或发布制品里读到它们,不依赖能不能访问这个网站。这里的版本会随核心仓更新同步,但如果两边一时不一致,以核心仓为准。