Help us learn about your current experience with the documentation. Take the survey.

设置 Geo

  • Tier: Premium, Ultimate
  • Offering: GitLab Self-Managed

先决条件

  • 两个(或更多)独立运行的 GitLab 站点:

    • 一个 GitLab 站点作为 Geo 站点。使用 GitLab 参考架构文档 进行设置。每个 Geo 站点可以使用不同规模的参考架构。如果您已经有一个正在使用的 GitLab 实例,可以将其用作站点。

    • 第二个 GitLab 站点作为 Geo 站点。使用 GitLab 参考架构文档 进行设置。建议您登录并进行测试。但请注意,在从站点复制数据的过程中,从站点上的所有数据都将丢失

      Geo 支持多个从站点。您可以遵循相同的步骤,并据此进行相应调整。

  • 确保站点拥有 GitLab Premium 或 Ultimate 订阅以解锁 Geo 功能。所有站点只需要一个许可证。

  • 确认所有站点都满足 运行 Geo 的要求。例如,所有站点必须使用相同版本的 GitLab,并且站点之间必须能够通过特定端口进行通信。

  • 确认站点和站点的存储配置相匹配。如果 Geo 主站点使用对象存储,Geo 从站点也必须使用它。更多信息,请参阅 Geo 与对象存储

  • 确保站点和站点之间的时钟已同步。时钟同步是 Geo 正常运行的必要条件。例如,如果站点和站点之间的时钟漂移超过 1 分钟,复制将会失败。

使用 Linux 包安装

如果您使用 Linux 包(强烈推荐)安装了 GitLab,那么设置 Geo 的流程取决于您需要设置的是单节点 Geo 站点还是多节点 Geo 站点。

单节点 Geo 站点

如果两个 Geo 站点都基于 1K 参考架构,请遵循 为两个单节点站点设置 Geo 指南。

如果使用外部 PostgreSQL 服务(例如 Amazon RDS),请遵循 为两个单节点站点设置 Geo(使用外部 PostgreSQL 服务) 指南。

根据您的 GitLab 部署情况,可能需要对 LDAP、对象存储和容器仓库进行额外配置

多节点 Geo 站点

如果您的一个或多个站点使用的是 40 RPS / 2,000 用户参考架构 或更大规模,请参阅 为多节点配置 Geo

根据您的 GitLab 部署情况,可能需要对 LDAP、对象存储和容器仓库进行额外配置

通用步骤参考

  1. 根据您选择的 PostgreSQL 实例设置数据库复制(主(读写) <-> 从(只读)拓扑):
  2. 配置 GitLab 以设置站点和站点。
  3. 遵循 使用 Geo 站点 指南。

根据您的 GitLab 部署情况,可能需要对 LDAP、对象存储和容器仓库进行额外配置

额外配置

根据您的 GitLab 使用方式,可能需要进行以下配置:

您应该配置统一 URL,以便为所有 Geo 站点使用单一、统一的 URL。

使用 GitLab Charts

使用 GitLab Geo 配置 GitLab chart

Geo 与自编译安装

当您使用自编译的 GitLab 安装时,不支持 Geo。

安装后文档

站点上安装 GitLab 并完成初始配置后,请参阅以下文档获取安装后信息