TeamCity 2020.1ヘルプ

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

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

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

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

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

TeamCity supports Jira , Bugzilla , YouTrack , GitHub , Bitbucket Cloud , and Azure DevOps Server (formely TFS ) trackers out of the box. The サポートされているプラットフォームと環境 page lists supported versions.

When an integration is configured, TeamCity automatically transforms an issue ID (=issue key in Jira, work item ID in Azure DevOps Server) mentioned in the VCS commit comment into a link to the corresponding issue, and the basic issue details are displayed in the TeamCity web UI when hovering over the icon next to the issue ID (for example, on the 変更 tab of the build results).

Issue tracker integration

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

Issue log

Since TeamCity 2020.1, integration with Jira Cloud also allows previewing build statuses directly in Jira.

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

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

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

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

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

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

要件

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

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

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

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

接続を構成

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

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

接続タイプ

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

表示名

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

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

課題追跡URL

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

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

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

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

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

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