开始使用

持续集成

查看、启用、更新或移除可选的持续集成工作流。

约 6 分钟3 天前更新在 GitHub 编辑

持续集成是可选能力。one createone add 都不会生成工作流文件。当前版本 支持 GitHub Actions。

用法

one ci
one ci enable [project]
one ci sync [project]
one ci disable [project]

one ci 是只读命令,会显示每个项目的当前状态和最合适的下一步命令。

命令

命令行为
one ci查看全部项目的持续集成状态
one ci enable webweb 生成标准工作流
one ci enable为全部项目启用持续集成
one ci sync web在已经启用时重新生成 web 的工作流
one ci sync更新所有已经存在的工作流
one ci disable web确认后删除 web 的生成工作流
one ci disable --yes不询问,删除全部生成工作流

拒绝停用确认或按 Ctrl-C 都属于正常取消:命令以 0 退出,文件保持不变。

文件与工作区状态

GitHub Actions 的标准文件按项目写入 .github/workflows/。持续集成选择不会写入 one.manifest.json,生成文件本身就是状态。因此 enablesyncdisable 都 不会修改 manifest。

自动化

one ci -o json
one ci enable web --provider ci/github-actions -o json
one ci sync --project web -o json
one ci disable web --yes -o json

稳定 schema 是 one-cli/ci-status/v1one-cli/ci-enable/v1one-cli/ci-sync/v1one-cli/ci-disable/v1。Provider ID 和 JSON 字段不会翻译。 --project 为旧脚本保留,日常帮助优先展示位置参数。

错误

错误码处理
CI_NOT_ENABLED先运行 one ci enable <project>,再重试 sync
CI_PROVIDER_UNKNOWN使用 error.context.available_providers 中的 ID
CI_RENDER_FAILED检查错误 context 中的项目和工作流路径

稳定错误信封详见 错误码