TeamCity オンプレミス 2026.1 ヘルプ

TeamCity 2026.1 の新機能

リリースサイクルに関する最新情報

今回のリリースから、2022 年以前のバージョン管理スキームに戻ります。TeamCity のメジャーバージョンは「YYYY.N」形式となり、「N」は月ではなくリリース番号を表します。この変更により、リリースサイクルがより予測しやすくなり、他の JetBrains 製品との整合性も向上します。

今年、TeamCity のオンプレミス版とクラウド版のリリースサイクルを分離する予定です。オンプレミス版は引き続き年 2 回のメジャーリリースを実施します。一方、クラウド版はより頻繁にアップデートされるため、オンプレミス版のメジャーリリースを待つことなく、新機能や改善点をより早く利用できるようになります。

Java 21 移行

TeamCity サーバーおよびビルドエージェントは、Java 21 より古い Java バージョンをサポートしなくなりました。アップグレード手順については、こちらの記事を参照してください: 虎の巻: サーバーおよびエージェントマシン上の Java の更新

TeamCity CLI

TeamCity 2026.1 では、TeamCity インスタンスを操作するための新しい方法、TeamCity CLI が追加されました。ブラウザーベースの UI と豊富な REST API に加え、コマンドラインツールを使用してターミナルから直接 TeamCity とやり取りできるようになりました。

CLI を任意のコンピューターにインストールすれば、コマンドラインを移動することなく、ビルドステータスの確認、新規ビルドの開始、障害の調査、その他多くの日常的なタスクの処理を行うことができます。

TeamCity CLI in action

詳細 ...

AI エージェントとの統合

バージョン 2026.1 では、チャットボットやエージェント型 IDE などの AI ツールを TeamCity に接続しやすくなっています。統合オプションは 2 種類から選択できます。

  • TeamCity <server-url>/app/mcp エンドポイントは、AI エージェントが TeamCity と対話できるようにする MCP ツールを提供します。

  • TeamCity CLI には、エージェントがターミナルコマンドを通じて TeamCity と連携できるようにするエージェントスキルが含まれています。

詳細 ...

パイプラインの強化

  • バージョン 2026.1 では、パイプラインを CI/CD ワークフローに完全に統合するための重要な機能強化が導入されました。ビルドチェーンにパイプラインを含めることができるようになりました。これにより、パイプライン間、パイプラインと構成、構成とパイプライン間の依存関係を持つ、きめ細かな設定を作成できます。

    Pipeline dependency
  • ビルド詳細サイドパネルを再設計し、ビルド結果でおなじみのタブ(概要、ビルドログ、パラメーターなど)をすべて含めることで、各ビルドの全体像を把握できるようにしました。また、パイプライン / ジョブ切り替え機能も追加したため、ジョブごとにタブをすばやくフィルタリングでき、パイプラインのインスペクション、デバッグ、トラブルシューティングが容易になりました。

    Pipeline-Job switch in the side panel
  • カスタムビルドダイアログを使用すれば、一度限りのカスタム設定でパイプラインを実行できるようになりました。

    Run build buttons in TeamCity
  • ジョブは、これまでビルド構成でのみ利用可能だった以下のビルド機能を利用できるようになりました。

    Build features in pipelines
  • パイプラインリポジトリの設定を編集する際に、この親プロジェクトが所有する既存の VCS ルートからリポジトリを追加できるようになりました。以前は、ルートを再利用できるオプションは、新しいパイプラインを作成する場合にのみ利用可能でした。

  • HTTP 認証情報を使用して Git リポジトリに接続するすべてのパイプラインは、プルリクエストの追跡や実行ステータスの公開を可能にするリポジトリオプションをサポートしています。以前は、これらのオプションは、構成済みの TeamCity OAuth 接続を介して作成されたパイプラインでのみ利用可能でした。

    CSP and PR in pipelines
  • パイプラインのパラメーターを再設計し、パイプラインの依存関係をより適切にサポートし、より一貫性があり直感的なモデルを提供するようにしました。

    • ジョブは、入力パラメーターと出力パラメーターを個別に定義する必要がなくなりました。代わりに、すべてのジョブパラメーターは、同じパイプライン内の下流ジョブで自動的に利用できるようになります。

    • パイプラインパラメーターを入力または出力として明示的に指定できるようになったため、下流の構成やパイプラインに公開する値をより細かく制御できるようになりました。

    • 親プロジェクトのパラメーターは、子パイプラインやジョブで自動的に利用できるようになるため、インポートする必要がなくなりました。

  • 親プロジェクトでバージョン管理設定が有効になっている場合、パイプラインの YAML ファイルは自動的に DSL に変換されます。現在、パイプラインにおける DSL のサポートは限定的です。TeamCity UI 経由で行われた変更は新しい Kotlin DSL タブに表示されますが、自動的にコミットされないため、パイプラインを実行できません。パイプラインの実行機能を復元するには、これらの変更をリモート .kts ファイルに手動でコミットしてください。

    DSL in pipelines

