Docker部署GitLab 14.x执行gitlab-rails dbconsole提示primary库未配置

原因说明 #

GitLab 14.x版本开始默认启用多数据库架构支持，哪怕仅使用单主库，database.yml的production配置也必须嵌套primary层级，老版本的扁平单库配置格式会导致rails识别不到主库配置，触发你遇到的报错。

修复步骤 #

• 第一步：调整database.yml配置结构
  将你当前production节点下的所有数据库配置，整体嵌套到production: primary子节点下，参考格式如下：

错误配置示例

production:
  adapter: postgresql
  database: gitlabhq_production
  host: /var/opt/gitlab/postgresql
  username: gitlab
  # 其余配置项

正确配置示例

production:
  primary:
    adapter: postgresql
    database: gitlabhq_production
    host: /var/opt/gitlab/postgresql
    username: gitlab
    # 其余配置项保持不变

• 第二步：重启GitLab容器让配置生效
  执行命令：
  docker restart <你的GitLab容器ID或名称>
• 第三步：验证命令可用性
  容器重启完成后重新进入容器，执行gitlab-rails dbconsole即可正常进入数据库控制台。

替代方案（跳过rails层直接操作数据库） #

如果不想修改配置重启服务，可直接通过postgres原生客户端操作：

1. 进入GitLab容器后切换到postgres用户
   su - gitlab-psql
2. 直接连接GitLab业务库
   psql -h /var/opt/gitlab/postgresql -d gitlabhq_production
3. 执行对应SQL即可完成Runner注册令牌重置，无需依赖gitlab-rails dbconsole命令。

内容的提问来源于stack exchange，提问作者Mikey007