TeamCity オンプレミス 2025.11 ヘルプ

TeamCity と YouTrack の統合

TeamCity を JetBrains YouTrack スタンドアロンまたは InCloud と統合して、TeamCity UI から YouTrack の課題へのリンクを提供できます。

TeamCity はレガシー YouTrack RESTAPI エンドポイント(英語)をサポートしていないことに注意してください。詳細については、この課題(英語)を参照してください。

TeamCity UI での YouTrack 課題へのリンクの表示

YouTrack との統合が有効になっている場合、TeamCity は、VCS コミットのコメントに記載されている YouTrack 課題 ID を自動的に検出します。これらの ID を YouTrack の対応する課題へのリンクに変換し、UI で TeamCity ユーザーに表示します。

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

Issue tracker integration

ビルドで修正された課題は、ビルド結果の課題タブで確認できます。

Issues tab

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

Issue log

バージョン管理に変更をコミットするときは、YouTrack 統合のメリットを最大限に得るために、コミットのコメントに修正に関連する課題 ID を必ず記載してください

YouTrack への接続の構成

統合を有効にするには:

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

  2. 次の設定で新しい接続を作成します。

    • 接続タイプ — リストから YouTrack を選択します。

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

    • サーバー URL — YouTrack インスタンスのベース URL を入力します。

    • 認証 — 統合を設定するために使用する認証タイプを選択します。ユーザー名とパスワードでサインインするか、トークンを使用することができます。

    • ユーザー名 — YouTrack ユーザーアカウントのユーザー名を入力します。このオプションは、認証ユーザー名パスワードに設定されているときに表示されます。

    • パスワード - YouTrack ユーザーアカウントのパスワードを入力します。このオプションは、認証ユーザー名パスワードに設定されているときに表示されます。

    • 永久トークン永久トークンを入力します。このオプションは、認証永久トークンに設定されているときに表示されます。

    • プロジェクト ID — YouTrack の課題への参照として認識される文字列を指定するには、スペースで区切られたプロジェクト ID のリストを入力します。例: プロジェクト ID が TW の場合、VCS コメントに記載されている TW-18802 などの課題 ID は、対応する課題へのリンクに変換されます。

      すべてのプロジェクト ID を自動的にロードすることもできます。すべての YouTrack ID を自動的に使用するを有効にして、YouTrack サーバーへの接続をテストします。接続が成功すると、プロジェクト ID フィールドが自動的に入力されます。TeamCity は、YouTrack で新しく作成されたプロジェクトを検出し、プロジェクト ID のリストを自動的に同期します。

YouTrack への接続で指定されたユーザーは、YouTrack の課題を表示するための十分な権限を持っている必要があることに注意してください。これにより、TeamCity は課題に関する情報を取得し、UI に表示できるようになります。

YouTrack との統合の強化

YouTrack はネイティブ TeamCity 統合を提供し、利用可能な機能のセットを強化します。例:

  • YouTrack は、「ビルドで修正」フィールドを特定のビルド番号で埋めることができます。

  • YouTrack を使用すると、VCS 変更コミットへのコメントでコマンドを指定することにより、コマンドを課題に適用できます。

これらの機能を使用するには、YouTrack を構成します

2025 年 4 月 07 日

関連ページ:

ビルド結果ページ

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

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

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

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 Webhook

Webhook は、特定のイベントが発生したときにアプリまたはサービスから送信される自動化された HTTP ベースのメッセージです。Webhook を使用すると、2 つの API 間のイベント駆動型通信をセットアップできます。TeamCity は、新しいビルドの開始時、エージェントの登録解除時、サーバーによるリモートリポジトリからの変更の収集時などに、ターゲット URL にペイロードを送信できます。Webhook を有効にする:管理 | <ルートプロジェクト> | パラメーターに移...