動的ビルドステップ認証情報

新しいビルドスコープトークン機能を使用すると、ビルド時に有効期限の短い GitHub アクセストークン(最大 60 分)を安全に生成できます。これらのトークンをパラメーターとしてビルドステップに渡すことで、リポジトリへのシームレスなアクセスが可能になります。

Main settings

詳細 ...

SSH 既知のホスト

SSH キーページには、TeamCity が接続先の VCS プロバイダを検証し、ホストの公開鍵が既知のエントリのいずれとも一致しない場合は、それ以上の操作を中止できる追加オプションが追加されました。

SSH Known hosts

詳細 ...

サードパーティ統合機能の強化

Git

  • セキュリティ上の理由から、Git VCS ルートはデフォルトではローカルおよび UNC ファイル URL をサポートしなくなりました。これらを再度有効にするには、teamcity.git.allowFileUrl=true 内部プロパティを設定してください。

  • 浅いクローンGit のチェックアウトポリシーを選択する際に、teamcity.git.agent.shallowCloneDepthteamcity.git.agent.submodules.shallowCloneDepth のパラメーターを追加して --depth (英語) 属性を設定できるようになりました。

  • GitLab CE/EE 接続では、システム Webhook との連携を設定できるようになりました。この機能強化により、TeamCity はリポジトリを定期的にポーリングするではなく、リポジトリの変更に関する通知をほぼ瞬時に受信できるようになります。

  • ステータス発行者のコミットのビルド機能に、Git VCS プロバイダー(GitHub、GitLab、Bitbucket など)にステータスを送信する際に、カスタムビルド構成名を設定するオプションが追加されました。

    CSP statuses in GitHub

Perforce

  • Perforce は変更リストをシェルブしましたをビルドする際、以前のバージョンの TeamCity では、チェックアウトされたファイルを対応するシェルフされたファイルに置き換えていました。バージョン 2026.1 以降、TeamCity では、アンシェルフ後に p4 resolve を実行することで、より高度なアプローチを採用し、競合する変更を検出して解決できるようになりました。

  • Perforce ビルド構成のカスタムビルドをトリガーする際に、複数の保留中の変更リスト ID を指定できるようになりました。

Kubernetes

HashiCorp Vault

Jira

  • オンプレミスの Jira インスタンスへの接続を設定する際、通常のユーザー名 / パスワード認証情報による認証、または課題追跡システム側で発行される個人アクセストークンによる認証のいずれかを選択できるようになりました。

その他の機能強化

  • すべての TeamCity ビルド構成において、ビルド中にエージェントのハードウェア使用状況が自動的に記録されるようになりました。この変更により、以下の更新が行われます。

    • PerfMon ビルド機能は不要となり、パフォーマンスモニター (既存) に名称変更されました。

    • ビルド結果ページの対応するタブは、現在パフォーマンスモニターという名称に変更されており、データが廃止された機能に関連付けられなくなったことを示しています。

    • 新しいパラメーター teamcity.perfmon.feature.enabled を使用すると、特定のビルド構成またはプロジェクトに対して、CPU、ディスク、メモリの使用状況の収集を無効にすることができます。

  • TeamCity Enterprise の試用版ライセンスをお持ちのユーザーは、AI Assistant を使用できるようになりました。

  • 利用可能なアーティファクトを入手する ... オプションのリストに、ターゲットとソースの構成 / パイプラインが同じビルドチェーンに属していない場合にビルドを失敗させる同じチェーンから構築するが追加されました。以前は、同じチェーンから構築するか、最後に完成したオプションのみが利用可能でした。

  • 一般的なビルド構成設定にある既存のこのビルド構成における同時ビルドの最大数設定に加えて、新しい制限に達した場合オプションを使用すると、TeamCity が余剰のビルドをキューに入れるか、最も古い実行中のビルドをキャンセルして容量を解放するかを選択できます。

  • 将来の TeamCity バージョンでは、従来の reverse.dep. 構文を完全に置き換える可能性のある、 override.dep. パラメーター接頭辞を実装しました。新しいパラメーターはパラメーター参照を解決し、一致するパラメーターを持たない構成 / パイプラインに編集を強制的に適用することはありません。

  • SAML 認証プラグインは TeamCity にバンドルされるようになったため、外部 SSO プロバイダーによる認証を有効にするために別途インストールする必要がなくなりました。

  • Gradle プラグインにおいて、Gradle のバージョン選択ロジックを改善し(英語)ました。今回の変更は、ビルドログに情報レベルのエントリをいくつか追加するだけで、目に見える動作変更はありませんが、プラグイン全体の安定性が向上するはずです。

