TeamCity On-Premises 2026.2 Help

TeamCity 2021.2 の新機能 (英語)

2 要素認証

TeamCity は組み込みの 2 要素ユーザー認証 (2FA) を提供するようになりました。 TeamCity サーバーで有効にすると、セキュリティレベルがさらに高まります。 ユーザーは、通常の資格情報を提供し、 さらに個人デバイスで生成された使い捨て鍵を送信するという 2 つのステップで本人確認を行う必要があります。

2FA はデフォルトで 任意に設定されていますが、サーバー上で 無効または 必須に変更できます - 管理 | 認証 で。 オプションモードでは、ユーザーは自分のアカウントで 2FA を有効にするかどうかを決定できます。 必須モードでは、2FA 検証なしで TeamCity にアクセスできなくなります。 有効にすると、ユーザーには 1 週間の猶予期間が与えられ、その期間内に自分のアカウントに 2FA を設定する必要があります。

二要素認証の構成

サーバーで 2FA を有効にする方法を読み、 ユーザーアカウント用に設定します

C# スクリプトランナー

新しい C# スクリプトランナーは、C# でサービスのタスクを自動化する便利な方法を提供します。ビルド環境の準備、OS ユーザーの作成、メッセンジャーへの報告などができます。 このランナーは、C# に慣れているユーザーにとって PowerShellKotlin の優れた代替手段です。

ランナーは、Windows、Linux、macOS など、プラットフォーム間で C# スクリプトを起動できます。 .NET 6.0 が必要なので、最も簡単な方法は、.NET がプリインストールされた Docker コンテナー内で起動することです。 また、 エージェントツールとして カスタム C# インタラクティブシェル(英語)をインストールする必要があります。

このランナーのもう 1 つの利点は、スクリプトで参照されている NuGet パッケージを自動的に復元できることです。 デフォルトでは、TeamCity は NuGet.org でパッケージを検索しますが、プライベートフィードや TeamCity-internal フィードを含む、他のターゲットフィードを指定できます。

C# スクリプトビルドステップを構成するには、スクリプトコード (または .csx ファイルへのパス) と、必要に応じてその引数を入力するだけです。 その他の設定については、 この記事を参照してください。

C# スクリプトステップの構成

Perforce 統合: シェルブされたファイルでビルドを実行し、ステータスを Helix Swarm に報告するなど

TeamCity 2021.2 では、 Perforce P4 VCS に依存するプロジェクト向けに多くの機能強化が導入されています。

シェルブされたファイルでビルドを実行する

Perforce を使用すると、ユーザーは変更されたファイルをディポにチェックインせずに一時的に共有できます。 これは シェルビング(英語)と呼ばれます。 TeamCity は、このようなシェルブされたファイルでビルドを実行できるようになり、実際のビルド環境でローカルコードを事前テストできます。

シェルブされた変更リストでビルドを実行できます。

どちらの場合も、TeamCity は 個人ビルドを実行します。これは、プロジェクトのバージョン履歴に影響しない変更を処理するためのビルドタイプです。

これらのオプションは、 Perforce VCS ルートを使用するすべてのビルド構成で使用できます。

P4 シェルフファイルでカスタムビルドを実行する

詳細

ビルドステータスを Perforce Helix Swarm に報告する

シェルブされた変更リストでビルドが実行される場合、TeamCity はそのステータスを Perforce Helix Swarm に自動的に報告できます。 このツールをコードレビューに使用している場合、ビルドが成功したかどうかを確認するためだけに TeamCity との間を行き来する必要はもうありません。

この統合をセットアップするには、 Perforce VCS ルートを使用するビルド構成で コミットステータスパブリッシャー 機能を有効にします:

P4 HelixSwarm のコミットステータスパブリッシャーを構成する

この機能を構成すると、TeamCity はビルドステータスの更新を Helix Swarm の該当するコードレビューへのコメントとして公開します:

Helix Swarm での TeamCity ビルドステータスの表示

詳細

自動ラベルのサポート

