主题
依赖构建
模型
项目分两类:kind: app(可部署应用)与 kind: lib(构建安装型库,如 Maven install 到本地仓库的基础库)。 dependencies 声明前置项目 key;触发时加 --with-dependencies(API/Hook 为 withDependencies: true)才会先建依赖。
bash
deploy project create --file java-model.json --kind lib
deploy project create --file tio-boot-admin.json --kind lib --dependencies java-model
deploy project update my-app --dependencies tio-boot-admin
deploy run my-app --with-dependencies --wait --jsonJSON 定义同样接受 kind 与 dependencies。创建顺序:先前置后依赖方;创建后用 project get 读回依赖图核对。
执行语义
- 拓扑排序:服务端按依赖图排序并检测环(环 → 触发报错)。
- 去重:同一项目在一次管道中只构建一次(菱形依赖安全)。
- 串行:依赖先于目标执行;每个子运行有独立 runId、buildNumber 与日志。
- 每次触发都重建全部依赖:不做「源码没变就跳过」的缓存判断。
- 失败阻断:任一依赖失败 → 目标不执行;排查时看失败子运行的日志,而不是只看父运行摘要。
- 取消级联:取消管道中任一运行,会同时取消该管道中正在执行或排队的其他运行。
- 分支传递:触发指定的
--branch传递给依赖;临时变量覆盖只作用于目标项目。
不加 --with-dependencies 时只运行目标本身——依赖已安装过、只想重发应用时用这种。
库项目的脚本要点
lib 项目的命令通常是「构建 + 安装到共享仓库」,例如 Maven:
bash
set -e
mvn -Dgpg.skip clean install注意事项:
- 同一 Maven 本地仓库/用户:前置与应用构建必须用同一个
~/.m2(或服务端指定 settings),否则 install 了也找不到。 - JDK 分别匹配:每个库要求的 JDK 可能与应用不同(如库需 JDK 8、应用需 JDK 21/25),在各自脚本里显式切换,不要依赖全局默认。
- GPG skip:未配置签名密钥的库构建加
-Dgpg.skip,避免签名失败。 - 验证产物含当前源码:对着已发布 artifact 构建成功不代表包含你的新改动;核对源码提交、install 日志与打包依赖版本。
失败排查顺序
deploy runs list --project <失败依赖key>找到子运行。deploy logs <runId>看真实报错(编译/签名/仓库权限)。- 修脚本或凭据后重新
run --with-dependencies;不要只重跑目标。
延伸阅读
- 项目定义:
kind/dependencies字段。 - 运行历史与取消:管道内多运行的查看与级联取消。
- mosskb-web 案例:含依赖构建的多模块应用实录。