GitLab CE升级报错：gitaly['gitconfig']已移除，求解决方法

算力阿峰

2026-7-15

解决GitLab CE升级时gitaly['gitconfig']弃用报错的方案

这个报错是因为GitLab 16.0版本彻底移除了gitaly['gitconfig']配置项，需要将原有配置迁移到新的Gitaly配置结构中，具体操作步骤如下：

先备份GitLab配置文件，避免配置丢失：

sudo cp /etc/gitlab/gitlab.rb /etc/gitlab/gitlab.rb.bak

编辑GitLab主配置文件：
```
sudo nano /etc/gitlab/gitlab.rb
```
找到文件中旧的gitaly['gitconfig']配置块（类似下面的格式）：
gitaly['gitconfig'] = {
"user.name" => "GitLab",
"user.email" => "gitlab@example.com"
}
将其替换为新的配置结构，所有Git相关配置需要放到gitaly['configuration']下的git.config数组中：
```
gitaly['configuration'] = {
  git: {
    config: [
      { key: "user.name", value: "GitLab" },
      { key: "user.email", value: "gitlab@example.com" }
    ]
  }
}
```
若原有gitaly['configuration']已存在其他配置，只需将git.config部分合并进去，不要重复定义gitaly['configuration']。
重新加载GitLab配置：
```
sudo gitlab-ctl reconfigure
```
再次执行升级命令：
```
sudo apt install gitlab-ce=16.1.2-ce.0
```