{{< details >}}

  • Tier: 基础版,专业版,旗舰版
  • Offering: 私有化部署

{{< /details >}}

如果有需要,你可以通过 /etc/gitlab/gitlab.rb 设置自定义环境变量供 Puma、Sidekiq、Rails 和 Rake 使用。这在需要使用代理访问互联网并直接克隆外部托管的仓库到极狐GitLab 中时非常有用。在 /etc/gitlab/gitlab.rb 中提供一个 gitlab_rails['env'] 并设置为一个哈希值。例如:

gitlab_rails['env'] = {
    "http_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080",
    "https_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080"
#    "no_proxy" => ".yourdomain.com"  # 如果需要让你的内部域绕过代理,使用通配符语法。不要指定端口。
}

你也可以覆盖来自其他极狐GitLab 组件的环境变量,这可能是在你处于代理后面时所需要的:

# 需要代理 Git 克隆
gitaly['env'] = {
    "http_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080",
    "https_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080"
}

gitlab_workhorse['env'] = {
    "http_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080",
    "https_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080"
}

gitlab_pages['env'] = {
    "http_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080",
    "https_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080"
}

# 如果你使用 docker registry
registry['env'] = {
    "http_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080",
    "https_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080"
}

极狐GitLab 将尝试使用 HTTP 基本认证,当在代理 URL 中包含用户名和密码时。

代理设置使用 . 语法进行通配。

代理 URL 值通常应为 http://,除非你的代理有自己的 SSL 证书并启用了 SSL。这意味着,即使是 https_proxy 值,你通常也应指定为 http://<USERNAME>:<PASSWORD>@example.com:8080

{{< alert type=”note” >}}

当设置了 HTTP_PROXY 或 HTTPS_PROXY 环境变量,并且域名 DNS 无法解析时,DNS 重绑定保护被禁用。

{{< /alert >}}

应用更改

对环境变量所做的任何更改需要重新配置才能生效。

执行重新配置:

sudo gitlab-ctl reconfigure

故障排除

环境变量未被设置

检查你是否有多个相同 ['env'] 的条目。最后一个将覆盖之前的条目。在此示例中,NTP_HOST 将不会被设置:

gitlab_rails['env'] = { 'NTP_HOST' => "<DOMAIN_OF_NTP_SERVICE>" }

gitlab_rails['env'] = {
    "http_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080",
    "https_proxy" => "http://<USERNAME>:<PASSWORD>@example.com:8080"
}

错误:Connection reset by peer 在镜像仓库时

如果 no_proxy 值在 URL 中包含端口号,可能会导致 DNS 解析失败。删除 no_proxy URL 中的任何端口号以解决此问题。