GitLab の統合

個人アクセストークン

これらのトークンは、GitLab アカウントに付与されたアクセスに基づいて、YouTrack にリポジトリへのアクセスを付与します。一般に、統合に個人トークンを使用することはお勧めしません。これは、プロジェクトへの関与が時間の経過とともに変化する可能性がある 1 人の個人に属するアカウントに統合が結び付けられるためです。

プロジェクトアクセストークン

これらのトークンは、範囲がプロジェクト自体に制限されているリポジトリへの YouTrack アクセスを許可します。これは特定のユーザーアカウントに関連付けられていないため、一般に個人トークンよりも優れていると考えられています。

グループアクセストークン

これらのトークンは、GitLab の特定のグループまたは組織内のリソースへのアクセスを提供し、複数のプロジェクトに取り組むチームに役立ちます。

URL

この設定は、GitLab リポジトリへのパスを識別できます。GitLab CE または EE サーバーのリポジトリが https://host:port/context_path で利用可能な場合、YouTrack はこのコンテキストパスがどこで終わり、リポジトリへの実際のパスが始まるかを判断できません。

この課題を解決するには、GitLab サーバーのベース URL と、リポジトリを指すコンテキストパスを入力します。例: https://host:port/context_path

SSL キー

サーバー環境がクライアント SSL 認証を要求するように設定されている場合は、YouTrack サーバーの秘密鍵を含むキーストアを選択します。このキーは、GitLab との接続を確立しようとするときに YouTrack サーバーを識別します。この設定は、内部ネットワークへの接続に必要な HTTPS 認証をサポートするためにのみ使用されます。

リストには、YouTrack にすでにインポートされている SSL キーのみが表示されます。キーストアファイルを生成して YouTrack にアップロードする方法については、SSL キーを参照してください。

リポジトリ

統合バージョン管理システムのリポジトリへのパスを表示します。

必要に応じて、統合を設定した後にリポジトリの場所を編集できます。手順については、リポジトリ設定の編集を参照してください。

メイン YouTrack プロジェクト

VCS 統合がアクティブなプライマリプロジェクトを設定します。

追加プロジェクト

リンクされたリポジトリを 1 つ以上の追加プロジェクトと統合します。

コミット者

コミットメッセージ内のコマンドに関する課題を、指定されたグループのメンバーに更新する機能を制限します。選択したグループのメンバーではないユーザーからの VCS の変更は、関連する課題にまだ関連付けられていますが、コミットで指定されているコマンドはすべて無視されます。

VCS 変更の処理スキーム

コミットメッセージが課題 ID を参照する場合に、VCS の変更を処理する方法を選択します。次のオプションがサポートされています。

• コミットを追加し、コマンドを無視する : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。コミットメッセージ内のコマンドはすべて無視されます。

• すべてのプロジェクトにコミットを追加し、メインにコマンドを適用します : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。現在選択されているメインプロジェクトに属する課題にのみコマンドを適用します。

• コミットを追加し、すべてのプロジェクトにコマンドを適用します : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。コミットメッセージにコマンドが含まれている場合、統合プロジェクトの課題を更新します。

監視対象のブランチ

変更をモニターしたいブランチの名前を保管します。

• + を使用してブランチを含めます。

• ブランチを除外するには、- を使用します。

• branch name の場合は、ブランチの完全修飾名を使用してください。例: refs/heads/<branch name>

