34 Git 集成（预览）

您可以将 Oracle AI Data Platform 实例连接到外部 Git 资源库，从中摄取、读取和写入数据。

AI Data Platform 中的 Git 集成可为 Git 账户提供登录凭据，并创建连接到 Git 资料档案库的文件夹以及用于摄取数据的凭据。您可以存储多个身份证明集以连接到不同的 Git 资料档案库或管理对同一资料档案库的不同访问级别。管理员可以选择一组身份证明作为用户的默认概要信息，并在不再需要时删除身份证明。

您可以完全从 AI Data Platform 中管理 Git 文件，并使用实用程序来推送、拉取、提交和合并文件，以及管理出现的任何合并冲突，而无需离开平台。

AI 数据平台还允许您从 Git 存储库分支代码，以及切换、合并、比较和删除分支。

注意：

AI Data Platform 目前支持托管在公共 Git 提供商（例如 GitHub、GitLab、Bitbucket 和 Oracle Cloud Infrastructure DevOps ）上的 Git 存储库。客户专用网络上托管的 Git 支持将在未来的更新中提供。

Oracle AI Data Platform 中的 Git 文件夹（预览）

Oracle AI Data Platform 中的 Git 文件夹允许您与 Git 资料档案库中托管的数据进行交互，而无需离开平台。

Git 文件夹是使用您在 AI 数据平台设置中设置的凭据在主目录中创建。您可以将文件夹连接到 Git 资源库，并使用 AI 数据平台 UI 来推送、拉取、合并、合并和重置资源库中的文件。

您可以管理 Git 文件夹的 RBAC 权限，以控制谁可以查看该文件夹以及他们能够执行的 Git 操作。有关更多信息，请参见 Git Folder Permissions (Preview) 。

圆锥图案规则（预览）

Oracle AI Data Platform 中的 Git 内容的稀疏签出支持 Cone 模式。

Git 中的 sparse-checkout 命令用于创建稀疏结帐，这将更改工作树以跟踪所有跟踪文件的子集。在 AI Data Platform 中，使用 sparse-checkout 命令提供目录时必须使用 Cone 模式。模式必须表示与存储库根相关的文件夹路径。

sparse-checkout Cone 模式允许的值

使用 sparse-checkout 时，代码模式允许模式中的以下值：
  • 值为空。这意味着仅根级系统信息库文件。
  • 仅空白/空白值。被视为空/仅根。
  • 相对于系统信息库根的文件夹路径：
    • project-a
    • project-a/src
    • notebooks/jobs/
  • 不包含任何受限字符的文件夹名称（请参见下文）

sparse-checkout Cone 模式不允许的值

将 Cone 模式用于 sparse-checkout 时，不接受模式中的以下值：
不允许值 范例
排除模式 !src
非克隆 glob 语法 *.py, src/[abc], src?
绝对/根路径 /src, /
倒斜杠 src\main
资料档案库根标记 ., ./
前导 ./ ./src
空路径段 src//main
父遍历 ../src, src/../main
前导短划线 -src
控制符 例如，新行、回车符、空字符

锥形模式限制

将 Cone 模式用于 sparse-checkout 时，以下限制适用：

组件 限制
模式数 100 模式
模式长度 1000 个字符
模式为空 已允许

Git 文件夹路径

Git 文件夹路径将作为相对路径进行验证。每个路径段只能包含：
  • 信件：a-z、A-Z
  • 编号：0-9
  • 下划线：_
  • 连字符：-
  • 点：.
  • 空间
  • 符号：@
有效路径如下所示：
  • repo
  • repo.name_test-1@dev
  • folder name
  • jobs/git_provider/TASK1
对于与 sparse-checkout 一起使用的 Git 路径，不允许使用以下项：
  • 绝对的路径
  • 父遍历
  • 特殊符号：!、#、$、%、*、?、[、]、\、:

创建 Git 文件夹（预览）

