环境变量

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

极狐GitLab 暴露了某些环境变量，可以用来覆盖它们的默认值。

人们通常通过以下方式配置极狐GitLab：

对于 Linux 软件包安装，使用 /etc/gitlab/gitlab.rb。
对于自编译安装，使用 gitlab.yml。

您可以使用以下环境变量来覆盖某些值：

支持的环境变量#

变量	类型	描述
DATABASE_URL	string	数据库 URL；格式为：postgresql://localhost/blog_development。
ENABLE_BOOTSNAP	string	切换 Bootsnap 以加速初始 Rails 启动。默认情况下为非生产环境启用。设置为 0 以禁用。
EXTERNAL_URL	string	在安装时指定外部 URL。
EXTERNAL_VALIDATION_SERVICE_TIMEOUT	integer	外部 CI/CD 流水线验证服务的超时时间，以秒为单位。默认值为 5。
EXTERNAL_VALIDATION_SERVICE_URL	string	外部 CI/CD 流水线验证服务的 URL。
EXTERNAL_VALIDATION_SERVICE_TOKEN	string	用于与外部 CI/CD 流水线验证服务进行身份验证的 X-Gitlab-Token。
GITLAB_CDN_HOST	string	设置用于提供静态资产的 CDN 的基本 URL（例如，https://mycdnsubdomain.fictional-cdn.com）。
GITLAB_EMAIL_DISPLAY_NAME	string	在极狐GitLab 发送的电子邮件中发件人字段使用的名称。
GITLAB_EMAIL_FROM	string	在极狐GitLab 发送的电子邮件中发件人字段使用的电子邮件地址。
GITLAB_EMAIL_REPLY_TO	string	在极狐GitLab 发送的电子邮件中回复至字段使用的电子邮件地址。
GITLAB_EMAIL_SUBJECT_SUFFIX	string	在极狐GitLab 发送的电子邮件中使用的电子邮件主题后缀。
GITLAB_HOST	string	极狐GitLab 服务器的完整 URL（包括 http:// 或 https://）。
GITLAB_MARKUP_TIMEOUT	string	由 gitlab-markup gem 执行的 rest2html 和 pod2html 命令的超时时间，以秒为单位。默认值为 10。
GITLAB_ROOT_PASSWORD	string	在安装时设置 root 用户的密码。
GITLAB_SHARED_RUNNERS_REGISTRATION_TOKEN	string	设置用于 runners 的初始注册令牌。在极狐GitLab 16.11 中弃用。
RAILS_ENV	string	Rails 环境；可以是 production、development、staging 或 test 中的一个。
GITLAB_RAILS_CACHE_DEFAULT_TTL_SECONDS	integer	用于存储在 Rails 缓存中的条目的默认 TTL。默认值为 28800。在 15.3 中引入。
GITLAB_CI_CONFIG_FETCH_TIMEOUT_SECONDS	integer	解析 CI 配置中的远程包含的超时时间，以秒为单位。必须介于 0 和 60 之间。默认值为 30。在 15.11 中引入。
GITLAB_DISABLE_MARKDOWN_TIMEOUT	string	如果设置为 true、1 或 yes，后端的 Markdown 渲染不会超时。默认值为 false。在 17.4 中引入。
GITLAB_LFS_LINK_BATCH_SIZE	integer	设置链接 LFS 文件的批处理大小。默认值为 1000。
GITLAB_LFS_MAX_OID_TO_FETCH	integer	设置要链接的 LFS 对象的最大数量。默认值为 100,000。
SIDEKIQ_SEMI_RELIABLE_FETCH_TIMEOUT	integer	设置 Sidekiq 半可靠获取的超时时间。默认值为 5。在极狐GitLab 16.7 之前，默认值为 3。如果您在极狐GitLab 16.6 及更早版本上遇到 Redis CPU 消耗过高，或者您已自定义此变量，您应将此变量更新为 5。
SSL_IGNORE_UNEXPECTED_EOF	string	OpenSSL 3.0 要求服务器在关闭 SSL 连接之前发送 close_notify。设置此项为 true 将禁用此功能。默认值为 false。

添加更多变量#

我们欢迎合并请求，通过使用变量使更多设置可配置。请修改 config/initializers/1_settings.rb 文件，并使用命名方案 GITLAB_#{1_settings.rb 中的大写名称}。

Linux 软件包安装配置#

要设置环境变量，请按照这些说明进行操作。

可以通过在 docker run 命令中添加环境变量 GITLAB_OMNIBUS_CONFIG 来预先配置极狐GitLab Docker 镜像。有关详细信息，请参阅预先配置 Docker 容器。