• 数据类型
  • Git 仓库
  • Blob
  • 数据库
• 复制/验证限制
  • 功能标志后的复制数据
    • 启用或禁用复制（对于某些数据类型）

支持的 Geo 数据类型

Geo 数据类型是一个或多个极狐GitLab 功能所需的特定数据类以存储相关信息。

为了使用 Geo 复制这些功能生成的数据，我们使用多种策略进行访问、传输和验证。

数据类型

我们区分以下三种数据类型：

• Git 仓库
• Blob
• 数据库

请参阅下表，了解我们复制的每个功能或组件、其相应的数据类型、复制和验证方法：

• (1)：Redis 复制可用作具有 Redis sentinel 的 HA 的一部分。不在 Geo 站点之间使用。
• (2)：对象存储复制可以由 Geo 或您的对象存储提供商/设备本机复制功能执行。
• (3)：对象存储验证的功能标志为 geo_object_storage_verification，引入于 16.4 并默认启用。它使用文件大小的校验和来验证文件。

Git 仓库

极狐GitLab 实例可以有一个或多个仓库分片。每个分片都有一个 Gitaly 实例，负责允许对本地存储的 Git 仓库进行访问和操作。它可以在机器上运行：

• 使用单个磁盘
• 将多个磁盘挂载为单个挂载点（如 RAID 阵列）
• 使用 LVM

极狐GitLab 不需要特殊的文件系统，并且可以与挂载的存储设备一起使用。但是，使用远程文件系统时可能会存在性能限制和一致性问题。

Geo 在 Gitaly 中触发垃圾收集，以对 Geo 次要站点上的派生仓库进行去重。

Gitaly gRPC API 通过三种可能的同步方式进行通信：

• 在两个 Geo 站点之间使用常规 Git 克隆/获取（使用特殊身份验证）
• 使用仓库快照（当第一种方法失败或仓库损坏时）
• 从管理中心手动触发（上述两者的组合）

每个项目最多可以有 3 个不同的仓库：

• 项目仓库：存储源代码
• Wiki 仓库：存储 Wiki 内容
• 设计仓库：索引设计产物（资产实际上位于 LFS 中）

它们都位于同一个分片中，并拥有相同的基本名称，为 Wiki 和设计仓库案例添加 -wiki 和 -design 后缀。

除此之外，还有代码片段仓库。它们可以连接到项目或某些特定用户。 两种类型都会同步到次要站点。

Blob

极狐GitLab 将文件和 Blob（例如议题附件或 LFS 对象）存储到以下任一位置：

• 特定位置的文件系统
• 对象存储解决方案。对象存储解决方案可以是：
  • 基于云，例如 Amazon S3 和 Google Cloud Storage
  • 由您托管（如 MinIO）
  • 公开对象存储兼容 API 的存储设备

当使用文件系统存储而不是对象存储并且使用多个节点时，请使用网络挂载的文件系统来运行极狐GitLab。

关于复制和验证：

• 我们使用内部 API 请求传输文件和 Blob
• 使用对象存储，您可以：
  • 使用云提供商的复制功能
  • 让极狐GitLab 为您复制

数据库

极狐GitLab 依赖于存储在多个数据库中的数据来满足不同的用例。 PostgreSQL 是 Web 界面中用户生成内容的单一事实来源，例如议题内容、评论以及权限和凭据。

PostgreSQL 还可以保存某种级别的缓存数据，例如 HTML 渲染的 Markdown 和缓存的合并请求差异。 这也可以配置为卸载到对象存储。

我们使用 PostgreSQL 自己的复制功能将数据从主要站点复制到次要站点。

我们使用 Redis 作为缓存存储并为后台作业系统保存持久数据。由于这两个用例都具有同一 Geo 站点独有的数据，因此我们不会在站点之间进行复制。

Elasticsearch 是用于高级搜索的可选数据库。它可以改进源代码级别的搜索以及议题、合并请求和讨论中用户生成的内容。 Geo 中不支持 Elasticsearch。

复制/验证限制

下表列出了极狐GitLab 功能及其在次要站点上的复制和验证状态。

功能标志后的复制数据

某些数据类型的复制需要启用相应的功能标志：

• 其部署在功能标志后面，默认启用。
• 其已在 JihuLab.com 上启用。
• 无法针对每个项目进行启用或禁用。
• 建议将其用于生产用途。
• 对于私有化部署的极狐GitLab 实例，极狐GitLab 管理员可以选择禁用。

启用或禁用复制（对于某些数据类型）

某些数据类型的复制是在默认启用的功能标志后面发布的。有权访问极狐GitLab Rails 控制台的极狐GitLab 管理员可以为您的实例禁用复制。您可以在下表的注释列中找到每种数据类型的功能标志名称。

要进行禁用，例如对于软件包文件复制：

Feature.disable(:geo_package_file_replication)

要进行启用，例如对于软件包文件复制：

Feature.enable(:geo_package_file_replication)

¹ 迁移到私有化部署架构于 15.5 版本。

² 迁移到自服务架构于 15.11 版本，功能标志为 geo_project_wiki_repository_replication，默认启用。