ocd CLI

ocd --help 和各级 subcommand 的 --help 是参数 authority。本页只按任务分组并说明共同语义。

安装与运行

• setup、run
• start、stop、restart、status、logs、dashboard
• instances、instance unregister、purge

使用全局 --config <path> 或 --instance <id> 选择本机 instance。多数 online 命令可以自动选择唯一运行实例；没有或存在多个候选实例时会 fail closed。

需要发现配置的命令使用唯一固定优先级：显式 --config、./compute.toml、当前平台默认 user config、/etc/open-compute/config.toml。高优先级文件存在但无效时直接报告，不会跳过后 fallback。

开发与部署

• target add|list|show|test|remove
• wrangler [--target <name>] [--project <dir>] <wrangler-command> ...
• worker bundle

ocd wrangler 解析项目内 Wrangler，并原样传递 Wrangler command 之后的参数。它不会下载、修复或静默替换依赖。Wrangler major 不同会警告，但不阻止执行。

检查与诊断

• config init|check
• doctor、capabilities、support-bundle
• docs、licenses

只读命令在 help 明确说明时支持 --json。JSON 有版本合同；面向人的输出不应被脚本解析。

维护与恢复

• backup create|list|inspect|delete|retention-plan|restore
• backup cleanup-incomplete|cleanup-restore|attest-restore-smoke
• scheduler recover-corrupt
• upgrade、uninstall [--purge --yes]、purge --instance <id>|--config <path>

Backup 和 scheduler recovery 必须满足 help 与运维指南中的 offline 或 exclusive 条件。不要直接编辑 SQLite 文件或 migration table。

instance unregister 只删除 managed service definition 与 registry record。uninstall 默认保留 instance 数据，只有显式 --purge 才会删除。purge 要求一个精确 selector，先打印计划，支持 --dry-run，且 stdin 非交互时必须传 --yes。

ocd wrangler 成功后会替换 launcher process，因此最终 stdout、stderr、信号和退出码由 Wrangler 拥有。