Newshot

宣布 jj-musubi:为 Jujutsu 提供实时同步

Translation(model translation, not the source's own text)

我很高兴宣布一个新的源代码控制工具 jj-musubi,它可以在多台机器之间实时同步一个 Jujutsu(jj)仓库的副本。每当 jj 对我的工作进行快照时,jj-musubi 都会在片刻之间将其同步到每台机器,并且还会执行提交、变基、获取等操作。

这个简单的能力强大得令人意外。

  • 我经常在一台机器上工作,在另一台机器上构建或测试。现在它们会在我做出更改时获得这些更改,我也不需要记住自己是在笔记本电脑上还是在别的什么地方编辑。
  • 如果我向上游获取更改或向上游推送更改,我所有的副本都会保持最新。

jj-musubi 让多台机器上的仓库感觉就像 jj 工作区(如果你用 git 的说法,就是 worktrees)。

它面向的是一个人在多台机器上工作的场景,因此没有安全模型(或者说,它的安全模型也就仅此而已)。

你可以做的事情

Jujutsu 已经把工作副本当作一个提交。运行 jj status 会把我的编辑快照记录到那个提交中,然后 jj-musubi 会将其同步到我的其他机器。我喜欢让 shell 提示符运行 jj status,所以实际上我很少需要考虑快照。

jj-musubi 不会写入工作副本。每台机器都像往常一样拥有自己的工作副本和工作区,因此提交、快照和重写的同步可以在构建运行时引入新的历史,而不会改动它下面的文件。在笔记本电脑上,我可以离线工作,等我重新联网时机器会同步。

当我有智能体在多台机器上工作时,这也被证明很方便。我可以让每个智能体在不同系统上拥有自己的 jj 工作区,然后在笔记本电脑上运行 jj diff -r devbox/agent-1@,看看其中一个到目前为止做了什么。如果一个智能体发现了另一个需要修复的 bug,它们可以协调并查看彼此的工作,而无需额外开销。

临时用途

jj-musubi 把一个仓库的一组副本称为 hive。

我经常在临时的、可丢弃的 VM 中运行智能体。jj-musubi 通过允许一个智能体租用其仓库在 hive 中的成员资格来支持这一点:如果它没有及时续租,它的仓库就会被遗忘,因此临时仓库或消失的容器就不能只是堆积起来并把东西弄得杂乱。

我为什么想要这个

早在我还在 Meta 时,我启动了一个后来成为 Sapling 和 Mononoke 的项目。Sapling 的 Commit Cloud 为那里的工程师提供了一种类似方式,在多台机器之间迁移工作;Google 的工程师则通过一个内部 jj 服务器拥有类似的东西。

从那以后,我一直怀念在我已经在使用的机器上拥有那种日常便利,并觉得自己不需要庞大的基础设施或托管就能实现它。使用 jj-musubi 时,一台机器运行 hub,守护进程通过 SSH 与它交换 jj 历史。这几乎已经是最轻量的做法了。

安全性

棘手的是正确处理并发工作。这在任何分布式源代码控制系统中本来就很难,而当同步是实时的、并且我们要为不可靠网络中的断连工作做规划时,难度会大幅上升。

作为用户,我不应该需要关心编辑完成后究竟什么时候可以安全地合上笔记本电脑;我的所有更改都应该在我合上之前,或在我重新打开之后立刻成功同步。在出现中断、重发、延迟或机器休眠时,任何工作都不应丢失或损坏;即使机器永久离线,系统也应保持可靠。

我用 Lean 证明了 jj-musubi 网络协议的关键性质,并用测试将 Rust 代码与该模型进行对比。大量其他测试会让真实的 jj 仓库经历并发编辑、同步中断、hub 重启以及无数其他棘手情况。变异测试和对抗性测试确保在注入 bug 时,系统会做出合理的行为。安全指南详细说明了所有检查(以及我尚未覆盖的部分)。

没有提交的并发编辑……!?

能够从另一台机器看到某台机器上进行中的工作,听起来可能有点诡异或危险。这怎么能是安全的呢?

宣布推出 jj-musubi:为 Jujutsu 提供实时同步

如果你在多个工作区中使用 jj,你大概已经习惯了这种新鲜体验:可以在两个工作区中检出同一个变更并修改它。jj 只是将该变更标记为分歧,但在你决定处理之前,例如通过调用 jj workspace update-stale,它不会用另一个工作区的变更更新任一工作副本。在 jj 中,处理某个变更的分歧版本,类似于处理任何其他类型的冲突合并。

jj-musubi 使用 jj 现有的工作区机制,因此一切都会让人感到熟悉。唯一区别是,当你运行 jj-musubi 时,工作区的名称前会加上它所在机器的名称。

试试看

例如,从一台笔记本电脑和另一台始终在线的机器(我们称它为 devbox)开始,每台机器上都有一份 jj 仓库的副本。在每台机器上,下载二进制文件或自行构建:


        cargo install --locked jj-musubi
      

在 devbox 上运行 musubi hub;它会把你的同步数据保存在 ~/musubi-hub 中。在笔记本电脑的仓库中,运行 musubi create --hub devbox。在 devbox 的仓库中,运行 musubi join。

我提供 Linux、macOS 和 Windows 的构建版本,快速入门会带你完成设置和首次同步。如果你试用后遇到让你意外的地方,我很想听听。

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by Lobsters
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