GitLab外部コンテンツコネクタのクロール設定の構成

リリースバージョン: Australia

更新日 2026年03月12日

所要時間：8分

GitLab外部コンテンツコネクタでクロールするグループ、プロジェクト、およびリポジトリを指定します。クロールで取得し、インデックス作成のために AI 検索にフィードする問題、Wiki、マージ要求、タグ、ブランチ、コミットを選択します。

始める前に

コネクタアドミンは、クロール設定を構成するGitLab外部コンテンツコネクタを既に作成している必要があります。この手順の詳細については、「GitLab外部コンテンツコネクタの作成」を参照してください。

必要なロール：sn_ext_conn.xcc_admin

このタスクについて

このタスクはオプションです。既定では、 GitLab 外部コンテンツコネクタは、代理操作するように構成されている GitLab.comユーザーが所有する最上位グループにあるすべてのサブグループ、プロジェクト、リポジトリからコンテンツをクロールし、サポートされているすべてのコンテンツタイプ (問題、Wiki、マージ要求、タグ、ブランチ、コミット) をインデックス作成のために AI 検索に送信します。このタスクを実行する必要があるのは、コネクタで次のデフォルト以外の設定のいずれかを使用する場合のみです。

コンテンツクロールの実行時にクロールするサブグループの包含フィルターまたは除外フィルター
コンテンツクロールの実行時にクロールするプロジェクト/リポジトリの包含フィルターまたは除外フィルター
コンテンツのクロールの実行時にソースシステムから取得するコンテンツのタイプの包含フィルターまたは除外フィルター
コンテンツのクロールを実行するときにソースシステムから取得する分岐の包含フィルターまたは除外フィルター

コンテンツは、構成されたすべてのクロール設定フィルターに合格した場合にのみ、ソースシステムから取得されます。クロール設定フィルターでコンテンツアイテムが除外されている場合、外部コンテンツコネクタはコンテンツアイテムを取得しません。

重要:

デフォルトでは、各外部コンテンツコネクタは、ソースシステムから最大 1,000 万 (10,000,000) 個のコンテンツアイテムのインデックスを作成できます。コネクタは、この制限を超えると、ソースシステムのクロールを続行しますが、コンテンツアイテムの削除と更新のみをインデックス作成のために AI 検索に送信し、新しいコンテンツアイテムは無視します。コネクタは、インデックス作成制限を超えてクロールする 10,000 のコンテンツアイテムごとにエラーメッセージをログに記録します。

コネクタのインデックス付きコンテンツアイテムの数が 800,000 を超えると、インデックス作成の制限に近づいていることを示す警告メッセージがコネクタの UI に表示されます。コネクタがインデックス作成の制限に達すると、コネクタの UI にエラーメッセージが表示されます。

ユーザー権限クロールをサポートする外部コンテンツコネクタは、最大 50 万人のユーザーとそのグループの権限を処理できます。コネクタがこの制限を超えてユーザーを取得すると、コネクタの取得されたコンテンツにユーザー権限とグループの権限が正しく適用されない可能性があります。その結果、コンテンツが検索できなくなる可能性があります。

コネクタの 1 つがコンテンツインデックス作成の制限に達した場合は、そのクロール設定とファイルの包含/除外フィルターを更新して、取得するコンテンツアイテムの数を減らすことができます。または、10,000,000 を超えるコンテンツアイテムにインデックスを付けるためにコネクタが必要な場合は、https://support.servicenow.com/now でカスタマーサービス & サポートケースを作成して、コネクタの制限の引き上げを要求できます。

手順

