Skip to content

ThingsBoard 的版本控制使用 Gitee ​

正文与配图来自原稿。把仪表板、规则链、设备等实体像代码一样提交到 Gitee,可回滚。

1、准备 Gitee 仓库 ​

注册 Gitee,创建空间与仓库,用于存 ThingsBoard 版本数据:

创建 Gitee 仓库

2、租户层配置版本控制 ​

进入租户 → 版本控制,填写:

项示例(请换成你的)
仓库 URLhttps://gitee.com/<你的空间>/<仓库>.git
分支master(或 main)
身份验证密码或访问令牌
用户名Gitee 用户名

版本控制配置

注意(本地跑 TB): 删除仓库后若报目录仍被引用(如
C:\Users\…\AppData\Local\Temp\repositories),先停掉 TB,清掉该临时目录再启动。

请使用访问令牌,勿把账号密码写进文档或提交到 Git。

3、测试 ​

3.1、设备页创建版本 ​

点击创建版本:

创建版本入口

弹窗确认后创建:

创建版本弹窗

创建成功

Gitee 上可见提交:

Gitee 仓库内容

修改设备后出现变更:

修改设备

检测到变更

再点创建版本会提交:

再次创建版本

提交结果

还原 ​

还原到某一版本:

还原版本

查看还原后数据:

还原后

自动提交策略 ​

在 Settings 配置自动提交(如对设备开启):

自动提交配置

修改设备描述后出现自动提交:

修改描述

自动提交记录

自动提交详情

自动提交说明(原稿):
通过 UI 或 REST 保存实体时,可自动提交仪表板、规则链等;异步执行以改善体验。将实体分配给客户(改所有者)时不会自动提交,此时应对该实体类型用覆盖策略提交全部实体。

恢复界面:下拉列表中是可恢复实体,去掉不需要的项后点 Restore:

恢复实体

总结 ​

ThingsBoard 版本控制本质是对接 Git:实体可版本化、可回滚,用法接近日常代码提交。


补充(辅) ​

  • 需租户开通版本控制能力(CE/PE 与版本以你环境为准)。
  • 生产建议用 Personal Access Token,仓库私有。
  • 大实体、频繁自动提交会增加 Git 体积,按需选择实体类型。

相关文章 ​