ToolJet LTS 升级指南版本策略、标签规范与多部署环境升级路径【免费下载链接】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 仓库中的 LTS 升级文档upgrade-to-lts.md展开系统讲解 ToolJet 长期支持LTS版本的发布节奏、LTS 镜像标签的命名规范、升级前的必备前置条件以及 Docker、Kubernetes、Helm、OpenShift 和各云厂商环境下的升级入口。读完后你可以独立完成一次自托管 ToolJet 实例的 LTS 升级确认目标版本、完成数据库备份、按当前部署方式执行升级并理解版本门槛v2.23.0-ee2.10.2背后的迁移约束。LTS 版本策略3–5 个月一个版本至少 18 个月生命周期ToolJet 会定期发布长期支持Long Term Support版本为生产环境提供更长的支持窗口与稳定性承诺。根据文档给出的版本策略发布节奏每 3–5 个月发布一个新的 LTS 版本生命周期EOL每个 LTS 版本至少提供 18 个月的维护支持价值升级至 LTS 版本可以在获得最新特性与安全更新的同时保持环境长期受支持。从仓库的文档版本清单 docs/versions.json 可以看到当前仓库维护了两条 LTS 文档线3.0.0-LTS与2.50.0-LTS两者各自拥有完整的versioned_docs目录如 docs/versioned_docs/version-3.0.0-LTS 与 docs/versioned_docs/version-2.50.0-LTS这从文档结构上印证了 LTS 版本是 ToolJet 持续维护的独立发布线。如何确认最新的 LTS 版本与标签规范要确认最新 LTS 版本文档建议查看 Docker Hub 上tooljet/tooljet镜像的标签tags页面。LTS 标签遵循固定的命名规范以LTS-作为前缀后接版本号示例标签tooljet/tooljet:EE-LTS-latest。因此在实际升级操作前可以先在镜像仓库的标签列表中检索LTS-前缀的标签确定当前可用的最新 LTS 版本号再决定升级目标。对于全新安装则可以直接使用最新版本无需遵循本文的升级流程——该升级指南仅面向存量实例的升级场景。升级前置条件备份与版本门槛文档明确列出两条硬性前置条件各部署环境的升级章节如 Docker 部署指南、Helm 部署指南、Kubernetes 部署指南、DigitalOcean 部署指南均完整复述了这两条可见其通用性必须先做数据库的全面备份。ToolJet 依赖 PostgreSQL 存储应用定义、数据源凭据加密后与用户认证数据升级涉及数据迁移备份是防止数据丢失的最后防线版本门槛当前版本早于v2.23.0-ee2.10.2的用户必须先升级到该版本才能再升级到 LTS 版本。这一门槛意味着极老版本的实例不能“一步跳”到 LTS需要分阶段升级以避免跨度过大的数据迁移失败。关于备份手段可以结合具体部署方式选择。例如在 Docker 内置 PostgreSQL 的场景下官方部署文档docker.md提供了专用的备份/恢复脚本backup-restore.sh下载该脚本后直接执行即可完成 PostgreSQL 数据的备份与恢复操作若使用外部托管 PostgreSQL如云厂商 RDS 类服务则建议改用云厂商的数据库快照或pg_dump等常规手段。按部署环境选择升级路径升级流程因部署方式而异文档为 11 种部署形态分别提供了对应指南中的 “Upgrading to the Latest LTS Version” 章节。各部署方式与其仓库内文档入口对应如下部署方式升级文档入口仓库相对路径DigitalOceandocs/versioned_docs/version-2.50.0-LTS/setup/digitalocean.mdDockerdocs/versioned_docs/version-2.50.0-LTS/setup/docker.mdAWS EC2docs/versioned_docs/version-2.50.0-LTS/setup/ec2.mdAWS ECSdocs/versioned_docs/version-2.50.0-LTS/setup/ecs.mdOpenShiftdocs/versioned_docs/version-2.50.0-LTS/setup/openshift.mdHelmdocs/versioned_docs/version-2.50.0-LTS/setup/helm.mdKubernetesdocs/versioned_docs/version-2.50.0-LTS/setup/kubernetes.mdKubernetes (GKE)docs/versioned_docs/version-2.50.0-LTS/setup/kubernetes-gke.mdKubernetes (AKS)docs/versioned_docs/version-2.50.0-LTS/setup/kubernetes-aks.mdAzure Container Appsdocs/versioned_docs/version-2.50.0-LTS/setup/azure-container.mdGoogle Cloud Rundocs/versioned_docs/version-2.50.0-LTS/setup/google-cloud-run.md从源码结构看这些指南中的升级章节内容高度一致统一说明“新版本每 3–5 个月发布、EOL 至少 18 个月”、统一指向LTS-标签规范与tooljet/tooljet:EE-LTS-latest示例、统一重申备份与 v2.23.0-ee2.10.2 版本门槛两条前置条件。也就是说跨环境升级的核心动作只有一个——在对应部署清单中把 ToolJet 镜像/版本引用切换到新的 LTS 版本然后按各环境的编排方式compose、Helm release、K8s manifest滚动更新差异仅在于更新动作落在哪个编排工具上。Docker 环境的参考配置Docker 场景下仓库内的部署文件 deploy/docker/docker-compose-db.yaml 展示了内置 PostgreSQL 的标准组合tooljet服务SERVE_CLIENT: true对外 80 端口、postgres服务postgres:13镜像数据挂载到本地目录、postgrest服务postgrest/postgrest:v12.0.2用于 ToolJet Database 查询。升级 LTS 时将tooljet服务的镜像标签替换为目标 LTS 标签后重启栈即可PostgreSQL 数据卷与.env配置LOCKBOX_MASTER_KEY、SECRET_KEY_BASE、PG_USER/PG_PASS等保持不变加密数据源的密钥连续性由.env中的主密钥保证。使用外部 PostgreSQL 的部署可参考同目录下的 deploy/docker/docker-compose.yaml。Kubernetes / Helm / 云厂商环境Helm仓库提供 deploy/helm 图表含 Chart.yaml 与 values.yaml升级时调整 chart 或镜像版本引用后执行 release 更新即可Kubernetes仓库提供 deploy/kubernetes/deployment.yaml 等原生清单GKE、AKS 等托管集群则有各自目录deploy/kubernetes/GKE、deploy/kubernetes/AKS升级动作是把工作负载镜像指向新 LTS 标签后重新 applyOpenShift对应 deploy/openshift/deployment.yaml 等清单升级方式与 Kubernetes 类似。升级操作自检清单综合文档内容一次 LTS 升级可按如下清单执行便于复核在镜像标签中确认目标 LTS 版本LTS-前缀如tooljet/tooljet:EE-LTS-latest确认当前实例版本不低于v2.23.0-ee2.10.2否则先升级到该版本对 PostgreSQL 数据库执行全面备份Docker 内置场景可用官方备份脚本外部数据库用快照/导出按当前部署方式将镜像/版本引用切换为目标 LTS 版本滚动更新服务启动完成后验证应用列表、数据源凭据解密与用户登录是否正常——首次启动若触发数据迁移服务端需要额外时间完成期间可能延迟响应 HTTP 请求仓库迁移脚本位于 server/migrations 与 server/data-migrations可在服务器日志中关注迁移执行进度。需要注意的是本文所涉版本策略3–5 个月一个 LTS、至少 18 个月 EOL、标签命名与版本门槛均以仓库当前 2.50.0-LTS 文档线为准如果你的实例已运行在 3.0.0-LTS 文档线docs/versioned_docs/version-3.0.0-LTS建议对照该线下的同名文档确认是否有策略更新。【免费下载链接】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），仅供参考