Omnibus GitLab設定オプションの追加と削除

設定オプションの追加

設定オプションの追加は、どのリリースのマイルストーンでも発生する可能性があります。

  • 管理者向けのドキュメントとしてfiles/gitlab-config-template/gitlab.rb.template にエントリを追加してください。
  • 新しいオプションのデフォルト値を追加します：
    • サービスに固有の値は、適切なfiles/gitlab-cookbooks/SERVICE_NAME/attributes/default.rb
    • 一般的な値はfiles/gitlab-cookbooks/gitlab/attributes/default.rb
  • 実行時に計算が必要な値の場合は、関連するクックブック](new-services.md#additional-configuration-parsing-for-the-service)の[定義parse_variables メソッドに追加する必要があります。
  • オプションを公開属性に追加するかどうかを検討してください。

設定オプションの削除

ディストリビューションでは、Omnibus GitLab管理者の混乱を最小限に抑えるため、設定オプションを削除する際には厳格なプロセスに従います。

  1. 設定オプションを廃止するためのイシューを作成してください。
  2. 非推奨メッセージを追加してから3マイルストーン以上経過した時点で、設定オプションを削除するためのイシューを作成してください。

オプションの非推奨化

  • 非推奨メッセージを追加
  • files/gitlab-config-template/gitlab.rb.template から設定オプションを削除し、新規インストールで使用できないようにしました。

オプションの最終的な削除

  • 非推奨オプションのデフォルト値をfiles/gitlab-cookbooks/gitlab/attributes/default.rb から削除します。