YouTrack サーバー 2024.2 ヘルプ

汎用 VCS 統合

このページの指示に従って、バージョン管理ホストシステム上の VCS リポジトリと統合します。

汎用 VCS 統合により、YouTrack の課題にコミットを手動で添付したり、Webhook を使用してプログラムでリンクを追加したりできます。

前提条件

YouTrack はインバウンド接続にアクセス可能です。具体的には、ネットワークが VCS サーバーと YouTrack の間の接続をブロックしていないことを確認する必要があります。

VCS 統合を構成する

次に、YouTrack のプロジェクトと VCS のリポジトリ間の接続を確立する必要があります。VCS に接続するには、リポジトリ URL が必要です。

VCS リポジトリに接続するには:

  1. YouTrack で 管理> 統合> VCS 統合ページを開きます。

  2. 新しい VCS 統合ボタンをクリックしてください。

    • 新しい VCS 統合ダイアログが開きます。

  3. メイン YouTrack プロジェクトリストから、VCS リポジトリと統合するプライマリプロジェクトの名前を選択します。リポジトリへの接続を設定した後で、追加の YouTrack プロジェクトとの統合を追加できます。

  4. サーバータイプの場合は、汎用を選択します。

    VCS integration settings
  5. VCS リポジトリを指す URL をリポジトリ URL 入力フィールドに入力または貼り付けます。コミットハッシュの変数として $hash$ を挿入できます。

    • サンプル: https://<servername.com>/<user>/<repositoryname>/commit/$hash$

    VCS integration settings
  6. 保存ボタンをクリックしてください。

    • YouTrack プロジェクトは、VCS ホストから入力されたリポジトリと統合されます。

    • プロジェクト内の課題を参照するコミットを VCS リポジトリから手動で入力できるようになりました。コミットリンクは、参照された課題のアクティビティストリームに表示されます。

    • サイドバーには、VCS 統合を設定するための追加設定が表示されます。

      VCS integration settings

    これらの設定の詳細については、統合設定を参照してください。

課題への手動コミット

プロジェクトに汎用 VCS 統合を設定した後、VCS コミットを手動で YouTrack の課題に追加できます。

課題に VCS コミットを手動で追加するには:

  1. クイックビューまたは単一の課題ビューで課題を開きます。

  2. ツールバーの さらに表示メニューを開き、 コミットを追加を選択します。

    Manually add a VCS commit
  3. VCS ホストの URL 内の対応するコミットハッシュをコピーして、コミットハッシュフィールドに貼り付けます。

    Enter the commit hash
  4. 完了したら、追加ボタンをクリックして、課題に VCS コミットを保存します。

    • VCS コミットは課題アクティビティフィードに表示されます。

      Commits are displayed in the activity feed

VCS の変更の表示と編集の使い方について詳しく学びます。

統合設定

デフォルトでは、VCS 統合は、任意のブランチの任意のユーザーによってリポジトリにコミットされた変更を処理します。YouTrack で課題にアクセスできるユーザーは、課題アクティビティストリームでこれらの変更を確認できます。

指定されたブランチで特定のユーザーによる変更のみを処理する場合、または YouTrack での VCS 変更の表示を制限する場合は、統合設定をカスタマイズできます。統合をカスタマイズするには、次の設定を使用します。

設定

説明

リポジトリ

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

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

認証ヘッダー

VCS ホストサーバーから YouTrack に送信され、認証用の Webhook に添付できる資格情報のハッシュ値。

メイン 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 として入力したアドレスが特定のブランチを指している場合、このブランチは、接続のセットアップ時に監視対象のブランチのリストに自動的に追加されます。

VCS 変更の表示対象

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

使用可能なアクション

リストで統合バージョン管理システムを選択すると、ツールバーで次のアクションを使用できます。

アクション

説明

使用不可

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

編集

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

削除

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

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

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

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

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

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

関連ページ:

汎用 VCS との統合

このページの指示に従って、バージョン管理ホストシステム上の VCS リポジトリとプロジェクトを統合します。汎用 VCS 統合により、YouTrack の課題にコミットを手動で添付したり、Webhook を使用してプログラムでリンクを追加したりできます。前提条件:YouTrack はインバウンド接続にアクセス可能です。具体的には、ネットワークが VCS サーバーと YouTrack の間の接続をブロックしていないことを確認する必要があります。VCS 統合を構成する:次に、YouTrack のプ...

VCS の変更の表示と編集

アクティビティストリームには、現在の課題に関連する VCS 変更のリストが表示されます。これらのイベントは、VCS の変更フィルターが有効な場合に表示されます。この情報は、プロジェクトがバージョン管理システムと統合されている場合にのみ利用できます。YouTrack は、バージョン管理システムと直接統合することも、TeamCity や Jenkins などのバージョン管理に接続されている別のアプリケーションを通じて統合することもできます。統合の表示設定が 1 つ以上のグループに制限されている場合、...

リポジトリ設定の編集

必要に応じて、VCS 統合のセットアップ後にリポジトリの URL を編集できます。ただし、この操作は予期しない結果になる可能性があります。リポジトリ URL を更新すると、YouTrack の課題と VCS コミット間のリンクが更新され、新しいリポジトリ URL が使用されます。リポジトリを新しい URL で参照されている場所に移動していない場合、コミットへの既存のリンクは壊れています。リポジトリを実際に別のサーバーまたは VCS プロバイダーに移行した場合にのみ、この設定を更新することを強くお...

JetBrains Space 統合

このページの指示に従って、JetBrains Space でホストされている VCS リポジトリと統合します。スペース統合により、YouTrack で次の機能が有効になります。コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。YouTrack で、課題のアクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。コミットハッシュを課題の概要、説明、コメント、補足...