如何配置MongoDB Realm与GitHub双向同步 实现UI改动自动提交

当前MongoDB官方已上线开箱即用的双向同步能力，无需自定义开发脚本、Webhook或自建触发器，按以下步骤配置即可实现MongoDB UI侧变更自动提交回GitHub仓库，和原有GitHub推送自动部署的单向流程协同工作：

• 进入对应MongoDB Realm应用的管理后台，打开左侧导航栏「Deployment」分类下的已绑定GitHub集成配置页
• 在集成详情面板中找到**双向同步（Two-way Sync）**功能开关，点击开启
  • 系统会自动校验已授权GitHub账号的仓库操作权限，若缺少提交、分支创建所需权限，会引导你完成OAuth授权补全即可，无需手动调整GitHub仓库侧的配置
• 根据团队规范调整同步规则细节：
  • 勾选需要触发反向提交的变更类型：可覆盖Realm UI内的数据规则修改、自定义函数调整、Schema变更、环境变量配置更新等所有非Git来源的操作
  • 选择变更提交的目标分支：默认同步推送到原有单向流程绑定的主分支，也可配置为推送到独立的变更分支，自动生成PR待审核后合并，避免未校验的配置直接进入主分支
  • 可自定义Commit信息模板，自动填充变更操作人、变更时间、具体变更模块等可追溯信息

运行机制说明 #

• 系统内置变更来源识别逻辑，不会将GitHub侧推送部署产生的变更反向生成重复Commit，不存在循环同步问题
• 首次开启双向同步时，系统会自动比对当前Realm应用状态与GitHub仓库的配置差异，将之前未同步回仓库的存量UI修改，一次性生成初始Commit同步至仓库

注意：原有「GitHub推送到分支→自动部署MongoDB Realm」的单向链路不需要做任何调整，双向同步开启后两套流程会自动兼容，不会出现部署冲突

内容的提问来源于stack exchange，提问作者Niklas