移動先すべて > 外部コンテンツコネクタ > 外部コンテンツアドミンホーム.
[コネクタ] リストで、設定を変更する GitLab 外部コンテンツコネクタのレコードを選択します。
コネクタエディターの設定] タブで、[ [クロール設定] を選択します。
次のいずれかのグループフィルタリングオプションを選択します。
- コネクタの偽装された GitLab.com ユーザーアカウントが所有する最上位グループで見つかったすべてのサブグループをクロールするには、 [すべてのグループをクロールする] を選択します。
- コネクタの偽装された GitLab.com ユーザーアカウントが所有する最上位グループで見つかった特定のサブグループのセットのみをクロールするには、 [これらのグループのみを含める] を選択し、 [ 含めるグループ URL を追加する ] フィールドと [追加 ] ボタンを使用して、クロールに含めるグループの URL を入力します。
  
  たとえば、「 https://gitlab.com/example-dot-com/production 」と入力すると、 本番 サブグループとそれに含まれるすべてのサブグループの検索可能なコンテンツのみを含めることができます。
- コネクタの偽装された GitLab.com ユーザーアカウントが所有する最上位グループで見つかった特定のグループのセットを除くすべてのグループをクロールするには、 [これらのグループのみを除外する] を選択し、 [ 除外するグループ URL を追加する ] フィールドと [追加 ] ボタンを使用して、クロールから除外するグループの URL を入力します。
  
  たとえば、「 https://gitlab.com/example-dot-com/test-* 」と入力すると、名前が test- で始まるすべてのサブグループから検索可能なコンテンツを除外できます。
注:
サブグループ包含 URL はプレフィックスとして指定でき、URL の末尾にあるワイルドカード文字 * は任意の文字列と一致します。
次のいずれかのプロジェクト/リポジトリフィルタリングオプションを選択します。
- コネクタの偽装された GitLab.comユーザーアカウントが所有するすべてのプロジェクトとリポジトリをクロールするには、 [すべてのプロジェクト/リポジトリをクロールする] を選択します。
- コネクタの偽装された GitLab.com ユーザーアカウントが所有する特定のプロジェクトとリポジトリのセットのみをクロールするには、 [これらのプロジェクト/リポジトリのみを含める] を選択し、 [ 含めるプロジェクト/リポジトリ URL を追加する ] フィールドと [追加 ] ボタンを使用して、クロールに含めるプロジェクトとリポジトリの URL を入力します。
  注:
  プロジェクトとリポジトリの包含 URL はプレフィックスとして指定でき、URL の末尾にあるワイルドカード文字 * は任意の文字列と一致します。
  
  たとえば、 https://gitlab.com/example-dot-com/prod-* と入力すると、名前が prod- で始まるプロジェクトの検索可能なコンテンツのみを含めることができます。
- コネクタの偽装された GitLab.com ユーザーアカウントが所有するプロジェクトとリポジトリの指定したセットを除くすべてをクロールするには、 [これらのプロジェクト/リポジトリのみを除外する] を選択し、 [ 除外するプロジェクト/リポジトリ URL を追加する ] フィールドと [追加 ] ボタンを使用して、クロールから除外するプロジェクトとリポジトリの URL を入力します。
  注:
  プロジェクトおよびリポジトリの除外 URL はプレフィックスとして指定でき、URL の末尾にワイルドカード文字 * を付けて任意の文字列に一致させます。
  
  たとえば、confidential273 プロジェクトから検索可能なコンテンツを除外するには、「https://gitlab.com/example-dot-com/confidential273」と入力します。

コンテンツクロールの実行時に取得するコンテンツのタイプの [ クロールコンテンツタイプ ] オプションを有効にします。

GitLab外部コンテンツコネクタは、次のコンテンツタイプの検索可能なコンテンツのインデックス作成をサポートしています。


コンテンツタイプ	インデックス付き検索可能コンテンツ
問題	問題の説明
Wiki	HTML に変換されたマークダウンコンテンツ (添付ファイルなし)
結合要求	マージ要求の説明 (MarkDown) とディスカッション
タグ	タグメッセージ
分岐	ヘッドコミットのコミットメッセージ
コミット	メッセージをコミット

重要:

GitLab外部コンテンツコネクタは、次のコンテンツタイプの検索可能コンテンツのインデックス作成をサポートしていません。

コミット、問題、Wiki ディスカッション
差分をコミット
アーカイブされたグループまたはプロジェクトのコンテンツ
削除保留ステータスのグループまたはプロジェクトのコンテンツ
代理操作された GitLab.comユーザーが所有していないトップレベルグループのサブグループからのコンテンツ
問題または結合要求に添付されたファイルのコンテンツ
プレーンテキスト以外の形式の Wiki 添付ファイルのコンテンツ (.txt)
結合要求ディスカッションの内部または機密メモ
リポジトリファイル

ステップ 6 に [分岐] コンテンツタイプを含めた場合は、[ 正規表現形式で含める分岐を追加 ] フィールドと [追加 ] ボタンを使用して、コンテンツクロールに含める分岐の名前に一致する Java 正規表現パターンを指定します。
たとえば、名前が 2025 で始まる分岐を含めるには ^2025.*$ を指定し、すべての分岐をクロールするには ^.*$ を指定できます。Java 正規表現パターンの構文については、「java.regex.util.Pattern クラスの Javadoc」を参照してください。
注:
分岐名の式 ^main$ と ^master$ はデフォルトで含まれています。これらの分岐はリストから削除できません。
[保存して検証] を選択します。

タスクの結果

GitLab外部コンテンツコネクタは、変更したクロール設定で更新されます。

次のタスク

変更したクロール設定を使用して GitLab ソースシステムからコンテンツを取得するには、 GitLab 外部コンテンツコネクタの 1 回限りのコンテンツクロールを作成して実行します。1 回限りのコンテンツクロールの作成と実行については、「外部コンテンツコネクタのコンテンツクロールの作成」を参照してください。