TeamCity と課題追跡システムの統合
TeamCity を課題追跡システムと統合して、開発プロジェクトの包括的なビューを提供できます。TeamCity は、バージョン管理の変更に対するコメントでメンションされている課題を検出し、TeamCity UI の課題トラッカーへのリンクに変換します。
統合はプロジェクトレベルで構成されます。プロジェクト管理者のアクセス許可が必要です。TeamCity と課題追跡サーバーの両方に複数のプロジェクトがある場合、または異なるプロジェクトに異なる課題追跡を使用している場合は、統合を構成できます。
プロジェクトの統合を有効にすると、そのすべてのサブプロジェクトに対しても統合が有効になります。サブプロジェクト内で構成設定が異なる場合は、その設定がプロジェクトの設定よりも優先されます。
課題追跡システムの専用サポート
TeamCity は、Jira、Bugzilla、YouTrack、GitHub、GitLab、Bitbucket (クラウド、サーバー、データセンター)、Azure DevOps Server（以前の TFS）トラッカーをすぐにサポートします。サポートされているプラットフォームと環境ページには、サポートされているバージョンが一覧表示されます。
統合が構成されると、TeamCity は VCS コミットコメントに記載されている課題 ID（= Jira の課題キー、Azure DevOps Server の作業項目 ID）を対応する課題へのリンクに自動的に変換し、基本的な課題の詳細が課題 ID の横にあるアイコンにカーソルを合わせたときの TeamCity WebUI（たとえば、ビルド結果の変更タブ）。
ビルドで修正された課題はビルド結果の課題タブでも見ることができます。リストを特定の範囲のビルドに絞り込み、コメントに記載されている課題をその状態と共に表示できます。
TeamCity 2020.1 以降、Jira Cloud との統合により、Jira でビルドステータスを直接プレビューすることもできます。
課題追跡システムの統合の使用に関する推奨事項
課題追跡システムの統合から最大限の利益を得るには、次の手順に従います。
バージョン管理への変更をコミットするとき、常に課題 ID にメンションする (発行キー) はコミットへのコメントの修正に関連していました。
課題が修正されたら課題を解決します（解決の時間はあまり重要ではありません）。
ビルドに関連する課題を取得するには、ビルド構成の課題のログを使用します。「解決された課題のみを表示」オプションをオンにして、ビルドで修正された課題のみを表示します。
課題追跡システムの統合を有効にする
要件
課題に関する情報は、提供された資格情報を使用して TeamCity サーバーによって取得され、TeamCity ユーザーに表示されます。
これにはいくつかの影響があります。
TeamCity サーバーは、課題追跡システムに直接アクセスする必要があります。
課題追跡システムへの接続で設定されたユーザーは、TeamCity でメンションできる課題を表示するのに十分な権限を持っている必要があります。また、TeamCity ユーザーは、構成されたユーザーがアクセスできるすべての課題について、TeamCity で課題の詳細を表示することができます。
接続を構成
To enable integration, you need to create a connection to your issue tracker on the プロジェクト設定 | Issue Trackers page.
下記の設定は、すべての課題追跡システムに共通です。
接続タイプ | リストから課題追跡システムの種類を選択します。 |
表示名 | 課題追跡システムの TeamCity UI に表示される記号名。 |
サーバー URL (リポジトリ URL) | 課題トラッカーの URL |
ユーザー名パスワード (認証) | 認証が必要な場合は、issue tracker にログインするための認証情報。 |
追加の認証情報または TeamCity によって認識され、トラッカー発行リンクに変換される文字列の指定方法に関する詳細は、対応するセクションに記載されています。
文字列を課題へのリンクに変換する
一般設定に加えて、トラッカーの課題への参照として認識される文字列を指定する必要があります。
Jira の場合、スペースで区切られたプロジェクトキー(英語)のリストを提供する必要があります。すべてのプロジェクトキーを自動的に読み込むこともできます。対応するボックスをチェックして、Jira サーバーへの接続をテストします。接続が成功すると、プロジェクトキーフィールドが自動的に入力されます。Jira で新しく作成されたプロジェクトは TeamCity によって検出され、プロジェクトキーリストが自動的に同期されます。
例: プロジェクトキーが WEB の場合、VCS コメントに記載されている WEB-101 などの課題キーは、対応する課題へのリンクに解決されます。
YouTrack の場合、認証用の永久トークンと、スペースで区切られたプロジェクト ID のリストを提供する必要があります。すべてのプロジェクト ID を自動的に読み込むこともできます。すべての YouTrack ID を自動的に使用するをチェックし、YouTrack サーバーへの接続をテストします。接続が成功すると、プロジェクト ID フィールドが自動的に入力されます。YouTrack で新しく作成されたプロジェクトは TeamCity によって検出され、プロジェクト ID リストが自動的に同期されます。
例: プロジェクト ID が TW の場合、VCS コメントに記載されている TW-18802 などの課題 ID は、対応する課題へのリンクに解決されます。
Bugzilla、GitHub、GitLab、Bitbucket クラウドの場合、テキストで課題 ID を見つけるには、発行 ID パターン :Java 正規表現(英語)パターンを指定する必要があります。一致したテキスト（またはグループが定義されている場合は最初のグループ）が発行番号として使用されます。最も一般的なケースは #(\d+) です。これにより、テキスト Fix for #1234 から課題 ID として 1234 が抽出されます。
TeamCity は、VCS コメントに記載されている課題番号を解決し、UI にこの課題へのリンクを表示します（たとえば、変更ページまたはビルド結果の課題タブ）。
TeamCity を他の課題追跡システムと統合する
TeamCity を他の課題追跡システムと統合するには、変更コメント内の課題追跡システムの課題 ID の記載をリンクに変換するように TeamCity を構成します。詳細については、「コメント内の外部リンクのマッピング」を参照してください。
課題追跡システムの専用サポートは、カスタム課題追跡システム統合プラグイン(英語)を介して追加することもできます。
関連ページ：
TeamCity と Jira の統合
TeamCity と Jira の統合により、次のことが可能になります。TeamCity UI での Jira の問題へのリンクの表示 — 自己管理型 Jira（データセンターおよびサーバー 4.4 以降）および Jira クラウドに適用可能。TeamCity ビルドステータスを Jira クラウドに報告します。この記事では、Jira と統合した場合の TeamCity の動作について説明し、統合を有効にして構成する方法について説明します。TeamCity UI での Jira 問題へのリンクの表示...
TeamCity と Bugzilla の統合
TeamCity を Bugzilla（3.0 以降）と統合して、TeamCity UI から Bugzilla の問題へのリンクを提供できます。TeamCity UI での Bugzilla の問題へのリンクの表示：Bugzilla との統合が有効になっている場合、TeamCity は VCS コミットのコメントに記載されている問題 ID を自動的に検出します。これらの ID を Bugzilla の対応する問題へのリンクに変換し、UI で TeamCity ユーザーに表示します。TeamCi...
TeamCity と GitHub の統合の問題
GitHub の問題を使用すると、開発チームは現在の問題に優先順位を付け、それを実行可能なタスクに分割し、そのステータスを追跡できます。コミットメッセージに既存の問題への参照が含まれている場合、TeamCity はビルド履歴とビルド結果ページにこの問題へのリンクを表示します。この統合は、プルリクエスト機能が構成されたプロジェクトでも機能します。プルリクエストに既存の問題が記載されている場合、TeamCity は UI に対応するデータを表示します。この統合が実施されると、GitHub 問題 ID...
ビルド結果ページ
TeamCity では、ビルドに関するすべての情報 (キューに入っているか、実行中か、完了しているかに関係なく) がビルド結果ページに蓄積されます。ビルド結果を表示するには、任意の構成を選択してビルド履歴を表示し、必要なビルド番号をクリックします。このページには、いくつかの静的タブ (概要、変更、ビルドログ、アーティファクトなど) と、特定の構成機能に応じて表示が決まるコンテキストタブが含まれます。例: 依存関係タブは、親構成がビルドチェーンに属するビルドに対してのみ表示されます。内部ビルド ID...
プロジェクト管理者ガイド
このセクションでは、プロジェクト管理に焦点を当てます。TeamCity プロジェクトとビルド構成の作成、ビルドステップの設定、依存関係チェーンの構成などについて説明します。基本的な TeamCity ワークフロー：次のダイアグラムは、基本的な TeamCity ワークフローを示しています。TeamCity サーバーはリポジトリの変更を検出しました。サーバーはこの変更をデータベースに書き込みます。ビルド構成に添付されたトリガーは、データベース内の関連する変更を検出し、ビルドを開始します。トリガー...
ビルド結果を扱う
TeamCity には、ホームと設定という 2 つのメインモードがあります。ホームモードでは、プロジェクトレベルとビルド構成レベルでビルド結果が蓄積されます。新しい TeamCity UI を使用している場合は、プロジェクトサイドバーを介してこの階層間を移動できます。各モードには、独自の詳細レベルがあります。プロジェクト全体のビルド統計を確認するには、プロジェクトホームにアクセスしてください。単一のビルド構成の詳細を参照するには、その名前をクリックしてビルド構成ホームを開きます。ホームページで特...