您可以在连接到外部 Git 资料档案库的 Oracle AI Data Platform 工作区中创建文件夹。

  1. 在主页上，导航到您的工作区。
  2. 单击 “创建目录”图标 创建，然后单击 Git 文件夹。您还可以单击右上角的添加，然后单击 Git 文件夹。
  3. 从选择 Git 身份证明下拉列表中，选择访问 Git 系统信息库所需的 Git 身份证明。
  4. 提供 Git 资源库 URL。例如：example.git.path。
  5. 为工作区中的 Git 文件夹提供名称。
  6. 提供 Git 资源库中的分支以连接到您的文件夹。
  7. 为要克隆的文件夹提供稀疏结账圆锥模式。将此字段留空将克隆整个系统信息库。
  8. 单击创建。

为 OCI DevOps 资料档案库创建 Git 文件夹（预览）

您可以在 Oracle AI Data Platform 中为在 Oracle Cloud Infrastructure 中创建的 DevOps 资料档案库创建 Git 文件夹。

必须已在 OCI 中创建了 DevOps 系统信息库。有关详细信息，请参阅创建资料档案库。
您必须已创建身份证明才能访问 AI 数据平台中的 DevOps 项目。有关详细信息，请参阅创建身份证明（预览）。

注意：

为 DevOps 项目创建身份证明时，您的用户名应排除 DevOps 项目通常包含的 @tenancyname。例如，如果您的 DevOps 项目用户名是 Acme/oracleidentitycloudservice/alice.jones@acme.com，则您的 AI 数据平台凭证的用户名为 Acme/oracleidentitycloudservice/alice.jones。
  1. 在主页上，导航到您的工作区。
  2. 单击 “创建目录”图标 创建，然后单击 Git 文件夹。您还可以单击右上角的添加，然后单击 Git 文件夹。
  3. 从选择 Git 身份证明下拉列表中，选择访问 DevOps 系统信息库所需的 Git 身份证明。
  4. 提供 DevOps 资料档案库 URL。例如，https://<region>.devops.oci.oraclecloud.com/namespaces/<tenancy>/projects/<project>/repositories/<repo>.git。
  5. 为工作区中的 DevOps 文件夹提供名称。
  6. 提供 DevOps 资料档案库中的分支以连接到文件夹。
  7. 单击创建。

编辑 Git 文件夹（预览）

您可以在工作区中更改 Git 文件夹的名称和说明。

  1. 在主页上，导航到您的工作区。
  2. 在要修改的 Git 文件夹旁边，单击 “操作三个点”图标 操作，然后单击编辑。
  3. 修改文件夹的名称和说明。
  4. 更新稀疏结账圆锥模式规则。
  5. 单击保存。

删除 Git 文件夹（预览）

您可以从工作区中删除您自己的 Git 文件夹。

删除 Git 文件夹将删除该文件夹以及所有尚未提交并推送到存储库的更改。
  1. 在主页上，导航到您的工作区。
  2. 在要修改的 Git 文件夹旁边，单击 “操作三个点”图标 操作，然后单击删除。
  3. 单击删除。

修改 Git 文件夹设置（预览）

您可以修改工作区中 Git 文件夹使用的身份证明和资料档案库 URL。

  1. 在主页上，导航到您的工作区。
  2. 单击要修改其设置的 Git 文件夹。
  3. 单击设置选项卡。
  4. 从下拉列表中，选择 Git 文件夹的新身份证明。
  5. 输入新的 Git 资源库 URL。
  6. 单击保存。

查看 Git 文件夹历史记录（预览）

您可以从“历史记录”选项卡查看提交到 Git 文件夹的历史记录。

  1. 导航到 Git 文件夹，然后单击 Git 选项卡。
  2. 单击历史记录选项卡。
  3. 单击 Git 按钮可查看 Git 站点上的提交历史记录。

创建 Git 分支（预览）