TeamCity はプロジェクトソースにカスタムラベルを割り当てることができます。 Perforce の場合、 VCS ラベル付けビルド機能は、以前はローカルワークスペースのアーカイブである 静的ラベルを作成していました。 ただし、 自動 Perforce ラベル(英語)は、変更リストの単なるエイリアスとして機能するため、パフォーマンスの点ではるかに優れているようです。 また、バージョン 2021.2 以降、TeamCity はデフォルトで自動ラベルを公開します。

静的ラベルを使用したい場合は、サーバーでこの変更を元に戻す方法についての説明が 記載されたアップグレードノートを参照してください。

詳細

パラメーター化された接続変数

ビルドエージェントは、1 回のビルド実行中に複数の Perforce VCS ルートに接続する必要がある場合、これらの各ルートの接続パラメーターを取得できるようになりました。

以前は、ビルドスクリプトで P4PORTP4USER 、または P4CLIENT を使用する場合、最初の Perforce ルートの変数しか参照できませんでした。 現在、TeamCity はこれらの変数をパラメーターとして保存するため、スクリプト内でルートごとに個別に参照できます: P4USERP4PORTP4CLIENT。 例: env.P4PORT=%vcsRoot.<rootID>.port%

ここで、 ルート ID は、設定で指定された VCS ルートの外部 ID です。

詳細

JetBrains Space 統合: ユーザーの認証とリポジトリからのプロジェクト作成

Space は、ソフトウェアチーム向けの新しい JetBrains コラボレーションソリューションです。 あなたの会社がすでにそれに参加している場合は、次のことができます。

  • JetBrains Space リポジトリからプロジェクト、ビルド構成、VCS ルートをネイティブに作成します。

  • ユーザーが JetBrains Space アカウントを使用して TeamCity にサインインできるようにします。

この統合には、Space インスタンスへの接続を事前に構成する必要があります。 方法はこちらを参照してください。

JetBrains Space リポジトリからプロジェクト、ビルド構成、VCS ルートを作成する

接続を構成すると、TeamCity のプロジェクトおよびビルド構成作成ウィザードで JetBrains Space ボタンが使用できるようになります。 初めてクリックするときは、Space にサインインし、プロジェクトデータを表示するための TeamCity アクセスを許可する必要があります。

TeamCity は利用可能な Space リポジトリのリストを表示します:

JetBrains Space からプロジェクトを作成する

プロジェクトまたはビルド構成を作成するリポジトリを選択すると、TeamCity がスキャンして、 こちらで説明されているように設定を提案します。

JetBrains Space アカウントを使用して TeamCity で認証する

サーバーでスペース認証をアクティブにするには、次のことを行う必要があります。

  1. ルートプロジェクトレベルで スペースへの接続を構成します。

  2. 管理 | 認証 で JetBrains Space 認証モジュールを有効にします。

その結果、ユーザーは TeamCity ログインページに JetBrains Space アイコンを表示し、それをクリックして Space アカウントでサインインできるようになります。

JetBrains Space を使用して TeamCity にサインインする

Azure DevOps Services アカウントを使用して TeamCity で認証する

チームが Azure DevOps Services を使用している場合、そのメンバーは Azure アカウントを使用して TeamCity にサインインできるようになりました。

TeamCity サーバーでこの機能を有効にするには:

  1. こちらで説明されているように、Azure DevOps Services インスタンスへの OAuth 2.0 接続を構成します。

  2. 管理 | 認証Azure DevOps OAuth 2.0 モジュールを有効にします。 アクセスをさらに保護するために、メンバーが TeamCity にアクセスできる Azure 組織の範囲を制限できます:

Azure での認証の構成

これで、ユーザーはログインページの Azure アイコンをクリックして認証を確認することで、TeamCity にサインインできるようになります。

ユーザーインターフェースの改善

バージョン 2021.2 では、次の TeamCity UI の改善が追加されました:

  • ユーザーアバターの表示

  • 実験的な UI の 保留中の変更と変更の詳細を表示

  • 実験的な UI の ビルドチェーングラフでプロジェクトごとにビルドをグループ化する機能

ユーザーアバターの表示

従来の UI と実験的な UI の両方で、ユーザーアバターがユーザー名の横に表示されるようになりました。 視覚的なアイコンは、コミットの作成者をすばやく識別できます。

TeamCity でのユーザーアバターの表示