• ワイルドカードとして * を使用してください。このプレースホルダは、文字列内の 1 つ以上の文字と一致します。例: すべての機能ブランチを含めるには、次のように使用します。

  +:refs/heads/feature/*

  ブランチパターンごとにワイルドカード文字を 1 つだけ使用できます。複数のアスタリスク文字を含むパターンを指定した場合、最初のアスタリスク文字のみがワイルドカードとして評価されます。

• すべてのブランチを監視するには、入力フィールドを空のままにします。

リポジトリに接続したときにリポジトリ URL として入力したアドレスが特定のブランチを指している場合、このブランチは、接続のセットアップ時に監視対象のブランチのリストに自動的に追加されます。

課題コメントに対するコミットを解析します

有効にすると、コミットメッセージ内の特定のテキスト行がコメントとして課題にコピーされます。コミットメッセージの一部をコメントとして課題にコピーすると、@mention 通知をトリガーし、VCS の変更にアクセスできないユーザーに情報を公開できます。

この設定は、コミットメッセージが VCS の変更にどのように表示されるかには影響しません。コマンドや課題のコメントを含むコミットメッセージ全体は、アクティビティストリームの VCS 変更レコードの一部として常に表示されます。

次の場合にのみこのオプションを有効にしてください。

• コミットメッセージで他のユーザーにメンションし、テキストが issue のコメントにコピーされたときに通知を生成します。

• VCS の変更の可視性を制限し、コミット関連の情報をコメントとして外部ユーザーに見えるようにします。

YouTrack がメッセージをコミットする方法の詳細については、VCS コミットでのコマンドの適用を参照してください。

課題の参照については、ブランチ名を確認してください

有効にすると、統合は、コミットおよびプルリクエストのブランチ名で課題への参照をチェックします。このオプションは、チケットごとのブランチプロセスを使用するチーム向けに追加されたため、開発者はコミットメッセージで課題 ID を明示的にメンションする必要がありません。

VCS 変更の表示対象

VCS 変更の可視性を YouTrack 内の 1 つ以上のユーザーグループに制限します。制限されていない場合、VCS の変更点のリストは、課題を読む権限を持つすべてのユーザーに表示されます。

使用不可

統合プロジェクトと VCS リポジトリ間の接続を遮断します。設定は変更されず、いつでも有効にできます。

編集

選択したプロジェクトとリポジトリのサイドバーにある統合設定ダイアログを開きます。

削除

YouTrack から統合プロジェクトの設定を削除します。

このアクションにより、リンクされたリポジトリのコミットの課題に追加されたすべての VCS の変更も削除されます。

アクション自体を元に戻すことはできませんが、インポートアクションを使用して、誤って削除された VCS の変更を復元できます。

コミットのインポートとプルリクエストのオープン

リンクされたリポジトリのコミット履歴を確認し、コミットメッセージで参照されている課題に VCS の変更を追加します。このオプションは、現在有効になっている統合でのみ使用できます。

このアクションを使用して、統合が誤って削除されたときに削除された VCS の変更を復元したり、新しいプロジェクトの課題へのリンクを移行したりできます。

統合 VCS の Web フックが存在しない、無効になっている、その他の不正な形式です。

VCS リポジトリの設定で Web フックを確認してください。Web フックが存在し、それらが有効になっていることを確認してください。

Web フックに課題があると思われる場合は、VCS の設定で Web フックを削除するか無効にして、YouTrack に新しい VCS 統合を設定してください。

リポジトリへの変更をコミットしたユーザーは、統合設定のコミット者グループのメンバーではありません。

YouTrack で指定されたグループにコミッターを追加するか、統合設定で選択を変更してください。

リポジトリへの変更をコミットしたユーザーには、接続プロジェクトの課題を更新する権限がありません。

これらのユーザーをプロジェクトチームに追加するか、読み取り課題権限と更新の課題権限を含むプロジェクト内のロールを割り当てます。

YouTrack は、コミットメッセージの作成者と一致するユーザーアカウントを見つけることができません。

ユーザーは、YouTrack と GitLab の両方のアカウントに同じメールアドレスを使用するか、GitLab プロファイルに名前として保存されている値を Hub アカウントの VCS ユーザー名のリストに追加する必要があります。

詳しくは、変更作成者と YouTrack ユーザーの一致を参照してください。

個人アクセストークンが GitLab での認証に使用されるユーザーは、GitLab のプロジェクトにアクセスできません。

GitLab プロジェクトのメンバー設定にアクセスし、このユーザーをプロジェクトに追加します。このユーザーがメンバーになっているグループとプロジェクトを共有することもできます。

このユーザーは特定のアクセスレベルを必要としません — ゲストアクセスで十分です。

外部サービスは利用できません。

GitLab サーバーが実行されていることを確認します。

接続がファイアウォールによってブロックされています。

YouTrack および GitLab サーバーが使用するファイアウォールのポートを開きます。

外部サービスへの接続がプロキシサーバーによってブロックされています。

間違ったポートで接続しようとしています。

YouTrack がプロキシサーバーを介して他のサービスに接続できるように、サーバーのシステムプロパティを設定します。手順については、プロキシ設定を参照してください。

GitLab サーバーには安全な接続が必要です。

GitLab サーバーの証明書を YouTrack にインポートします。手順については、SSL 証明書を参照してください。

GitLab サーバーの SSL 証明書の有効期限が切れています。

更新した証明書を更新して YouTrack にインポートします。手順については、SSL 証明書を参照してください。

YouTrack サーバーのベース URL は、デフォルト以外のポートを使用します。例: your.host:8080

GitLab サーバーの管理領域> 設定メニューを開き、ページのアウトバウンドリクエストセクションでフックとサービスからローカルネットワークへの要求を許可するを有効にします。

YouTrack サーバーのベース URL は、localhost またはローカルサブネット IP アドレスを使用するように設定されています。この場合、GitLab は Webhook を作成するリクエストの受け入れを拒否します。

この場合の最適なソリューションは、YouTrack インストールのベース URL を更新して、適切な Web アドレスを使用します。

または、Java 開始パラメーター -Djetbrains.youtrack.webHooksBaseUrl=<base URL> を使用して、Webhook の作成に使用される URL を指定できます。このパラメーターを使用すると、サーバーのベース URL を更新する必要がありません。代わりに、外部サービスで Webhook を作成するリクエストは、指定された代替ベース URL を使用します。YouTrack インストールの JVM オプションを設定する方法については、永続的に JVM オプションを更新するを参照してください。