Skip to content

依赖构建 ​

模型 ​

项目分两类: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 --json

JSON 定义同样接受 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 日志与打包依赖版本。

失败排查顺序 ​

  1. deploy runs list --project <失败依赖key> 找到子运行。
  2. deploy logs <runId> 看真实报错(编译/签名/仓库权限)。
  3. 修脚本或凭据后重新 run --with-dependencies;不要只重跑目标。

延伸阅读 ​