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-strands、multiply-local-openai 和 multiply-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 Integration 中查看同步历史。每个同步事件会显示:
平台提供手动同步操作,可在不 push 新 commit 的情况下重新处理仓库中的所有分支。
阻塞状态
当 GitHub 设置阻塞训练 workflow 时,平台会显示 banner。重要说明
- 所有分支都会自动同步;workspace 中没有单独的 branch-sync 设置。
- Rollouts 页面提供 branch picker。仓库默认分支排在最前并默认选中,URL 中的
?branch=<name>会保留当前选择。 - 如果仓库在 GitHub 上被重命名,请更新本地
originremote,并检查平台连接。
下一步
Workspace 仓库
了解本地 CLI 命令如何限定到某个仓库。
训练
在 Git Sync 成功后提交并管理 training runs。