汎用 VCS 統合
このページの指示に従って、バージョン管理ホストシステム上の VCS リポジトリと統合します。
汎用 VCS 統合により、YouTrack の課題にコミットを手動で添付したり、Webhook を使用してプログラムでリンクを追加したりできます。
前提条件
YouTrack はインバウンド接続にアクセス可能です。具体的には、ネットワークが VCS サーバーと YouTrack の間の接続をブロックしていないことを確認する必要があります。
VCS 統合を構成する
次に、YouTrack のプロジェクトと VCS のリポジトリ間の接続を確立する必要があります。VCS に接続するには、リポジトリ URL が必要です。
VCS リポジトリに接続するには:
YouTrack で
ページを開きます。新しい VCS 統合ボタンをクリックしてください。
新しい VCS 統合ダイアログが開きます。
メイン YouTrack プロジェクトリストから、VCS リポジトリと統合するプライマリプロジェクトの名前を選択します。リポジトリへの接続を設定した後で、追加の YouTrack プロジェクトとの統合を追加できます。
サーバータイプの場合は、汎用を選択します。
VCS リポジトリを指す URL をリポジトリ URL 入力フィールドに入力または貼り付けます。コミットハッシュの変数として
$hash$
を挿入できます。サンプル:
https://<servername.com>/<user>/<repositoryname>/commit/$hash$
保存ボタンをクリックしてください。
YouTrack プロジェクトは、VCS ホストから入力されたリポジトリと統合されます。
プロジェクト内の課題を参照するコミットを VCS リポジトリから手動で入力できるようになりました。コミットリンクは、参照された課題のアクティビティストリームに表示されます。
サイドバーには、VCS 統合を設定するための追加設定が表示されます。
これらの設定の詳細については、統合設定を参照してください。
課題への手動コミット
プロジェクトに汎用 VCS 統合を設定した後、VCS コミットを手動で YouTrack の課題に追加できます。
課題に VCS コミットを手動で追加するには:
クイックビューまたは単一の課題ビューで課題を開きます。
ツールバーの さらに表示メニューを開き、 コミットを追加を選択します。
VCS ホストの URL 内の対応するコミットハッシュをコピーして、コミットハッシュフィールドに貼り付けます。
完了したら、追加ボタンをクリックして、課題に VCS コミットを保存します。
VCS コミットは課題アクティビティフィードに表示されます。
VCS の変更の表示と編集の使い方について詳しく学びます。
統合設定
デフォルトでは、VCS 統合は、任意のブランチの任意のユーザーによってリポジトリにコミットされた変更を処理します。YouTrack で課題にアクセスできるユーザーは、課題アクティビティストリームでこれらの変更を確認できます。
指定されたブランチで特定のユーザーによる変更のみを処理する場合、または YouTrack での VCS 変更の表示を制限する場合は、統合設定をカスタマイズできます。統合をカスタマイズするには、次の設定を使用します。
設定 | 説明 |
---|---|
リポジトリ | 統合バージョン管理システムのリポジトリへのパスを表示します。 必要に応じて、統合を設定した後にリポジトリの場所を編集できます。手順については、リポジトリ設定の編集を参照してください。 |
認証ヘッダー | VCS ホストサーバーから YouTrack に送信され、認証用の Webhook に添付できる資格情報のハッシュ値。 |
メイン YouTrack プロジェクト | VCS 統合がアクティブなプライマリプロジェクトを設定します。 |
追加プロジェクト | リンクされたリポジトリを 1 つ以上の追加プロジェクトと統合します。 |
コミット者 | コミットメッセージ内のコマンドに関する課題を、指定されたグループのメンバーに更新する機能を制限します。選択したグループのメンバーではないユーザーからの VCS の変更は、関連する課題にまだ関連付けられていますが、コミットで指定されているコマンドはすべて無視されます。 |
VCS 変更の処理スキーム | コミットメッセージが課題 ID を参照する場合に、VCS の変更を処理する方法を選択します。次のオプションがサポートされています。
|
監視対象のブランチ | 変更をモニターしたいブランチの名前を保管します。
|
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 で、課題のアクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。コミットハッシュを課題の概要、説明、コメント、補足...