環境変数

GitLabは特定の環境変数を公開しており、それを使ってデフォルト値を上書きすることができます。

通常、GitLabの設定は次のようにして行います:

  • /etc/gitlab/gitlab.rb Linux パッケージインストール用。
  • 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_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 に使用される初期登録トークンを設定します。
RAILS_ENV文字列です。Rails の環境。production,development,staging,test のいずれかを指定します。
GITLAB_RAILS_CACHE_DEFAULT_TTL_SECONDS整数。Rails-cacheに保存されたエントリに使用されるデフォルトのTTL。デフォルトは28800 。 15.3で導入されました
GITLAB_CI_CONFIG_FETCH_TIMEOUT_SECONDS整数。リモートのインクルードを解決するタイムアウトを秒単位で指定します。060 の間でなければなりません。デフォルトは30です。 15.11 で導入されました

変数の追加

変数を使ってより多くの設定ができるようにするマージリクエストを歓迎します。config/initializers/1_settings.rb ファイルに変更を加え、命名スキームGITLAB_#{name in 1_settings.rb in upper case} を使用してください。

Linux パッケージのインストール設定

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

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