TeamCity オンプレミス 2025.11 ヘルプ

Azure ボードの作業項目

TeamCity を Azure Board Work Items(または Team Foundation Work Items)と統合することで、TeamCity UI から作業項目へのリンクを提供できます。TeamCity は、Azure DevOps Server(旧称 Team Foundation Server、バージョン 2012 以降)および Azure DevOps Services をサポートしています。

TeamCity UI での作業項目へのリンクの表示

Azure ボードワークアイテムとの統合が有効になっている場合、TeamCity は VCS コミットのコメントに記載されているワークアイテム ID を自動的に検出します。これらの ID を対応する作業項目へのリンクに変換し、UI で TeamCity ユーザーに表示します。

  • TeamCity UI で作業項目の基本的な詳細を表示するには、関連するビルドの結果の変更タブを開き、作業項目 ID の横にあるアイコンにカーソルを合わせます。

  • ビルドで修正された作業項目は、ビルド結果の課題タブで表示できます。

  • ビルド構成全体 (個々のビルドだけでなく) に関連する作業項目を表示するには、ビルド構成ホームページの問題のログタブを使用します。リストを特定の範囲のビルドにフィルター処理したり、解決された問題のみを表示オプションを有効にしてビルドで修正された問題のみを表示したりできます。

さらに、チェンジセットに関連する作業項目がある場合、TeamCity はそれらに関する情報を取得し、変更セットにコメントが追加されていなくても UI に情報を表示できます。

Azure ボード作業項目との統合から最大の利益を得るには、次の推奨事項に従ってください。

  • バージョン管理に変更をコミットするときは、コミットのコメントに修正に関連する作業項目 ID を必ず記載してください

  • 修正された作業項目を課題追跡ツールで解決済みとしてマークすると、TeamCity ログに修正済みステータスで表示されます (解決の時間は実際には重要ではありません)。

Azure ボード作業項目への接続の構成

TeamCity と Azure ボード作業項目の統合を有効にするには、プロジェクトレベルで構成されているため、プロジェクト管理者の権限が必要です。プロジェクトの統合を有効にすると、そのすべてのサブプロジェクトでも統合が有効になることに注意してください。サブプロジェクトで設定が異なる場合は、親プロジェクトの設定よりも優先されます。

統合を有効にするには、次の手順を実行します。

  1. プロジェクト設定を開き、課題トラッカー設定タブに移動します。

  2. 次の設定で、Team Foundation 作業項目タイプの新しい接続を作成します。

    • 表示名 — 接続名を指定して、他の接続と区別します。

    • サーバー URL — Azure DevOps サーバー URL を https://dev.azure.com/<organization>/<project> (Azure DevOps サービス) または http[s]://<host>:<port>/tfs/<collection>/<project> (Azure DevOps サーバー) 形式で入力します。

    • ユーザー名 - このフィールドを空のままにして、Azure DevOps が TeamCity サーバーの実行に使用するユーザーアカウントを選択するか、DOMAIN\UserName 文字列を手動で入力します。

    • パスワード — ユーザーの個人アクセストークンを入力します。トークンのスコープには、TeamCity からアクセスするリポジトリに対する作業項目 (読み取り、書き込み、管理) 権限が含まれている必要があります。

    • パターン - コメントテキスト内の作業項目 ID を認識するために、Java 正規表現(英語)パターンを指定します。一致したテキスト (またはグループが定義されている場合は最初のグループ) が作業項目番号として使用されます。最も一般的なケースは #(\d+) です。これにより、テキスト Fix for #1234 から作業項目 ID として 1234 が抽出されます。

カスタム解決状態

TeamCity は、作業項目のカスタム状態をサポートします。例: 解決された状態をカスタマイズするには、teamcity.tfs.workItems.resolvedStates 内部プロパティClosed?|Done|Fixed|Resolved?|Removed? に設定します。

2025 年 6 月 27 日

関連ページ:

ビルド結果ページ

TeamCity では、ビルドに関するすべての情報 (キューに入っているか、実行中か、完了しているかに関係なく) がビルド結果ページに蓄積されます。ビルド結果を表示するには、任意の構成を選択してビルド履歴を表示し、必要なビルド番号をクリックします。このページには、いくつかの静的タブ (概要、変更、ビルドログ、アーティファクトなど) と、特定の構成機能に応じて表示が決まるコンテキストタブが含まれます。例: 依存関係タブは、親構成がビルドチェーンに属するビルドに対してのみ表示されます。内部ビルド ID...

Team Foundation バージョン管理 (Azure DevOps)

Azure DevOps でホストされているプロジェクトは、次のいずれかのバージョン管理システムを使用できます。Git — Linus Torvalds が最初に作成したオープンソースの分散バージョン管理システム。Azure DevOps で TeamCity を Git リポジトリに接続するには、Azure DevOps OAuth 接続を設定します。Git リポジトリを対象とするすべての VCS ルートに共通する機能の詳細については、この記事を参照してください:Git。Team Foundati...

プロジェクト管理者ガイド

このセクションでは、プロジェクト管理に焦点を当てます。TeamCity プロジェクトとビルド構成の作成、ビルドステップの設定、依存関係チェーンの構成などについて説明します。基本的な TeamCity ワークフロー:次のダイアグラムは、基本的な TeamCity ワークフローを示しています。TeamCity サーバーはリポジトリの変更を検出しました。サーバーはこの変更をデータベースに書き込みます。ビルド構成に添付されたトリガーは、データベース内の関連する変更を検出し、ビルドを開始します。トリガー...

TeamCity と Jira の統合

TeamCity と Jira の統合により、次のことが可能になります。TeamCity UI での Jira の問題へのリンクの表示 — 自己管理型 Jira(データセンターおよびサーバー 4.4 以降)および Jira クラウドに適用可能。TeamCity ビルドステータスを Jira クラウドに報告します。この記事では、Jira と統合した場合の TeamCity の動作について説明し、統合を有効にして構成する方法について説明します。TeamCity UI での Jira 問題へのリンクの表示...