我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

此版本的 GitHub Enterprise 已停止服务 2021-03-02. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

Git 数据库 API 入门指南

Git 数据库 API 使您能够在 GitHub Enterprise Server 上的 Git 数据库中读取和写入原始 Git 对象,并列出和更新您的引用(分支头部和标记)。

本文内容

概览

这基本上允许您通过我们的 API 重新实现大量 Git 功能 - 通过直接在数据库中创建原始对象并更新分支引用,从技术上讲,您可以在不安装 Git 的情况下完成 Git 能做的任何事情。

如果 Git 仓库为空或不可用,Git 数据库 API 函数将返回 409 Conflict。 仓库不可用通常意味着 GitHub Enterprise Server 正在创建仓库。 对于空仓库,您可以使用“创建或更新文件内容”端点来创建内容并初始化仓库,以便您可以使用 Git 数据库 API。 如果此响应状态仍然存在,请联系 您的站点管理员。

git 数据库概述

有关 Git 对象数据库的更多信息,请阅读 Pro Git 手册中的 Git 内部章节。

例如,如果要将更改提交到仓库中的某个文件,您需要:

  • 获取当前提交对象
  • 检索它指向的树
  • 检索树中针对该特定文件路径的 blob 对象的内容
  • 以某种方式更改内容并发布包含这些新内容的新 blob 对象,以获取 blob SHA
  • 发布新的树对象, 将文件路径指针替换为新的 blob SHA, 以获取树 SHA
  • 通过作为父级的当前提交 SHA 和新的树 SHA,创建新的提交对象,以获取提交 SHA
  • 更新分支的引用以指向新的提交 SHA

看似很复杂,但是当您了解模型后,实际上很简单,它为您开辟了广阔的天地,使您可以使用 API 实现许多功能。

检查拉取请求的可合并性

警告!请不要依赖直接使用 Git 或 GET /repos/{owner}/{repo}/git/refs/{ref} 更新 merge Git 引用,因为此内容会在不发出警告的情况下过期。

消费 API 需要明确请求拉取请求来创建一个测试合并提交。 当您在 UI 中查看拉取请求并且“ Merge(合并)”按钮显示时,或者当您使用 REST API 来获取创建编辑拉取请求时,将创建一个测试合并提交。 如果没有此请求,merge Git 引用将过时,直到下次有人查看拉取请求。

如果您当前正在使用会生成过时 merge Git 引用的轮询方法,GitHub 建议使用以下步骤从默认分支获取最新更改:

  1. 接收拉取请求 web 挂钩。
  2. 调用 GET /repos/{owner}/{repo}/pulls/{pull_number} 以启动创建合并提交候选项的后台作业。
  3. 使用 GET /repos/{owner}/{repo}/pulls/{pull_number} 轮询仓库,以查看 mergeable 属性是 true 还是 false。 您仅在执行上述步骤后才可直接使用 Git 或 GET /repos/{owner}/{repo}/git/refs/{ref} 更新 merge Git 引用。