アップグレードノート

アップグレードする前に、バージョン 2026.1 2025.11 との比較の重要な変更点について読むことを強くお勧めします。

解決された問題

実装された機能と修正された問題の概要については、TeamCity 2026.1 リリースノートの記事を参照してください。

ロードマップ

今後のアップデートの詳細については、TeamCity ロードマップおよび TeamCity パイプラインロードマップの記事を参照してください。

TeamCity オンプレミスの更新

最も簡単で信頼性の高いアップグレードには、自動アップデートの使用をお勧めします。アップグレードプロセスと利用可能なオプションの詳細については、TeamCity サーバーとエージェントのアップグレードを参照してください。

TeamCity メジャーバージョンまたはバグ修正バージョンの .tar.gz または .exe インストーラーをダウンロードするには、以前のリリースダウンロードの記事にアクセスしてください。

Docker コンテナーで実行されている TeamCity サーバーについては、この記事を参照してください。

フィードバックは重要です

皆様からのフィードバックを重視しており、ご意見やご提案を共有することをお勧めします。詳細については、リンクサポートとトラブルシューティングを参照してください。

2026 年 5 月 12 日

関連ページ:

虎の巻: サーバーおよびエージェントマシン上の Java の更新

この記事では、エージェントマシンとサーバーマシンの Java アップデート手順について簡単に説明します。詳細については、こちらの記事を参照してください。バンドルされていないバージョンの Java をインストールする、エージェント用に Java を構成する、TeamCity サーバーとエージェントのアップグレード、Java 21 への移行:バージョン 2026.1 以降、TeamCity サーバーとエージェントはどちらも起動に Java 21 を必要とします。TeamCity サーバーは Jav...

TeamCity RESTAPI について

TeamCity は、外部アプリケーションを統合し、TeamCity サーバーとのスクリプトの相互作用を作成するための RESTAPI を提供します。URL パスを介してリソース(エンティティ)にアクセスできます。REST API を使用するために、外部アプリケーションは TeamCity サーバーに HTTP リクエストを行い、応答を解析します。このドキュメントは、TeamCity REST API の一般的な説明と、現在の REST API バージョンの状態を反映する自動生成されたセクション...

AI エージェントとの統合

AI Assistant は既存の TeamCity ワークフローのデバッグと分析に最適なツールですが、TeamCity の UI でのみ利用可能です。ただし、場合によっては、外部の AI 搭載ツールから TeamCity を操作したい場合もあるでしょう。たとえば、空気や Cursor のようなエージェント型 IDE を使用している場合、コーディング環境を移動せずに CI/CD タスクを実行したい場合があります。そのためには、エージェントが TeamCity と連携できるツールにアクセスできる必要があ...

パイプライン設定

この記事では、パイプライン全体に使用できる、共通のパイプラインの動作を指定する設定について説明します。パイプライン設定の編集:コアパイプライン設定を表示および編集するには、右上隅の設定トグルをクリックし、ビジュアルエディターでジョブを囲むパイプラインキャンバス領域内の任意の場所をクリックします。ビジュアルエディターからコードに切り替えて、マークアップを直接編集することもできます。パラメーター:パラメーターは、生の値を参照に置き換えるために設計された名前と値のペアです。TeamCity はパラ

ビルド結果ページ

TeamCity では、ビルドに関するすべての情報 (キューに入っているか、実行中か、完了しているかに関係なく) がビルド結果ページに蓄積されます。ビルド結果を表示するには、任意の構成を選択してビルド履歴を表示し、必要なビルド番号をクリックします。This page includes several static tabs (Overview, Changes, Build Log, Artifacts, and others), as well as contextual tabs whose...

カスタムビルドの実行

ビルド構成とパイプラインの右上隅には、新しいビルドをトリガーする 2 つのボタンが表示されます。実行 — デフォルト設定で新規ビルドを開始します。カスタムビルドを実行する — ビルド開始前にビルド設定を変更できるダイアログを表示します。この記事では、利用可能なカスタマイズオプションについて説明するとともに、カスタムビルドをトリガーするその他の方法についても触れています。カスタムビルドを実行するダイアログ:このダイアログは、以下のいずれかの場合に TeamCity UI に表示されます。カスタムビル...