ToolJet GitSync 配置管理指南启用、禁用与删除 Git 同步配置【免费下载链接】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本文聚焦 ToolJet 中 GitSyncGit 同步功能的生命周期管理如何在Workspace settings → Configure git中启用或禁用 GitSync以及如何彻底删除 GitSync 配置。读完本文你将掌握三种状态启用 / 禁用 / 删除下不同角色用户的行为差异并理解删除配置 ≠ 删除远端仓库应用这一关键边界以及底层源码对配置状态的判定逻辑。GitSync 的三种状态在 ToolJet 中GitSync 可以按需启用Enabled、禁用Disabled或删除配置Deleted三种状态的行为差异如下状态用户角色行为表现Enabled启用所有用户用户可以正常将应用变更提交commit到 Git 仓库Disabled禁用非管理员用户无法提交变更会看到GitSync 功能尚未配置请联系管理员配置的提示对话框Disabled禁用管理员用户无法提交变更会看到包含配置 GitSync 功能入口链接的提示对话框Deleted删除配置所有用户GitSync 功能随之被禁用但不会删除 Git 仓库中的应用仓库中的应用仍保持删除配置前的状态其中最关键的一点是删除 GitSync 配置并不会删除远端 Git 仓库中的应用。应用在仓库中依旧存在且停留在删除配置之前的最后一次同步状态因此这是一个可逆的、非破坏性的操作——只是解除了 ToolJet 工作区与远端仓库之间的绑定关系。启用 / 禁用 GitSyncConnect 开关如果 GitSync 已配置完成可以通过Connect开关快速启用或禁用该功能进入Workspace settings工作区设置页面切换到Configure git标签页点击Connect开关将其打开启用或关闭禁用。界面上方为Connect开关下方提示Disabling will stop syncing data within apps禁用后将停止应用内的数据同步。下方还包含 Git repo URL、Generate SSH key、SSH key 等配置项以及 Auto-commit on promoting environment环境提升时自动提交选项页面底部则是Delete configuration按钮。该开关仅对已配置GitSync 的工作区可用This is only available if the GitSync feature is configured。从源码角度看前端通过 useGitSyncConfig.js 判定同步是否已配置const isGitSyncConfigured orgGit?.git_https?.is_enabled || orgGit?.git_lab?.is_enabled || !!(orgGitConfig?.is_git_sync_configured ?? orgGitConfig?.isGitSyncConfigured); const isGitSyncEnabled isGitSyncConfigured || !!(orgGitConfig?.isEnabled ?? orgGitConfig?.is_enabled);可以看到只要 HTTPS 或 GitLab 任一提供商处于启用is_enabled状态或者数据库中的is_git_sync_configured标志为真即视为 GitSync 已配置而启用则进一步考虑了isEnabled/is_enabled标志。该 hook 还衍生出三个关键判定isGitSyncLicensed基于许可证授权与有效期判定许可证过期或无效时视为未授权isGitSyncLicenseLocked当 Git 已配置但许可证不再覆盖该功能时整个编辑器将被冻结直到用户在 Workspace settings → Configure git 中关闭 GitdefaultBranch默认分支取自orgGit?.git_https?.github_branch缺省为main。此外Configure Git入口只对管理员开放这一点可以在 OrganizationSettingsPage/constant.js 的菜单定义中得到印证{ id: configure-git, name: Configure Git, route: configure-git, conditions: [admin] },删除 GitSync 配置如果需要彻底解除 ToolJet 与远端 Git 仓库的绑定关系可执行以下步骤进入Workspace settings工作区设置页面切换到Configure git标签页点击Delete configuration删除配置按钮。点击删除后ToolJet 会删除其保存的 SSH key 配置GitSync 功能随即被禁用。此后用户将无法再把应用变更提交commit到 Git 仓库。删除后的影响边界务必明确以下事实以便安全地执行删除操作SSH key 被移除ToolJet 本地保存的用于连接远端仓库的 SSH key 会被删除ToolJet 不再具备向该仓库认证与写入的能力远端仓库与应用不受影响Git 仓库中的应用不会因为删除配置而丢失它们仍以删除配置前的状态存在于仓库中GitSync 功能回退到未配置状态删除后非管理员用户再次尝试提交时将看到GitSync 未配置的提示需要联系管理员重新走一遍配置流程。从服务端实现来看GitSync 的配置保存、删除等数据库操作集中在git-sync-configs模块见 server/src/modules/git-sync-configs其中 controller.ts 提供配置读写接口并通过 ability/guard.ts 做权限校验而 CE 版本的 git-sync/controller.ts 仅保留了策略桩strategy-only stubsDB 相关端点已迁移至git-sync-configs模块。仓库实体层面工作区与仓库的绑定关系记录在 organization_git_sync.entity.ts 中——删除配置即解除该绑定而非触碰远端仓库内容。重新配置与延伸阅读删除配置之后如果需要恢复 Git 同步能力管理员只需重新走一遍配置流程在 GitHub / GitLab / Gitea 等仓库管理平台准备好仓库与 SSH URL回到Configure git标签页填入 URL、生成 SSH key、部署到仓库、最后点击Finalize setup完成。完整的配置流程含 ED25519 / RSA 两种 SSH key 类型的选择、Deploy key 的添加、以及通过GITSYNC_TARGET_BRANCH环境变量配置自定义分支详见GitSync 配置指南Git 仓库管理器 SSH 配置GitSync 概述推送变更到 Git 与 从 Git 拉取变更小结ToolJet 的 GitSync 提供了清晰的启用 → 禁用 → 删除配置三级管理能力Connect 开关用于日常启用 / 禁用Delete configuration 按钮用于彻底解除绑定。无论哪种操作远端 Git 仓库中的应用数据都不会被破坏删除配置只是移除 ToolJet 侧的 SSH key 与绑定关系仓库中的内容会安全保留。对于管理员而言掌握这一边界即可放心地对 GitSync 进行运维与回收。【免费下载链接】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），仅供参考
