跳到主要内容

构建管线

构建管线

一次构建把工作区源码变成一个不可变 bundle。本页介绍这条管线:同步、编译、校验与产出。

bolt sync

bolt sync 是编译器的前半段:角色发现、结构校验、生成的 $types 与注册表,以及一份生成的 TypeScript 配置。任何放错或命名错误的东西都在这里失败,在 Vite 运行之前。

管线一览

一棵源码树进,一个不可变 bundle 出:

  1. bolt sync——发现、校验、生成类型、客户端构建
  2. vite build——Svelte 与 Tailwind 编译进浏览器客户端
  3. 迁移——读取并嵌入已提交的谱系,记录 schema 指纹
  4. 产出——可移植服务端产物与客户端位于 .norbital/

Vite 插件

Bolt 以插件形式接入 Vite:Svelte、Tailwind 与客户端构建都流经它,编译器诊断附着在构建上。该插件也构建产物所依赖的服务端 bundle。

DDL 校验

集合模型通过 schema plan 编译为 DDL。产物携带迁移谱系与 schema 指纹;宿主针对租户数据库校验并应用该 DDL(schema.validate、schema.verify、schema.migrate),浏览器副本从同样的步骤置备(sync.provisioning)。

产物

管线把完整 bundle 输出到 .norbital/artifact/ ——编译后的服务器运行时、租户应用、资源、迁移与宿主加载器。编译后的浏览器客户端位于 .norbital/dist/。

心智模型见 Bolt 框架 ;Colony 如何运行这条管线见 Colony 平台