在 GitHub 上发布 Notebook

要与项目干系人和其他数据研究员协作,您可以在 GitHub 存储库中发布 Notebook。 您还可以使用 GitHub 来备份 Notebook 以进行源代码管理。

请观看此视频以了解如何启用 GitHub 集成。

视频免责声明: 此视频中的一些次要步骤和图形元素可能与您的平台不同。

此视频提供了一种可视方法来学习本文档中的概念和任务。

  • 视频脚本
    时间 脚本
    00:00 本视频向您展示如何将项目中的笔记本发布到GitHub账户。
    00:07 浏览到您的概要文件和设置。
    00:11 在 "集成" 选项卡上,访问链接以生成 GitHub 个人访问令牌。
    00:17 提供令牌的描述性名称,并选择存储库和 Gist 作用域,然后生成令牌。
    00:29 复制令牌,返回到 GitHub 集成设置,然后粘贴令牌。
    00:36 将令牌保存到概要文件设置时,将对其进行验证。
    00:42 现在,浏览到您的项目。
    00:44 您可以在 "设置" 选项卡上的项目级别启用 GitHub 集成。
    00:50 只需滚动到底部并粘贴现有的 GitHub 存储库 URL。
    00:56 您将在存储库中的 "代码" 选项卡上找到此信息。
    01:01 单击 "更新" 以建立连接。
    01:05 现在,转至 "资产" 选项卡,打开要发布的笔记本。
    01:14 请注意,此笔记本的凭证已替换为 X 的凭证。
    01:19 最佳实践是在发布到 GitHub之前除去或替换凭证。
    01:24 因此,此笔记本已准备好进行发布。
    01:27 您可以提供目标路径以及落实消息。
    01:31 您还可以选择发布不带隐藏代码的内容,这意味着将不会发布 Notebook 中以隐藏单元格注释开头的任何单元格。
    01:42 当您准备好时,请单击 "发布"。
    01:45 此消息告诉您已成功发布 Notebook ,并提供指向 Notebook ,存储库和落实的链接。
    01:54 让我们来看看落实。
    01:57 因此,存在落实,您可以浏览到存储库以查看已发布的 Notebook。
    02:04 最后,您可以作为主旨发布。
    02:07 Gists 是在 GitHub上共享工作的另一种方法。
    02:10 每个 gist 都是一个 git 存储库,因此可以进行派生和克隆。
    02:15 有两种类型的 gists: 公开和秘密。
    02:19 如果您从一个秘密 Gist 开始,那么可以稍后将其转换为公共 Gist。
    02:24 同样,您可以选择除去隐藏的单元格。
    02:29 遵循链接以查看已发布的大意。
    02:32 这就是GitHub集成的基本原理。
    02:37 在 Cloud Pak for Data as a Service 文档中查找更多视频。

允许从您的帐户访问 GitHub

在 "GitHub,上发布笔记本之前,您必须启用 "IBM"watsonx账户访问 "GitHub。 您可以通过在 GitHub 中创建具有所需访问作用域的个人访问令牌并将该令牌链接到 IBM watsonx 帐户来启用访问。

请遵循下列步骤来创建个人访问令牌:

  1. 单击标题中的头像,然后单击 概要文件和设置
  2. 转至 集成 选项卡,单击对话框上的 GitHub 个人访问令牌链接并生成新令牌。
  3. 在“新建个人访问令牌”页面上,选择 repo 范围,然后单击以生成令牌。
  4. 复制生成的访问令牌,并将其粘贴到 IBM watsonx中的 GitHub 集成对话框窗口中。

将项目链接到 GitHub 存储库

保存访问令牌后,必须将项目连接到现有 GitHub 存储库。 只能从项目链接到一个现有 GitHub 存储库。 支持专用存储库。

要将项目链接到现有 GitHub 存储库,您必须具有该项目的管理员许可权。 所有具有管理员或编辑者许可权的项目合作者都可以将文件发布到此 GitHub 存储库。 但是,这些用户必须具有访问该存储库的许可权。 必须在 Git 存储库中完成为用户授予对于存储库的许可权。

要将项目连接到现有 GitHub 存储库,请执行下列操作:

  1. 选择 管理 选项卡,然后转至 " 服务和集成 " 页面。
  2. 单击 第三方集成 选项卡。
  3. 单击 连接集成
  4. 输入从 Github 生成的访问令牌。

现在,您可以开始在 GitHub 上发布 Notebook。

注:

有关如何更改 Git 集成的信息,请参阅 管理集成

在 GitHub 上发布 Notebook

在GitHub:上发布笔记本:

  1. 以编辑模式打开笔记本:打开笔记本预览窗口后,单击编辑 编辑图标 图标。
  2. 单击 GitHub 集成图标 上载图标 ,然后从打开的笔记本操作栏中选择在 GitHub 上发布

当您在 GitHub 上输入要发布的文件的名称时,可以在 GitHub 存储库中指定文件夹路径。 请注意,笔记本文件始终会推送到主分支。

如果收到以下错误: An error occurred while publishing the notebook. Invalid access token permissions or repository does not exist. 请确保:

  • 您已生成个人访问令牌,如 允许从帐户访问 GitHub 中所述,并且未删除该令牌。
  • 要将 Notebook 发布到的存储库仍然存在。