Git版本控制的笔记本(遗留)

请注意

砖建议你使用砖回购同步与远程数据砖Git存储库。

本文描述了如何设置Git版本控制的笔记本(遗留功能)。您还可以使用CLI工作区API导入和导出笔记本和在本地开发环境中执行Git操作。

启用和禁用Git版本控制

默认情况下启用版本控制。这个设置切换:

  1. 管理设置>工作区设置。

  2. 先进的部分,取消选择笔记本Git版本控制切换。

配置版本控制

配置版本控制,在Git中创建访问凭据提供程序,然后添加这些凭证数据砖。

使用笔记本的修正

你使用笔记本上修改面板。通过单击打开历史面板修订历史右边的笔记本。

修订历史

请注意

您不能修改一个笔记本在历史面板打开。

一个笔记本保存到GitHub

而改变,你让你的笔记本自动保存数据砖修订历史,改变不会自动保存到GitHub。

  1. 点击修订历史在右上角的笔记本打开历史面板。

    现在历史面板——保存
  2. 点击保存现在GitHub拯救你的笔记本。保存笔记本修改对话框。

  3. 输入一个消息(可选)来描述你的改变。

  4. 确保Git也承诺被选中。

    保存修改
  5. 点击保存

恢复或更新一个笔记本从GitHub版本

一旦你连接一个笔记本,砖同步你的历史与Git每次你打开历史面板。版本同步到Git commit散列的条目。

  1. 点击修订历史在右上角的笔记本打开历史面板。

    历史面板
  2. 在历史面板中选择一个条目。砖显示器的版本。

  3. 点击恢复这个版本

  4. 点击确认确认你想要恢复的版本。

使用分支

你可以在任何存储库和创建新分支的分支在砖。

创建一个分支

  1. 点击修订历史在右上角的笔记本打开历史面板。

  2. 单击Git状态栏打开GitHub面板。

  3. 单击分支下拉。

  4. 输入部门名称。

    创建分支
  5. 选择创建分支选择下拉菜单的底部。表示父分支。你总是分支从你当前选中的分支。

创建一个将请求

  1. 点击修订历史在右上角的笔记本打开历史面板。

  2. 单击Git状态栏打开GitHub面板。

    Git偏好——创建请求
  3. 点击创建公关。GitHub打开拉请求页面的分支。

变基一个分支

你也可以变基你砖内部分支。的变基链接显示如果新提交是在父分支。只有垫底术上的默认分支父库支持。

变基

例如,假设您正在研究砖/ reference-apps。你叉到自己的帐户(例如,brkyvz),并开始致力于一个分支我的枝。如果一个新的更新推到砖:主,那么变基按钮显示,你将能够把更改到你的分支brkyvz:我的枝

重新在砖稍有不同。假设以下分支结构:

之前变基分支结构

变基后,分支结构看起来像:

后变基分支结构

这里有什么不同是提交C5、C6不适用C4。他们看起来像本地更改到你的笔记本上。合并冲突出现如下:

合并冲突

然后您可以提交GitHub再次使用保存现在按钮。

如果有人支从我的部门,我只是重置吗?

如果你的分支(例如,在分支)是另一个分支的基础(分支),你变基,你不需要担心!一旦用户重置分支,所有问题就解决了。在这种情况下的最佳实践是使用单独的分支为单独的笔记本。

最佳实践代码评审

砖支持Git分支。

  • 你可以链接一个笔记本存储库中的任何分支。为每个笔记本砖建议使用一个单独的分支。

  • 在开发期间,您可以链接一个笔记本的叉库或非默认分支在主存储库。上游整合您的更改,您可以使用Git首选项对话框中创建公关链接砖来创建一个GitHub拉请求。创建公关链接只显示如果你不是在父库的缺省分支。

故障排除

如果你收到的错误相关同步GitHub历史,验证以下:

  • 你只能联系一个笔记本一个初始化Git存储库,并不是空的。在web浏览器中测试URL。

  • GitHub个人访问令牌必须是活跃的。

  • 使用私人GitHub库,必须读存储库的权限。

  • 如果一个笔记本与重命名一个GitHub分支,变化是不会自动反映在砖上。您必须手动re-link笔记本的分支。