Skip to main content

Git Sync 与 Workspace Repository

Git Sync 将平台 workspace 连接到 GitHub workspace repository。平台会读取该仓库中的 rollout 代码和配置,发现 rollouts/ 下的 rollouts,并使其可用于训练。 您的本地 workspace directory 是同一仓库的 clone。Push 到任意分支即可同步该分支的 rollout catalog。

仓库设置

1

创建或连接 workspace repository

workspace owners 和 admins 在平台中连接 GitHub,然后从 Osmosis workspace template 创建私有 workspace repository,或连接已有仓库。从平台创建的新仓库会包含 starter examples:multiply-local-strandsmultiply-local-openaimultiply-harbor-strands。如需完整首次设置流程,请从 Onboarding 开始。
2

在本地 workspace directory 中工作

您的本地 workspace directory 应该是已连接 GitHub 仓库的 clone。被邀请的成员使用已有 workspace repository,而不是创建第二个仓库。
3

验证本地 context

在本地 workspace directory 中,确认 origin remote 指向已连接的 GitHub 仓库:

同步如何工作

  • Push 到任意分支 都会触发该分支的自动同步。
  • 平台会按分支分别发现 rollouts/ 目录中的 rollout definitions。
  • 每个 rollout 子目录(e.g. rollouts/my-rollout/)都会成为平台上的 rollout entity,可用于训练和评估。
  • configs/ 下的配置文件也会同步,因此 osmosis train submit 可以通过路径引用它们。
  • 平台会记录同步历史,包括 branch、commit SHA、author、message、status 和发现的 rollout 数量。
  • 删除分支时,平台只会移除该分支的 rollout catalog;仍存在于其他分支的 rollout 不会被删除。
Git Sync 是您 rollout 代码的 source of truth。CLI 会读取您传入的本地 TOML config 值,但 rollout 代码来自已同步的 workspace repository。提交代码修改前,请先 commit 并 push。设置 branch 可使用已 push 的分支,设置 commit_sha 可固定到特定已 push revision;都省略时使用默认分支。

同步状态

在平台的 Git Integration 中查看同步历史。每个同步事件会显示: 平台提供手动同步操作,可在不 push 新 commit 的情况下重新处理仓库中的所有分支。

阻塞状态

当 GitHub 设置阻塞训练 workflow 时,平台会显示 banner。

重要说明

  • 所有分支都会自动同步;workspace 中没有单独的 branch-sync 设置。
  • Rollouts 页面提供 branch picker。仓库默认分支排在最前并默认选中,URL 中的 ?branch=<name> 会保留当前选择。
  • 如果仓库在 GitHub 上被重命名,请更新本地 origin remote,并检查平台连接。
run config 中使用 branch 可跟随某个分支,使用 commit_sha 可固定到特定 commit。二者互斥;都省略时使用默认分支。

下一步

Workspace 仓库

了解本地 CLI 命令如何限定到某个仓库。

训练

在 Git Sync 成功后提交并管理 training runs。
最后修改于 2026年8月10日