設定ファイルの設定の変更

一部のGitLab機能は、gitlab.ymlを使用してカスタマイズできます。Linuxパッケージのインストールでgitlab.yml設定を変更する場合は、/etc/gitlab/gitlab.rbで変更する必要があります。翻訳は次のように機能します。利用可能なオプションの完全なリストについては、gitlab.rb.templateを参照してください。

/etc/gitlab/gitlab.rbにリストされているテンプレートのすべてのオプションは、デフォルトで使用できます。

gitlab.ymlには、次のような構造があります:

production: &base
  gitlab:
    default_theme: 2

gitlab.rbでは、これは次のように変換されます:

gitlab_rails['gitlab_default_theme'] = 2

ここで何が起こるかというと、production: &baseを無視し、gitlab:とdefault_theme:をgitlab_default_themeに結合します。すべてのgitlab.yml設定をgitlab.rb経由で変更できるわけではありません。gitlab.yml.erbテンプレートを参照してください。属性が見つからない場合は、omnibus-gitlabリポジトリでマージリクエストを作成してください。

sudo gitlab-ctl reconfigureを実行して、gitlab.rbの変更を有効にします。

生成されたファイルを/var/opt/gitlab/gitlab-rails/etc/gitlab.ymlで編集しないでください。次のgitlab-ctl reconfigureの実行時に上書きされるためです。

新しい設定をgitlab.ymlに追加する

まず、gitlab.ymlへの設定の追加を見送ることを検討してください。設定については、GitLab固有の考慮事項を参照してください。

新しい設定を追加するときは、次の5つのファイルを更新することを忘れないでください:

• /etc/gitlab/gitlab.rbを介してエンドユーザーに設定を公開するためのgitlab.rb.templateファイル。
• 新しい設定に対して適切なデフォルトを提供するためのdefault.rbファイル。
• gitlab.rbからの設定の値を実際に使用するためのgitlab.yml.exampleファイル。
• gitlab.yml.erbファイル
• gitlab-rails_spec.rbファイル