プロジェクトインテグレーション

外部アプリケーションとマージして、GitLabに機能を追加できます。

以下のインテグレーションを表示および管理できます:

• インスタンス（GitLab Self-Managed）
• グループ

以下を使用できます:

• プロジェクトインテグレーションのインスタンスまたはグループのデフォルト設定
• プロジェクトまたはグループのインテグレーションのカスタム設定

プロジェクトインテグレーションのグループデフォルト設定を管理する

前提要件:

• グループのオーナーロールを持っている必要があります。

プロジェクトインテグレーションのグループデフォルト設定を管理するには、次のようにします:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
2. 設定 > インテグレーションを選択します。
3. インテグレーションを選択します。
4. フィールドに入力します。
5. 変更を保存を選択します。

グループ設定を初めてインテグレーションに設定する場合:

• グループ設定でインテグレーションを有効にする切替がオンになっている場合、このインテグレーションがまだ構成されていないグループに属するすべてのサブグループおよびプロジェクトに対して、インテグレーションが有効になります。
• すでにインテグレーションが構成されているサブグループとプロジェクトは影響を受けませんが、いつでも継承された設定を使用するように選択できます。

グループデフォルトをさらに変更すると:

• デフォルト設定を使用するようにインテグレーションが設定されているグループに属するすべてのサブグループおよびプロジェクトに即座に適用されます。
• 最後にインテグレーションのデフォルトを保存した後に作成されたものであっても、新しいサブグループとプロジェクトにすぐに適用されます。グループデフォルト設定でインテグレーションを有効にする切替がオンになっている場合、そのようなサブグループとプロジェクトすべてに対して、インテグレーションが自動的に有効になります。
• インテグレーションに選択されたカスタム設定を持つサブグループとプロジェクトはすぐに影響を受けることはなく、いつでも最新のデフォルトを使用するように選択できます。

インスタンス設定が同じインテグレーションに構成されている場合、グループ内のプロジェクトはグループから設定を継承します。

インテグレーションの全体的な設定のみを継承できます。フィールドごとの継承は、エピック2137で提案されています。

グループデフォルト設定を削除する

前提要件:

• グループのオーナーロールを持っている必要があります。

グループデフォルト設定を削除するには、次のようにします:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
2. 設定 > インテグレーションを選択します。
3. インテグレーションを選択します。
4. リセットを選択して確定します。

グループデフォルト設定をリセットすると、デフォルト設定を使用し、グループのプロジェクトまたはサブグループに属するインテグレーションが削除されます。

プロジェクトインテグレーションにインスタンスまたはグループのデフォルト設定を使用する

前提要件:

• プロジェクトのメンテナー以上のロールを持っている必要があります。

プロジェクトインテグレーションにインスタンスまたはグループのデフォルト設定を使用するには、次のようにします:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > インテグレーションを選択します。
3. インテグレーションを選択します。
4. 右側のドロップダウンリストから、デフォルトの設定を使用を選択します。
5. インテグレーションを有効にするで、有効チェックボックスがオンになっていることを確認します。
6. フィールドに入力します。
7. 変更を保存を選択します。

プロジェクトまたはグループのインテグレーションにカスタム設定を使用する

前提要件:

• プロジェクトインテグレーションのメンテナー以上のロールを持っている必要があります。
• グループインテグレーションのオーナーロールが必要です。

プロジェクトまたはグループのインテグレーションにカスタム設定を使用するには、次のようにします:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトまたはグループを見つけます。
2. 設定 > インテグレーションを選択します。
3. インテグレーションを選択します。
4. 右側のドロップダウンリストから、カスタムの設定を使用を選択します。
5. インテグレーションを有効にするで、有効チェックボックスがオンになっていることを確認します。
6. フィールドに入力します。
7. 変更を保存を選択します。

利用可能なインテグレーション

GitLabインスタンスでは、以下のインテグレーションが利用可能な場合があります。インスタンス管理者がインテグレーション許可リストを構成している場合、それらのインテグレーションのみが利用可能です。

CI/CD

イベント通知

ストア

外部イシュートラッカー

以下のインテグレーションにより、プロジェクトの左側のサイドバーに外部イシュートラッカーへのリンクが追加されます。

外部Wiki

以下のインテグレーションにより、プロジェクトの左側のサイドバーに外部Wikiへのリンクが追加されます。

その他

プロジェクトWebhook

一部のインテグレーションは、外部アプリケーションにWebhookを使用します。

プッシュ、イシュー、またはマージリクエストなどの特定のイベントをリッスンするようにプロジェクトWebhookを構成できます。Webhookがトリガーされると、GitLabは指定されたWebhook URLにデータを含むPOSTリクエストを送信します。

Webhookを使用するインテグレーションのリストについては、利用可能なインテグレーションを参照してください。

プッシュフック制限

単一のプッシュに3つ以上のブランチまたはタグへの変更が含まれている場合、push_hooksイベントとtag_push_hooksイベントでサポートされているインテグレーションは実行されません。

サポートされているブランチまたはタグの数を変更するには、push_event_hooks_limit設定を構成します。

SSL検証

デフォルトでは、送信HTTPリクエストのSSL証明書は、認証局の内部リストに基づいて検証されます。SSL証明書は自己署名できません。

Webhookと一部のインテグレーションを構成するときに、SSL検証を無効にできます。

関連トピック

• インテグレーションAPI
• GitLabデベロッパーポータル