VCS コミットのリンクの課題
ソフトウェア開発チームは、課題への対応としてアプリケーションコードに変更を加えることがよくあります。これらの更新は通常、バージョン管理システム（VCS）で適用されます。VCS リポジトリにコードをコミットする際に、変更内容と理由を説明するコミットメッセージを記述できます。
YouTrack を VCS リポジトリに統合すると、コミットメッセージまたはブランチ名で課題を参照できるようになります。これらの参照は、リポジトリ、ビルド、コミットから YouTrack の課題を指すリンクに変換されます。この機能は、以下の統合でサポートされています。
課題への参照は次の方法で追加できます。
参照場所 | 詳細 |
|---|---|
コミットメッセージ: | コミットメッセージで課題 ID を参照するには、次の 2 つの方法があります。
|
ブランチ名 | YouTrack は、コミットメッセージ内に課題参照が見つからない場合、ブランチの名前で課題 ID を確認します。ブランチ名に課題 ID が含まれている場合、コミットはこの課題に関連付けられます。この場合、コミットメッセージ内のコマンドはすべて無視されます。 ブランチ名による参照の課題を有効にするには、VCS 統合設定で課題の参照については、ブランチ名を確認する機能を有効にします。詳細については、VCS 統合を参照してください。 |
プルリクエストのタイトルと説明 | YouTrack は、プル要求のタイトルと説明で課題 ID を確認し、プル要求をメンションされた課題に添付します。プルリクエストのタイトルと説明にあるコマンドはすべて無視されます。プルリクエストの処理の詳細については、プルリクエストを参照してください。 |
ビルドサーバー統合
YouTrack をビルドサーバーまたは CI/CD ツールと統合すると、ビルドサーバーに接続されたバージョン管理システムに変更をコミットする際に、課題を参照できるようになります。課題を参照するには、コメントに課題 ID を記載するだけです。例: fixed YP-2046
JetBrains および TeamCity との統合では、課題 ID への参照は対応する YouTrack の課題へのリンクに変換されます。課題 ID の後にある下矢印アイコンにポインターを移動すると、ツールチップに課題の概要と主要なフィールドが表示されます。
コミットメッセージに課題参照が含まれていないが、ブランチ名に課題 ID が含まれている場合、このブランチへのすべてのコミットは自動的にこの課題にリンクされます。
YouTrack では、TeamCity の詳細を変更するページへのリンクが課題に追加されています。関連するすべてのコミットは、課題アクティビティストリームに表示されます。
VCS 統合
バージョン管理システムと直接統合されているため、次の方法でリンクを作成できます。
コミットメッセージで YouTrack の課題を参照して、VCS から YouTrack へのリンクを作成します。
名前に課題 ID を含むブランチへの変更をコミットして、VCS から YouTrack へのリンクを作成します。
例:
コミットメッセージ: | VCS に表示されるコミットメッセージ |
|---|---|
RDOC-2920 では、ヘルプデスクチケットのコメントを固定および固定解除する手順が追加されました。 | RDOC-2920(英語) では、ヘルプデスクチケットのコメントを固定および固定解除する手順が追加されました。 |
VCS 変更作成者と YouTrack ユーザーの一致
VCS の変更をリンクしてコミットメッセージでコマンドを処理するには、YouTrack はコミットメッセージの作成者と一致するユーザーアカウントを見つける必要があります。コミットメッセージでコマンドが指定されている場合は、YouTrack でユーザーアカウントに付与されているアクセス許可に基づいて適用されます。ユーザーアカウントは、バージョン管理システムへの接続の種類に基づいてさまざまな方法で識別されます。
接続タイプ | 説明 |
|---|---|
TeamCity の統合 | YouTrack は、VCS に変更をコミットしたユーザーの TeamCity ユーザープロファイルに保存されているメールアドレスをチェックします。変更をコミットした TeamCity ユーザーを認識するために、VCS ユーザー名を TeamCity のユーザープロファイルに関連付ける必要があります。 |
VCS 統合 | VCS 統合の場合、課題にコマンドを適用する機能は、VCS 統合設定のコミット者グループのメンバーであるユーザーに限られています。
|
コミットメッセージの作成者が YouTrack で見つからない場合、コマンドは適用されません。ユーザー名は、VCS の変更タブに赤いテキストで表示されます。警告ツールチップは、課題を修正するために使用できる情報を提供します。
この課題を解決するためにユーザーができることは基本的に 2 つあります。
YouTrack と統合 VCS のアカウントに同じメールアドレスを使用してください。
自分の Hub アカウントの VCS のユーザー名のリストに自分の名前（または Bitbucket のニックネーム）を追加します。
関連ページ：
VCS コミットでのコマンドの適用
バージョン管理システムのコードリポジトリへの変更をコミットするときに、コマンドを課題に適用できます。YouTrack を開く必要すらありません。これらの変更を適用するには、特別な形式を使用して、コミットメッセージでコマンドを指定します。YouTrack でサポートされているコマンドの完全なリストについては、コマンドリファレンスを参照してください。コミットメッセージに課題へのリンクを追加する方法をすでに見たかもしれません。これはさらに一歩進んだものです。課題とバージョン管理システム間を移動するのに...
VCS 統合
YouTrack を使用すると、バージョン管理システムへの接続を設定できます。YouTrack は、GitHub、GitLab、Bitbucket との直接統合をサポートしています。また、YouTrack とセルフホスト型の GitHub Enterprise、GitLab Community Edition(CE)、GitLab Enterprise Edition(EE)、Bitbucket サーバー、Gogs、Gitea、Microsoft、Azure Repos サーバーとの統合も設定で...
VCS の変更の表示と編集
アクティビティストリームには、現在の課題に関連付けられている VCS 変更のリストが表示されます。これらのイベントは、VCS の変更フィルターが有効になっている場合に表示されます。YouTrack は、バージョン管理システムに直接統合することも、バージョン管理に接続されたビルドサーバーを介して統合することもできます。統合の表示設定が 1 つ以上のグループに制限されている場合、指定したグループのいずれかのメンバーである場合にのみ、VCS の変更が表示されます。課題がメンションされたとき、名前に課題...
IDE でスタックトレースを開く
多くの開発チームは YouTrack を使ってアプリケーションのバグを報告し追跡しています。プログラマーやテスターはしばしばこれらのバグを見つけて修正するために例外を分析します。アプリケーションによって例外がスローされた場合、一般的な方法は、現在のスタックトレース（エラーが発生したときのアクティブスタックフレームのレポート）を取得し、課題の原因を突き止めることです。YouTrack でスタックトレースを操作するために使用できるトリックがいくつかあります。テスターは、課題を報告するときにスタックト...