GitLab Docker部署时GITLAB_OMNIBUS_CONFIG环境变量不生效如何解决？

• 第一步进入GitLab Pod，直接查看环境变量是否完整传递：
  执行命令 kubectl exec -it <gitlab-pod名称> -n <对应命名空间> -- env | grep GITLAB_OMNIBUS_CONFIG
  对比输出的变量值和你配置的内容是否完全一致，有没有出现截断、转义错误的情况。
• 第二步查看生成的omnibus配置文件：
  进入容器后执行 cat /etc/gitlab/gitlab.rb | grep "display_initial_root_password"，确认你配置的参数是否已经被写入到生效的配置文件中。
• 第三步测试其他配置项的生效状态：
  比如验证时区配置，执行 gitlab-rails runner "puts Time.zone"，如果输出为GMT则说明环境变量中的配置已生效；也可以查看puma进程数，执行 ps aux | grep puma | grep -v grep | wc -l，如果进程数为1（worker_processes设为0表示只有主进程）则说明配置生效。

如果你首次启动就出现以下日志：

password: *** - You opted not to display initial root password to STDOUT.
说明要么是环境变量没有正确传递，要么是变量值存在语法错误，导致omnibus没有读取到该配置项，可通过上述方法逐一排查。

• 首先注意gitlab_rails['display_initial_root_password'] = true这个参数仅在GitLab第一次初始化启动时生效，如果你已经完成过初始化流程，后续再添加该参数不会生效，属于正常现象。你可以直接进入容器查看初始密码：cat /etc/gitlab/initial_root_password，该文件默认会保留24小时。
• 在Rancher 2.6的部署配置中，确认GITLAB_OMNIBUS_CONFIG环境变量是配置在工作负载的「容器环境变量」栏位，键名大小写完全正确，值没有被Rancher自动转义。如果变量内容过长，建议通过ConfigMap挂载的方式传递，避免值截断。
• 必须为GitLab的/etc/gitlab、/var/log/gitlab、/var/opt/gitlab三个目录配置持久化存储，否则容器重启后所有配置都会被重置。
• 每次修改配置后，需要在容器内执行 gitlab-ctl reconfigure 触发配置重载，配置会自动保存到持久化的gitlab.rb文件中，后续重启不会丢失。

该部署组合本身不会导致环境变量不生效，常见的配置失效原因集中在以下几点：

• Rancher配置环境变量时，特殊字符自动转义导致变量值被截断，比如配置中的单引号、大括号被转义后，整个GITLAB_OMNIBUS_CONFIG的内容不完整。
• 部署时额外挂载了ConfigMap/Secret直接覆盖/etc/gitlab/gitlab.rb文件，该文件的优先级高于GITLAB_OMNIBUS_CONFIG环境变量，会导致环境变量配置被覆盖。
• K3s的持久化存储配置错误，/etc/gitlab目录没有被持久化，每次重启Pod都会重新生成默认配置。

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