ToolJet 版本控制Version Control实战指南多版本管理、环境隔离与发布回滚【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJetToolJet 的版本控制Version Control功能让每个应用都能维护多个独立版本支持迭代式开发与系统性发布更新。通过 App Version Manager 即可完成版本的创建、重命名、删除与切换配合多环境Development / Staging / Production与发布、回滚机制实现“新功能在隔离版本中实验测试通过后再发布上线”的稳定交付流程。读完本文你将掌握 ToolJet 应用版本管理的完整操作路径并理解其前后端实现原理与安全限制。版本控制解决什么问题在 ToolJet 中应用本质上是一份由页面、组件、数据查询与事件处理器组成的定义definition。版本控制围绕这份定义提供以下能力多版本并存每个版本彼此隔离可独立演进互不影响迭代开发在某个版本上实验新功能不干扰已发布版本受控发布版本在充分测试后再发布给最终用户降低线上风险快速回滚发布出现问题时可随时切回先前稳定版本详见 发布与回滚指南环境绑定版本可对应不同环境开发、预发布、生产关于多环境的概念与配置参见多环境指南。例如想实验一个新特性时可以基于当前版本创建一个新版本进行开发调试通过充分测试后再将该版本发布上线。整个过程中已发布的版本始终可用最大程度减少停机时间。版本在前后端的数据模型从源码结构看版本由服务端的app_versions表承载核心实体AppVersion记录name、definition、status、currentEnvironmentId、parentVersionId、versionType、branchId等字段。前端通过 App Builder 中的版本管理器与之交互关键的几个实现文件如下前端版本管理器 UIAppVersionsManager.jsx 与 VersionManagerDropdown.jsx创建版本弹窗CreateVersionModal.jsx重命名版本弹窗EditVersionModal.jsx服务端版本操作创建 / 删除 / 守卫校验server/src/modules/versions/util.service.ts服务端发布动作写入currentVersionIdserver/src/modules/apps/service.ts。创建版本Creating a Version版本创建入口位于编辑器顶部的App Version Manager应用版本管理器。它显示应用当前版本并支持在不同版本之间切换。操作步骤如下从工具栏进入App Version Manager并点击下拉框会列出应用的全部可用版本。已发布released的版本名以绿色显示。点击下拉列表底部的Create new version按钮弹出创建版本弹窗。输入Version Name版本名称。在Create version from从哪个版本创建下拉框中选择新版本的基底版本若不做选择ToolJet 会自动使用最后创建的版本。点击Create new version按钮完成创建。创建弹窗的交互界面如下图所示版本名称的校验规则从 CreateVersionModal.jsx 的createVersion实现可以看到创建时会执行多层校验版本名称不能为空版本名称长度不能超过 25 个字符版本名称不能包含空格或特殊字符被禁用的字符集为 ~ ^ : ? * [ \ {版本描述description长度不能超过 500 个字符版本名称必须唯一若服务端返回唯一约束冲突错误码23505界面会提示“Version name already exists”。此外对于开启了 Git Sync 的工作区前端会先调用gitSyncService.checkTagExists检查同名 Git tag 是否已存在避免与远端仓库的 tag 冲突保存动作本身由服务端一次性完成数据库写入 Git tag 创建。版本一旦保存即被锁定创建弹窗底部有一行明确的提示“Saving the version will lock it. To make any edits afterwards, youll need to create a draft version.”也就是说版本保存后即成为不可编辑的已发布快照后续修改需要基于它创建 draft草稿版本。在开启 Git Sync 的工作区版本名称与描述在保存后同样不可再修改。切换版本在下拉列表中选择某个版本即可切换编辑器上下文。在 AppVersionsManager.jsx 的selectVersion中切换当前版本后会调用changeEditorVersionAction(appId, id, ...)加载该版本的完整定义在 Viewer预览 / 分享模式下会同步更新 URL 中的version查询参数使用户可以直达指定版本若选择的就是当前正在编辑的版本会提示“You are already editing this version”。版本列表采用懒加载下拉菜单打开时才调用lazyLoadAppVersions(appId)拉取全部版本避免应用加载时阻塞。重命名版本Renaming a Version如需修改某个版本的名称操作路径为打开顶部的App Version Manager在版本下拉列表中找到目标版本点击版本名称旁的重命名图标铅笔样式在弹出的弹窗中修改版本名称保存即可。重命名弹窗界面如下从 EditVersionModal.jsx 的实现看重命名同样受25 个字符上限与唯一性约束Version name must be unique and max 25 characters。另外需要注意重命名属于对版本的编辑操作仅在Development开发环境中允许——参考多环境权限表Staging 与 Production 环境中不可重命名版本。删除版本Deleting a Version删除版本同样在App Version Manager中操作打开版本下拉列表定位到目标版本点击版本右侧的删除图标在确认弹窗中确认删除。关键限制已发布released的版本不可删除。删除确认弹窗如下图所示服务端的删除守卫前端 UI 对已发布版本隐藏删除图标但这只是第一层防护。服务端 util.service.ts 的deleteVersion方法实现了一整套删除守卫从源码看包括已发布版本不可删若app.currentVersionId versionId或版本状态为RELEASED抛出You cannot delete a released version唯一版本不可删若该应用 / 模块只剩这一个版本抛出Cannot delete only version of ...Git 功能分支版本不可删开启 Git Sync 后feature branch 上的版本不能从此入口删除最后一个草稿不可删Git Sync 开启时若删除的是唯一的草稿版本会抛出Cannot delete the last draft version ... while git sync is enabled被引用的模块版本不可删若删除的是模块module版本且该版本正被一个或多个应用中的ModuleViewer组件使用会通过checkModuleVersionInUse检测并抛出Cannot delete this version. Used by: 应用列表前端随后弹出“Dependent apps found!”提示。删除版本时还会同步清理该版本关联的查询文件夹数据cleanupQueryFolderData并走事务dbTransactionWrap保证一致性。版本与环境的协作发布与回滚版本控制并非孤立功能它与 ToolJet 的多环境模型深度绑定。默认每个应用都有Development开发、Staging预发布、Production生产三个环境各环境对版本的操作权限不同操作DevelopmentStagingProduction编辑版本✅❌❌重命名版本✅❌❌删除版本✅❌❌创建新版本✅❌❌提升Promote✅✅-典型生命周期为开发者在Development中构建并保存版本 → 将版本Promote到Staging供测试团队验证Staging 中应用与查询不可编辑→ 测试通过后 Promote 到Production→ 点击Release按钮正式发布给最终用户。发布Release背后的实现发布动作将选中的版本设置为应用的当前版本。从 server/src/modules/apps/service.ts 的发布逻辑看服务端会校验目标版本的 slug 是否与其他已发布应用冲突Cannot release — slug conflicts with another released app.校验通过后执行manager.update(App, appId, { currentVersionId: versionToBeReleased })将应用的current_version_id指向被发布版本同时写入APP_RELEASE审计日志记录 released version、环境名称等元数据。发布后该版本便成为终端用户访问到的版本关于应用的多种分享方式见分享应用指南同时该版本在下拉列表中显示为绿色、且不可被删除。回滚Rollback当发布后出现问题例如 v1.2.0 的表单组件异常可以利用版本控制快速回滚打开App Version Manager下拉列表选择之前稳定的版本如 v1.1.0点击右上角的Release按钮在确认弹窗中点击Release完成回滚。回滚的实质是“重新发布旧版本”——应用 URL 保持不变旧版本立即恢复对用户可用团队可以在不影响线上用户的前提下离线排查故障版本。完整流程见发布与回滚指南。小结与最佳实践将版本视为不可变快照保存即锁定后续改动一律通过新建版本或 draft 进行保证可追溯遵循命名规范版本名建议使用语义化命名如 v1.1.0避免空格与特殊字符长度控制在 25 字符内善用环境流转Development 中自由迭代Staging 中充分测试Production 中只做发布与回滚降低线上风险保留稳定版本始终保留一个已知稳定的版本作为回滚锚点因为发布后版本不可删除注意 Git Sync 联动开启 Git Sync 后版本与 Git tag 一一对应删除版本会连带删除远端 tag操作前务必确认。版本控制是 ToolJet 应用交付链路版本 → 环境 → 发布 → 回滚的基石理解其 UI 操作、权限边界与底层守卫逻辑能帮助团队建立安全、高效的内部工具发布流程。【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ToolJet 版本控制（Version Control）实战指南：多版本管理、环境隔离与发布回滚
ToolJet 版本控制Version Control实战指南多版本管理、环境隔离与发布回滚【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJetToolJet 的版本控制Version Control功能让每个应用都能维护多个独立版本支持迭代式开发与系统性发布更新。通过 App Version Manager 即可完成版本的创建、重命名、删除与切换配合多环境Development / Staging / Production与发布、回滚机制实现“新功能在隔离版本中实验测试通过后再发布上线”的稳定交付流程。读完本文你将掌握 ToolJet 应用版本管理的完整操作路径并理解其前后端实现原理与安全限制。版本控制解决什么问题在 ToolJet 中应用本质上是一份由页面、组件、数据查询与事件处理器组成的定义definition。版本控制围绕这份定义提供以下能力多版本并存每个版本彼此隔离可独立演进互不影响迭代开发在某个版本上实验新功能不干扰已发布版本受控发布版本在充分测试后再发布给最终用户降低线上风险快速回滚发布出现问题时可随时切回先前稳定版本详见 发布与回滚指南环境绑定版本可对应不同环境开发、预发布、生产关于多环境的概念与配置参见多环境指南。例如想实验一个新特性时可以基于当前版本创建一个新版本进行开发调试通过充分测试后再将该版本发布上线。整个过程中已发布的版本始终可用最大程度减少停机时间。版本在前后端的数据模型从源码结构看版本由服务端的app_versions表承载核心实体AppVersion记录name、definition、status、currentEnvironmentId、parentVersionId、versionType、branchId等字段。前端通过 App Builder 中的版本管理器与之交互关键的几个实现文件如下前端版本管理器 UIAppVersionsManager.jsx 与 VersionManagerDropdown.jsx创建版本弹窗CreateVersionModal.jsx重命名版本弹窗EditVersionModal.jsx服务端版本操作创建 / 删除 / 守卫校验server/src/modules/versions/util.service.ts服务端发布动作写入currentVersionIdserver/src/modules/apps/service.ts。创建版本Creating a Version版本创建入口位于编辑器顶部的App Version Manager应用版本管理器。它显示应用当前版本并支持在不同版本之间切换。操作步骤如下从工具栏进入App Version Manager并点击下拉框会列出应用的全部可用版本。已发布released的版本名以绿色显示。点击下拉列表底部的Create new version按钮弹出创建版本弹窗。输入Version Name版本名称。在Create version from从哪个版本创建下拉框中选择新版本的基底版本若不做选择ToolJet 会自动使用最后创建的版本。点击Create new version按钮完成创建。创建弹窗的交互界面如下图所示版本名称的校验规则从 CreateVersionModal.jsx 的createVersion实现可以看到创建时会执行多层校验版本名称不能为空版本名称长度不能超过 25 个字符版本名称不能包含空格或特殊字符被禁用的字符集为 ~ ^ : ? * [ \ {版本描述description长度不能超过 500 个字符版本名称必须唯一若服务端返回唯一约束冲突错误码23505界面会提示“Version name already exists”。此外对于开启了 Git Sync 的工作区前端会先调用gitSyncService.checkTagExists检查同名 Git tag 是否已存在避免与远端仓库的 tag 冲突保存动作本身由服务端一次性完成数据库写入 Git tag 创建。版本一旦保存即被锁定创建弹窗底部有一行明确的提示“Saving the version will lock it. To make any edits afterwards, youll need to create a draft version.”也就是说版本保存后即成为不可编辑的已发布快照后续修改需要基于它创建 draft草稿版本。在开启 Git Sync 的工作区版本名称与描述在保存后同样不可再修改。切换版本在下拉列表中选择某个版本即可切换编辑器上下文。在 AppVersionsManager.jsx 的selectVersion中切换当前版本后会调用changeEditorVersionAction(appId, id, ...)加载该版本的完整定义在 Viewer预览 / 分享模式下会同步更新 URL 中的version查询参数使用户可以直达指定版本若选择的就是当前正在编辑的版本会提示“You are already editing this version”。版本列表采用懒加载下拉菜单打开时才调用lazyLoadAppVersions(appId)拉取全部版本避免应用加载时阻塞。重命名版本Renaming a Version如需修改某个版本的名称操作路径为打开顶部的App Version Manager在版本下拉列表中找到目标版本点击版本名称旁的重命名图标铅笔样式在弹出的弹窗中修改版本名称保存即可。重命名弹窗界面如下从 EditVersionModal.jsx 的实现看重命名同样受25 个字符上限与唯一性约束Version name must be unique and max 25 characters。另外需要注意重命名属于对版本的编辑操作仅在Development开发环境中允许——参考多环境权限表Staging 与 Production 环境中不可重命名版本。删除版本Deleting a Version删除版本同样在App Version Manager中操作打开版本下拉列表定位到目标版本点击版本右侧的删除图标在确认弹窗中确认删除。关键限制已发布released的版本不可删除。删除确认弹窗如下图所示服务端的删除守卫前端 UI 对已发布版本隐藏删除图标但这只是第一层防护。服务端 util.service.ts 的deleteVersion方法实现了一整套删除守卫从源码看包括已发布版本不可删若app.currentVersionId versionId或版本状态为RELEASED抛出You cannot delete a released version唯一版本不可删若该应用 / 模块只剩这一个版本抛出Cannot delete only version of ...Git 功能分支版本不可删开启 Git Sync 后feature branch 上的版本不能从此入口删除最后一个草稿不可删Git Sync 开启时若删除的是唯一的草稿版本会抛出Cannot delete the last draft version ... while git sync is enabled被引用的模块版本不可删若删除的是模块module版本且该版本正被一个或多个应用中的ModuleViewer组件使用会通过checkModuleVersionInUse检测并抛出Cannot delete this version. Used by: 应用列表前端随后弹出“Dependent apps found!”提示。删除版本时还会同步清理该版本关联的查询文件夹数据cleanupQueryFolderData并走事务dbTransactionWrap保证一致性。版本与环境的协作发布与回滚版本控制并非孤立功能它与 ToolJet 的多环境模型深度绑定。默认每个应用都有Development开发、Staging预发布、Production生产三个环境各环境对版本的操作权限不同操作DevelopmentStagingProduction编辑版本✅❌❌重命名版本✅❌❌删除版本✅❌❌创建新版本✅❌❌提升Promote✅✅-典型生命周期为开发者在Development中构建并保存版本 → 将版本Promote到Staging供测试团队验证Staging 中应用与查询不可编辑→ 测试通过后 Promote 到Production→ 点击Release按钮正式发布给最终用户。发布Release背后的实现发布动作将选中的版本设置为应用的当前版本。从 server/src/modules/apps/service.ts 的发布逻辑看服务端会校验目标版本的 slug 是否与其他已发布应用冲突Cannot release — slug conflicts with another released app.校验通过后执行manager.update(App, appId, { currentVersionId: versionToBeReleased })将应用的current_version_id指向被发布版本同时写入APP_RELEASE审计日志记录 released version、环境名称等元数据。发布后该版本便成为终端用户访问到的版本关于应用的多种分享方式见分享应用指南同时该版本在下拉列表中显示为绿色、且不可被删除。回滚Rollback当发布后出现问题例如 v1.2.0 的表单组件异常可以利用版本控制快速回滚打开App Version Manager下拉列表选择之前稳定的版本如 v1.1.0点击右上角的Release按钮在确认弹窗中点击Release完成回滚。回滚的实质是“重新发布旧版本”——应用 URL 保持不变旧版本立即恢复对用户可用团队可以在不影响线上用户的前提下离线排查故障版本。完整流程见发布与回滚指南。小结与最佳实践将版本视为不可变快照保存即锁定后续改动一律通过新建版本或 draft 进行保证可追溯遵循命名规范版本名建议使用语义化命名如 v1.1.0避免空格与特殊字符长度控制在 25 字符内善用环境流转Development 中自由迭代Staging 中充分测试Production 中只做发布与回滚降低线上风险保留稳定版本始终保留一个已知稳定的版本作为回滚锚点因为发布后版本不可删除注意 Git Sync 联动开启 Git Sync 后版本与 Git tag 一一对应删除版本会连带删除远端 tag操作前务必确认。版本控制是 ToolJet 应用交付链路版本 → 环境 → 发布 → 回滚的基石理解其 UI 操作、权限边界与底层守卫逻辑能帮助团队建立安全、高效的内部工具发布流程。【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考