ユーザープロファイル設定でアバターをアップロードできます。

変更を表示するための実験的 UI

保留中の変更 タブと単一の 変更 ページが新しい UI で完全に再現されました。 クラシックページの見慣れたレイアウトを備えながら、より優れたルック&フィールを提供します。

保留中の変更 ページには、最後に成功したビルド以降にリモートリポジトリにコミットされた変更のリストが表示されます。

新しい保留中の変更タブ

個別の 変更 ページでは、各変更に関する詳細情報を表示し、失敗したテストのリストと、この変更が導入されたときに発生したビルドの問題を表示できます。

新しい変更ページ

実験的なビルドチェーングラフでプロジェクトごとにビルドをグループ化する

実験的なビルドチェーングラフで、プロジェクトごとにビルドをグループ化できるようになりました。 これにより、大規模なパイプラインの概要を簡単に把握できます。

このオプションを試すには、 チェーンの一部であるビルドの結果を開き、 依存関係 タブに移動して、 チェーン モードに切り替えます。

チェーンのプロジェクトによるグループビルド

その他の改善

OpenSSH キーのサポート

TeamCity は、ECDSA や ED25519 を含む OpenSSH 形式の鍵をサポートするようになりました。 このような鍵を TeamCity にアップロードし、 VCS ルートを構成するとき、またはビルド中に SSH エージェントを実行するときに再利用できます。

この形式のサポートは、バグ修正ビルド TeamCity 2021.1.4 でも導入されています。

Kotlin DSL の更新

型指定された Kotlin DSL が、プロジェクトやビルド構成のさまざまな設定でサポートされるようになりました。 改善点の完全なリストについては、 こちら(英語)を参照してください。

セカンダリノードでビルドキューを一時停止および再開する

マルチノード設定では、セカンダリノードの機能はメインノードに比べて制限されていますが、最終的には同等の機能を実現できるように努めています。 このリリースでは、セカンダリノードでビルドキューを一時停止および再開できるようになりました。

選択した依存関係ビルドにパラメーターを渡す

TeamCity では、ビルドパラメーターをチェーンの上流に渡すことができます。つまり、チェーン内の後続のビルドが先行するビルドのプロパティをオーバーライドできます。 これにより、柔軟で適応性のあるパイプラインを構成できます。 柔軟性をさらに高めるため、逆方向パラメーターの構文を拡張してビルド ID マスクをサポートしました。

以前は、特定のビルドでのみ、または以前のすべてのビルドで一度にプロパティを再定義することが可能でした。 ID に共通の接頭辞または接尾辞がある場合、ターゲットビルドのセットを指定できるようになりました。

reverse.dep.[prefix]*[suffix].<プロパティ名>

ここで、 プレフィックス はターゲットビルドの ID の開始に対応し、 サフィックス はそれらの終了に対応します。

この構文についてさらに読む

ARM64 で PowerShell を自動検出する

TeamCity は、推奨される場所 ~/powershell/opt/microsoft/powershell/<バージョン>/ をチェックすることで、ARM64 システムで PowerShell を自動的に検出できるようになりました。 このスコープにカスタムの場所を追加するには、ここで説明するように、特別なエージェントプロパティを設定できます。

Cookie による API アクセスの簡素化

外部 HTTP クライアントから TeamCity にアクセスするために Cookie を無効化する必要はなくなりました。
以前は、Cookie を有効にした状態で API リクエストを送信する場合、アクセストークンと CSRF トークン の両方を渡す必要がありました。 現在は、認証用のアクセストークンを送信するだけで十分です。

CSP ヘッダーのカスタマイズの簡素化

TeamCity からの不明な外部リソースのダウンロードを禁止する Content Security Policy (CSP) ヘッダーをカスタマイズするには、完全なヘッダー値を指定する必要はなく、カスタム部分のみを指定すれば十分です。 完全な値が提供されている場合、異なる部分のみが適用されます。

修正された課題

TeamCity 2021.2 リリースノートを参照してください。

アップグレードノート

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

以前のリリース

ロードマップ

今後の更新について詳しく見るには、 TeamCity ロードマップを参照してください。

2026 年 9 月 11 日