• 配置仓库存储路径
  • 配置备份
  • 示例配置
• 配置新仓库的存储位置

仓库存储

极狐GitLab 将仓库存储在仓库存储中。仓库存储是：

• gitaly_address，指向一个 Gitaly 节点。
• path，它直接指向存储存储库的目录。此方法在 14.0 版本中已弃用并计划删除。极狐GitLab 应配置为通过 gitaly_address 访问 GitLab 仓库。

极狐GitLab 允许您定义多个仓库存储以在多个挂载点之间分配存储负载。例如：

• 使用 Gitaly 时（Linux 软件包安装配置）：

   git_data_dirs({
     'default' => { 'gitaly_address' => 'tcp://gitaly1.internal:8075' },
     'storage2' => { 'gitaly_address' => 'tcp://gitaly2.internal:8075' },
   })
  

• 使用直接仓库存储时（源安装配置）：

  default:
    gitaly_address: tcp://gitaly1.example:8075
  storage2:
    gitaly_address: tcp://gitaly2.example:8075
  

配置仓库存储路径

要配置仓库存储路径：

1. 编辑必要的配置文件：
   • /etc/gitlab/gitlab.rb，用于 Omnibus GitLab 安装。
   • gitlab.yml，用于从源代码安装。
2. 添加所需的仓库存储路径。

对于仓库存储路径：

• 您必须至少有一个名为 default 的存储路径。
• 路径在键值对中定义。 除了 default，键可以是您选择的任何名称来命名文件路径。
• 目标目录及其任何子路径不得为符号链接。

• 没有目标目录可能是另一个目录的子目录。也就是说，没有嵌套。例如以下配置无效：

  default:
    path: /mnt/git-storage-1
  storage2:
    path: /mnt/git-storage-1/git-storage-2 # <- NOT OK because of nesting
  

配置备份

要使备份正常工作：

• 仓库存储路径不能是挂载点。
• GitLab 用户必须对路径的父目录具有正确的权限。

Linux 软件包会为您处理这些问题，但对于源代码安装，您应该格外小心。

在恢复备份时，/home/git/repositories 的当前内容被移动到 /home/git/repositories.old。如果 /home/git/repositories 是一个挂载点，那么 mv 会在挂载点之间移动东西，并且可能会出现问题。

理想情况下，/home/git 是挂载点，因此所有内容都保留在同一个挂载点内。Omnibus GitLab 安装保证了这一点，因为它们没有指定完整的仓库路径，而是指定父路径，但源安装没有。

示例配置

在下面的示例中，我们添加了两个额外的仓库存储路径，配置为两个额外的挂载点。

出于兼容性原因，gitlab.yml 的结构与 Omnibus GitLab 配置不同：

• 在 gitlab.yml 中，指定仓库的路径，例如 /home/git/repositories
• 在 Linux 软件包配置中，您可以指定 git_data_dirs，例如可以是 /home/git。然后 Omnibus GitLab 在该路径下创建一个 repositories 目录以与 gitlab.yml 一起使用。

源安装实例

1. 编辑 gitlab.yml 并添加存储路径：

   repositories:
     # Paths where repositories can be stored. Give the canonicalized absolute pathname.
     # NOTE: REPOS PATHS MUST NOT CONTAIN ANY SYMLINK!!!
     storages: # You must have at least a 'default' repository storage path.
       default:
         path: /home/git/repositories
       storage1:
         path: /mnt/storage1/repositories
       storage2:
         path: /mnt/storage2/repositories
   

2. 重启极狐GitLab 以使更改生效。

3. 配置新仓库的存储位置。

Linux 软件包安装实例

1. 通过将其余路径附加到默认路径来编辑 /etc/gitlab/gitlab.rb：

   git_data_dirs({
    "default" => { "path" => "/var/opt/gitlab/git-data" },
    "storage1" => { "path" => "/mnt/storage1/git-data" },
    "storage2" => { "path" => "/mnt/storage2/git-data" }
   })
   

2. 重启极狐GitLab 使更改生效。

3. 配置新仓库的存储位置。

配置新仓库的存储位置

配置多个仓库存储路径后，您可以选择存储新仓库的位置：

1. 在左侧边栏中，选择 搜索或转到。
2. 选择 管理中心。
3. 在左侧边栏中，选择 设置 > 仓库 并展开 仓库存储 部分。
4. 在 新仓库的存储节点 字段中输入值。
5. 选择 保存更改。

可以为每个仓库存储路径分配 0-100 的权重。创建新项目时，这些权重用于确定创建仓库的存储位置。

给定仓库存储路径相对于其他仓库存储路径的权重越高，选择它的频率就越高。公式为：(storage weight) / (sum of all weights) * 100 = chance %。

默认情况下，如果之前未配置仓库权重：

• default 的权重为 100。
• 所有其它存储的权重为 0。