正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

環境変数

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab Self-Managed

GitLabは、環境変数を公開しており、それらを使用してデフォルト値をオーバーライドできます。

通常、GitLabの設定は、以下で行います:

  • Linuxパッケージインストールの場合: /etc/gitlab/gitlab.rb。
  • 自己コンパイルによるインストールの場合: gitlab.yml。

以下の環境変数を使用して、特定の値をオーバーライドできます:

サポートされている環境変数

変数種類説明
DATABASE_URL文字列データベースURLはpostgresql://localhost/blog_developmentの形式です。
ENABLE_BOOTSNAP文字列最初のRailsの起動を高速化するためのBootsnapを切替ます。本番環境以外の環境では、デフォルトで有効です。無効にするには0に設定します。
EXTERNAL_URL文字列インストール時に外部URLを指定します。
EXTERNAL_VALIDATION_SERVICE_TIMEOUT整数外部CI/CDパイプライン検証サービスに対するタイムアウト（秒単位）。デフォルトは5です。
EXTERNAL_VALIDATION_SERVICE_URL文字列外部CI/CDパイプライン検証サービスへのURL。
EXTERNAL_VALIDATION_SERVICE_TOKEN文字列外部CI/CDパイプライン検証サービスで認証するためのX-Gitlab-Token。
GITLAB_CDN_HOST文字列静的アセットを提供するCDNのベースURLを設定します（例: https://mycdnsubdomain.fictional-cdn.com）。
GITLAB_EMAIL_DISPLAY_NAME文字列GitLabから送信されるメールのFromフィールドで使用される名前。
GITLAB_EMAIL_FROM文字列GitLabから送信されるメールのFromフィールドで使用されるメールアドレス。
GITLAB_EMAIL_REPLY_TO文字列GitLabから送信されるメールのReply-Toフィールドで使用されるメールアドレス。
GITLAB_EMAIL_SUBJECT_PREFIX文字列GitLabから送信されるメールで使われる件名のプレフィックス。
GITLAB_EMAIL_SUBJECT_SUFFIX文字列GitLabから送信されるメールで使われる件名のサフィックス。
GITLAB_HOST文字列GitLabサーバーの完全なURL（http://またはhttps://を含む）。
GITLAB_MARKUP_TIMEOUT文字列gitlab-markup gemによって実行されるrest2htmlコマンドとpod2htmlコマンドのタイムアウト（秒単位）。デフォルトは10です。
GITLAB_ROOT_PASSWORD文字列インストール時にrootユーザーのパスワードを設定します。
GITLAB_SHARED_RUNNERS_REGISTRATION_TOKEN文字列Runnerで使用される初期の登録トークンを設定します。GitLab 16.11で非推奨になりました。
RAILS_ENV文字列Railsの環境。production、development、staging、またはtestのいずれかを指定できます。
GITLAB_RAILS_CACHE_DEFAULT_TTL_SECONDS整数Rails-キャッシュに保存されたエントリに使用されるデフォルトのTTL。デフォルトは28800です。15.3で導入。
GITLAB_CI_CONFIG_FETCH_TIMEOUT_SECONDS整数リモートインクルードをCI設定で解決するためのタイムアウト（秒単位）。0から60の間にする必要があります。デフォルトは30です。15.11で導入。
GITLAB_CI_MAX_COMMIT_MESSAGE_SIZE_IN_BYTES整数CI Runnerに送信できる最大コミットメッセージサイズ（バイト単位）。0から1000000の間にする必要があります。デフォルトは100000です。18.6で導入。
GITLAB_DISABLE_MARKDOWN_TIMEOUT文字列true、1、またはyesに設定すると、バックエンドでのMarkdownのレンダリングはタイムアウトしません。デフォルトはfalseです。GitLab 17.4で導入されました。
GITLAB_LFS_LINK_BATCH_SIZE整数LFSファイルをリンクするためのバッチサイズを設定します。デフォルトは1000です。
GITLAB_LFS_MAX_OID_TO_FETCH整数リンクするLFSオブジェクトの最大数を設定します。デフォルトは100000です。
SIDEKIQ_SEMI_RELIABLE_FETCH_TIMEOUT整数Sidekiqのセミ信頼性フェッチのタイムアウトを設定します。デフォルトは5です。GitLab 16.7以前は、デフォルトは3でした。GitLab 16.6以前で高いRedis CPU消費が発生する場合、またはこの変数をカスタマイズしている場合は、この変数を5に更新する必要があります。
SSL_IGNORE_UNEXPECTED_EOF文字列OpenSSL 3.0では、SSL接続をシャットダウンする前に、サーバーがclose_notifyアラートを送信する必要があります。デフォルトはfalseです。この変数をtrueに設定すると、アラートは無効になります。詳細については、OpenSSLドキュメントを参照してください。

追加の変数

変数を使用してより多くの設定を設定可能にするマージリクエストを歓迎します。config/initializers/1_settings.rbファイルに変更を加え、GITLAB_#{name in 1_settings.rb in upper case}の命名規則を使用します。

Linuxパッケージの設定

環境変数を設定するには、これらの手順に従ってください。

GitLab Dockerイメージは、GITLAB_OMNIBUS_CONFIG環境変数をdocker runコマンドに追加することで事前設定できます。詳細については、Dockerコンテナの事前設定を参照してください。