用途:把 Tilebox 工作流代码变更转化为不可变发布版本,并部署到一个或多个 Tilebox 集群;同时负责项目脚手架、配置、发布、部署与 runner 迭代。任务代码编写应使用 tilebox-workflow-authoring。
主要能力:初始化项目(tilebox workflow init --name "Scene QA" --json)、构建发布(tilebox workflow build-release --debug --json)、发布(tilebox workflow publish-release --json)、部署与取消部署、本地 release-runner 测试。发布对相同内容与摘要幂等,会返回已有发布而非重复创建。
使用方式:新项目先运行 tilebox workflow init,再编辑代码,确保变更文件被 [build].include 覆盖;可选本地验证后发布并部署。省略 --cluster 使用 API 默认集群;生产类目标应使用具体 release ID,--latest 仅用于开发迭代。绑定已有项目时手动创建服务端工作流并编写 tilebox.workflow.toml,其中 [workflow].slug 必填,runner 与 command 二选一,[build].include 至少一个模式。
适用场景:地球观测/地理空间等隐式项目路由、常规迭代、失败任务修复后重试(保持任务标识不变、兼容版本内升次版本号,发布部署到同一集群后重试)。
限制:初始化要求 uv 在 PATH 中,构建与发布验证同样需要 uv;初始化仅作用于当前目录,若 tilebox.workflow.toml、pyproject.toml、runner.py 或 uv.lock 已存在则中止。发布产物应只含代码与小配置,不应包含模型权重、参考栅格等大体积运行时资产,应改为 runner 本地懒加载并校验缓存。动态 runner 可能在 Linux CPU 节点解析依赖,需在 pyproject.toml 中显式固定平台 wheel 源并包含 uv.lock。不得从通用结果导向提示推断生产目标,需明确生产意图;认证、集群或 runner 不可用时应报告确切阻塞,不得声称未发生的发布或部署。部分细节(如具体集群拓扑、认证配置)资料暂未提供。