TeamCity 2019.2ヘルプ

TeamCityと課題追跡システムの統合

TeamCityを課題トラッカーと統合して、開発プロジェクトの包括的なビューを提供できます。TeamCityは、バージョン管理の変更に対するコメントに記載されている課題を検出し、TeamCity Web UIの課題トラッカーへのリンクに変換します。

統合はプロジェクトレベルで設定されます。プロジェクト管理者権限が必要です。TeamCityと課題追跡サーバーの両方に複数のプロジェクトがある場合、またはプロジェクトごとに異なる課題追跡システムを使用している場合は、統合を構成できます。

プロジェクトの統合を有効にすると、そのすべてのサブプロジェクトに対しても統合が有効になります。サブプロジェクト内で構成設定が異なる場合は、その設定がプロジェクトの設定よりも優先されます。

このページで:

課題追跡システムの専用サポート

TeamCityは、すぐにJIRABugzillaYouTrackおよびTeamCity 10.0以降 GitHub(英語)Bitbucket Cloud、およびTFSトラッカーをサポートします。サポートされているプラットフォームと環境ページには、サポートされているバージョンがリストされています。

統合が設定されると、TeamCityは、VCSコミットコメントに記載されている課題ID(= JIRAの課題キー、TFSの作業項目ID)を対応する課題へのリンクに自動的に変換し、基本的な課題の詳細がTeamCity Web UIに表示されます。課題IDの隣のアイコンにカーソルを合わせると(たとえば、ビルド結果の変更タブに)。

Issue tracker integration

ビルドで修正された課題はビルド結果の課題タブでも見ることができます。リストを特定の範囲のビルドに絞り込み、コメントに記載されている課題をその状態と共に表示できます。

Issue log

課題追跡システムの統合の使用に関する推奨事項

課題追跡システムの統合から最大限の利益を得るには、次の手順に従います。

  • バージョン管理への変更をコミットするとき、常に課題IDをメンションする (発行キー)はコミットへのコメントの修正に関連していました。

  • 課題が修正されたら課題を解決します(解決の時間はあまり重要ではありません)。

  • ビルド関連の課題を解決するには、ビルド構成の課題のログを使用してください。ビルドで修正された課題のみを表示するには、解決した課題のみを表示オプションをオンにします。

課題追跡システムの統合を有効にする

要件

課題に関する情報は、提供された資格情報を使用してTeamCityサーバーによって取得され、TeamCityユーザーに表示されます。

これにはいくつかの影響があります。

  • TeamCityサーバーは、課題追跡システムに直接アクセスする必要があります。(また、TeamCityは、課題トラッカーへの接続のプロキシをまだサポート(英語)していません)。

  • 課題追跡システムへの接続で設定されたユーザーは、TeamCityでメンションできる課題を表示するのに十分な権限を持っている必要があります。また、TeamCityユーザーは、構成されたユーザーがアクセスできるすべての課題について、TeamCityで課題の詳細を表示することができます。

接続を構成

統合を有効にするには、プロジェクト設定 | 課題トラッカーページで課題追跡システムへの接続を作成する必要があります。

下記の設定は、すべての課題追跡システムに共通です。

接続タイプ

リストから課題追跡システムの種類を選択します。

表示名

課題追跡システムのTeamCity UIに表示される記号名。

サーバー URL (リポジトリー URL)

課題追跡URL

ユーザー名パスワード (認証)

認証が必要な場合は、課題トラッカーにログインするための認証情報。

追加の認証情報またはTeamCityによって認識され、トラッカー発行リンクに変換される文字列の指定方法に関する詳細は、対応するセクションに記載されています。

TeamCityを他の課題追跡システムと統合する

TeamCityを他の課題追跡システムと統合するには、変更コメント内の課題追跡システムの課題IDの記載をリンクに変換するようにTeamCityを構成します。詳細については、コメント内の外部リンクのマッピングを参照してください。

課題追跡の専用サポートは、カスタムの課題追跡統合プラグイン(英語)を介して追加することもできます。


関連事項:

概念 : サポートされている課題追跡システム
管理者ガイド : コメント内の外部リンクのマッピング
TeamCityプラグインの開発 : 課題追跡システム統合プラグイン(英語)