
jj-musubi 发布:可在多台机器间实时同步 Jujutsu 仓库
来源标题:Jj-musubi: live sync for Jujutsu
新工具 jj-musubi 能将 Jujutsu(jj)仓库的副本实时同步到多台机器,jj 每次对工作副本做快照后,改动会在片刻内同步到所有机器。它还会自动执行提交、rebase 和 fetch 等操作,让多机仓库用起来像 jj workspace。该工具面向跨多台机器工作的单用户,因此没有安全模型。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
很高兴宣布一个新的源代码控制工具 jj-musubi,它可以在多台机器之间实时同步 Jujutsu(jj)仓库的副本。每当 jj 对我的工作做快照时,jj-musubi 会在片刻之间将其同步到每一台机器,同时还会执行提交、变基、拉取等操作。
这个看似简单的能力,效果却出奇地强大。
我经常在一台机器上工作,在另一些机器上构建或测试。现在,它们能在我做出修改的同时拿到我的改动,我也不用再记着自己到底是在笔记本电脑上还是在别的地方编辑的。如果我从中上游拉取或向上游推送改动,我所有的副本都会保持最新。jj-musubi 让多台机器上的仓库感觉就像 jj 的 workspace(用 git 的话说就是 worktree)。
它面向的是在几台机器之间工作的单个人,所以它没有安全模型(或者说,它的安全模型就到此为止)。
你能做的事 Jujutsu 已经把工作副本当作一个 commit。运行 jj status 会把我的编辑快照记录进那个 commit,jj-musubi 随后把它同步到我的其他机器。我喜欢让 shell 提示符运行 jj status,所以实际上我很少需要操心快照这回事。
jj-musubi 不会写入工作副本。每台机器都照常拥有自己的工作副本和 workspace,因此 commit、快照和重写的同步可以在构建运行期间引入新的历史,而不会改变构建所依赖的文件。在笔记本电脑上,我可以离线工作,等我重新连上网络时机器会自动同步。
当我有 agent 在多台机器上工作时,这也被证明很顺手。我可以给每个 agent 在不同系统上分配各自的 jj workspace,然后在笔记本电脑上运行 jj diff -r devbox/agent-1@ 来查看其中一个到目前为止做了什么。如果某个 agent 发现了一个需要另一个来修的 bug,它们可以协调并看到彼此的工作,而无需额外开销。
临时使用 jj-musubi 把一组仓库副本称为一个 hive。
我经常在临时的一次性 VM 里运行 agent。jj-musubi 通过允许 agent 为其仓库在 hive 中的成员资格租约来支持这一点:如果它没有及时续租,它的仓库就会被遗忘,这样临时仓库或消失的容器就不会不断堆积、把东西搞得一团糟。
我为什么想要这个 当年我在 Meta 时,启动了这个后来成为 Sapling 和 Mononoke 的项目。Sapling 的 Commit Cloud 为那里的工程师提供了一种在机器之间移动工作的类似方式,Google 的工程师则有一个内部的 jj 服务器做类似的事。
从那以后,我一直怀念在我已经在用的机器上拥有那种日常便利,并且觉得我无需庞大的基础设施或托管就能实现它。有了 jj-musubi,一台机器运行 hub,各个 daemon 通过 SSH 与它交换 jj 历史。这几乎是最轻量的做法了。
安全性 棘手之处在于把并发工作做对。这在任何分布式源代码控制系统里本来就很难,而当同步是实时的、我们又要为不可靠网络中的断连工作做打算时,难度会大幅上升。
作为用户,我不应该去操心在我完成一次编辑后究竟什么时候才能安全地合上笔记本电脑;我所有的改动都应该在我合上之前、或者在我重新打开之后立刻传出去。在出现中断、重发、延迟或机器休眠的情况下,任何工作都不应丢失或损坏,而且即使机器永久离线,系统也应保持可靠。
我用 Lean 证明了 jj-musubi 网络协议的关键性质,并用测试把 Rust 代码与该模型进行比对。还有大量其他测试让真实的 jj 仓库经历并发编辑、中断的同步、hub 重启以及各种各样恶劣的情况。变异测试和对抗性测试确保在注入 bug 时会发生合理的行为。安全指南详细说明了所有的检查(以及我尚未覆盖的部分)。
没有 commit 的并发编辑……!? 能在一台机器上看到另一台机器上进行中的工作,听起来可能有点诡异或危险。这怎么能是安全的呢?
如果你在多个 workspace 中使用 jj,你早已习惯了能在两个 workspace 中检出同一个 change 并修改它的新奇之处。jj 只是把这个 change 标记为 divergent,但在你决定之前(例如调用 jj workspace update-stale),它不会用另一方的改动更新任何一个工作副本。在 jj 中,处理一个 change 的 divergent 版本与处理任何其他类型的冲突合并类似。
jj-musubi 使用了 jj 现有的 workspace 机制,所以一切都会让人感到熟悉。唯一的区别是,当你运行 jj-musubi 时,workspace 的名字会加上它所在机器的名称作为前缀。
试试看 从比如一台笔记本电脑和另一台常开的机器(我们叫它 devbox)开始,每台机器上各有一份 jj 仓库的副本。在每台机器上,下载二进制文件或自行构建:
cargo install --locked jj-musubi 在 devbox 上运行 musubi hub;它会把你的同步数据保存在 ~/musubi-hub 中。在笔记本电脑的仓库里,运行 musubi create --hub devbox。在 devbox 的仓库里,运行 musubi join。
我提供了 Linux、macOS 和 Windows 的构建版本,快速上手文档会带你完成设置和第一次同步。如果你试了之后有什么让你意外的地方,我很想听听。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。