您可以从工作区中的 Git 文件夹中的现有分支创建新 Git 分支。

  1. 导航到 Git 文件夹，然后单击 Git 选项卡。
  2. 从当前分支下拉列表中，选择要作为新分支基础的分支。
  3. 单击创建分支。
  4. 为您的新分支提供名称，
  5. 单击创建。

删除 Git 分支（预览）

您可以从 Oracle AI Data Platform 工作区内的 Git 存储库中删除 Git 分支。

  1. 导航到 Git 文件夹，然后单击 Git 选项卡。
  2. 从当前分支下拉列表中，选择要删除的分支。
  3. 单击删除分支。
  4. 选择要删除的所有分支。
  5. 可选：选择强制删除而不考虑合并状态可忽略尚未合并的任何分支的警告。
  6. 单击删除。

Git 提取（预览）

您可以从工作区的 Git 文件夹中选择一个分支来执行 Git 提取。

  1. 导航到 Git 文件夹，然后单击 Git 选项卡。
  2. 单击提取选项卡。
  3. 从下拉列表中，选择要从中提取的分支。
  4. 单击提取。
  5. 解决任何冲突。
    • 单击 Keep local（保留本地）以使用本地版本覆盖。
    • 单击 Keep remote（保留远程）以覆盖远程版本。
    • 您还可以进行自己的更改以解决问题，然后单击标记为已解决。
    • 单击中止拉入可取消拉入请求。
  6. 输入提交消息和拉入的说明（可选）。
  7. 单击提交拉式。

Git 推送（预览）

您可以选择分支，从工作区的 Git 文件夹内执行 Git 推送。

  1. 导航到 Git 文件夹，然后单击 Git 选项卡。
  2. 单击推送选项卡。
  3. 选择要推送到 Git 资料档案库的文件。单击文件可在代码窗口中查看更改。
  4. 输入提交消息以及推送的说明（可选）。
  5. 单击提交推送。

将 Git 分支合并为主（预览）

您可以将分支从工作区的 Git 文件夹中合并回主干线。

  1. 导航到 Git 文件夹，然后单击 Git 选项卡。
  2. 单击合并选项卡。
  3. 从下拉列表中，选择要与主节点合并的分支。
  4. 单击 Merge 。
  5. 解决任何冲突。
    • 单击 Keep local（保留本地）以使用本地版本覆盖。
    • 单击 Keep remote（保留远程）以覆盖远程版本。
    • 您还可以进行自己的更改以解决问题，然后单击标记为已解决。
    • 单击中止合并以取消合并请求。
  6. 输入提交消息，以及（可选）合并的说明。
  7. 单击提交合并。

Git Rebase（预览）

您可以在 Git 文件夹中合并分支，以将更改从该 Git 分支应用到另一个分支。

注意：

解除分支需要强制推送。强制推送会更改远程系统信息库上的历史记录，并可能导致在同一系统信息库上工作的协作者出现版本化问题。
  1. 导航到 Git 文件夹，然后单击 Git 选项卡。
  2. 单击合并更改选项卡。
  3. 从当前分支下拉列表中，选择要合并更改的分支。
  4. 从合并更改至分支下拉列表中，选择要将当前分支合并更改为的分支。
  5. 选择确认合并基础。
  6. 单击合并更改。

Git 重置（预览）

您可以重置 Git 文件夹中的分支，以将该分支的内容还原为以前的状态。

注意：

重置分支需要强制推送。强制推送会更改工作区和远程资料档案库中本地当前分支上的历史记录。分支的历史记录将被删除并重置为远程重置分支的历史记录。
  1. 导航到 Git 文件夹，然后单击 Git 选项卡。
  2. 单击重置选项卡。
  3. 从当前分支下拉列表中，选择要重置的分支。
  4. 从选择要将当前分支“主”重置为的远程分支下拉列表中，选择远程 Git 资料档案库中的分支以将当前分支重置为。
  5. 选择确认硬重置。
  6. 单击重置。