GitLab Duo CLIの設定
- プラン: Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
GitLab Duo CLIの動作は、次の方法で変更できます:
- インタラクティブモードから、設定パネルで変更する方法。
- 設定パネルでの選択内容を保存する設定ファイルで変更する方法。ファイルを直接編集することもできます。
- システム管理者が設定を強制するためにデプロイする管理設定ファイルを使用する方法。
設定パネル
設定を変更するには:
- インタラクティブモードで
/settingsと入力し、Enterを押します。 - 矢印キーを使用して、設定のリスト内を移動します。
- 選択した設定を変更するには、EnterまたはSpaceを押します。
- パネルを閉じるには、Escapeを押します。
変更内容は、セッションをまたいで設定ファイルに保持されます。組織が設定を強制している場合、パネルには組織によって設定済みと表示され、変更できません。
次の設定を使用できます:
| 設定 | 説明 |
|---|---|
| Telemetry | GitLab Duoの改善に役立てるため、匿名の使用状況データを送信します。 |
| Notifications | システム通知(autoまたはdisabled)を制御します。 |
| Show work items on session start | 新しいセッションを開始するときに、未完了の作業アイテムを表示します。 |
| Run suggested prompts as /goal sessions | 提案されたプロンプトを、通常のチャットメッセージではなく/goalセッションとして実行します。変更を有効にするには再起動が必要です。 |
| Theme | テーマの設定を変更します。オプションには、auto、dark、light、dark high contrast、light high contrastがあります。 |
設定ファイル
GitLab Duo CLIは、/settingsパネルで変更した設定を設定ファイルに保存します。ファイルを直接編集することも、たとえばコンテナイメージ内で事前に作成することもできます。
GitLab Duo CLIは、起動時にファイルを読み込みます。ファイルに加えた変更は、次回GitLab Duo CLIを起動したときに適用されます。
ファイルの場所
ファイルの場所は、使用しているオペレーティングシステムによって異なります:
| オペレーティングシステム | パス |
|---|---|
| LinuxおよびmacOS | ~/.gitlab/duo/settings.json |
| Windows | %APPDATA%\GitLab\duo\settings.json |
XDG_CONFIG_HOMEを設定している場合、ファイルは$XDG_CONFIG_HOME/gitlab/duo/settings.jsonになります。
GitLab Duo CLIは、/settingsパネルで初めて設定を変更したときにファイルを作成します。
ファイル形式
ファイルにはJSONオブジェクトを含める必要があり、コメント(//および/* */)や末尾のカンマを含めることができます。/settingsパネルで設定を変更しても、GitLab Duo CLIはコメント、フォーマット、認識できないキーをそのまま保持します。
次の例では、すべての設定をデフォルト値に設定しています:
{
"telemetry": {
"enabled": true
},
"showWorkItemsInNewSessions": true,
"goalFlowInWelcomePrompts": true,
"notifications": {
"channel": "auto" // or "disabled"
},
"theme": "auto" // or "dark", "light", "dark-high-contrast", "light-high-contrast"
}無効なファイルと値
GitLab Duo CLIは、ファイルを修正するために削除または書き換えることはありません:
- ファイルが有効なJSONでない場合、GitLab Duo CLIはファイル全体を無視し、警告をログに記録します。
- 設定に無効な値が含まれている場合、GitLab Duo CLIはその設定を無視し、警告をログに記録します。
- GitLab Duo CLIが、たとえば新しいバージョンの設定など、認識できない設定がある場合、その設定は無視されます。
ファイルが読み取り専用の場合、/settingsパネルで行った変更は現在のセッションにのみ適用されます。
管理設定ファイル
設定を強制するために、システム管理者は各マシンに管理設定ファイルをデプロイします。たとえば、モバイルデバイス管理ツールやグループポリシーを使用できます。
管理設定ファイル内の設定は、コマンドラインオプション、環境変数、設定ファイル(設定パネルでユーザーが行った変更を含む)よりも優先されます。
強制された設定は、ユーザーが変更できません。ファイルにない設定は、引き続きユーザーが制御できます。
ファイルの場所
GitLab Duo CLIは、変更できない固定の場所からファイルを読み込みます:
| オペレーティングシステム | パス |
|---|---|
| Linuxおよびその他のオペレーティングシステム | /etc/gitlab/duo/settings.managed.json |
| macOS | /Library/Application Support/GitLab/duo/settings.managed.json |
| Windows | C:\Program Files\GitLab\duo\settings.managed.json |
書き込みアクセスをシステム管理者に制限し、他のすべてのユーザーには読み取り専用アクセスを付与します。
GitLab Duo CLIは、起動時にファイルを読み込みます。ファイルへの変更は、次回ユーザーがGitLab Duo CLIを起動したときに適用されます。
Windows Subsystem for Linux(WSL)では、GitLab Duo CLIはディストリビューション内のLinuxパスを読み込み、Windowsグループポリシーは適用されません。
ファイル形式
ファイルにはJSONオブジェクトを含める必要があり、コメント(//および/* */)や末尾のカンマを含めることができます。
次の例では、強制できるすべての設定を設定しています:
{
"telemetry": {
"enabled": false
},
"showWorkItemsInNewSessions": true,
"goalFlowInWelcomePrompts": true,
"notifications": {
"channel": "auto" // or "disabled"
},
}設定の優先順位
各設定について、GitLab Duo CLIは次の順序で最初に見つかった値を使用します:
- 組織が設定を強制している場合は、管理設定ファイル。
- 現在のセッションにのみ適用される、コマンドラインオプションと環境変数。
- 設定ファイル。
- デフォルト値。