ビルド機能の追加

ビルド機能は、追加の機能を有効にするために任意のビルド構成に追加できる機能です。たとえば、コミットステータスパブリッシャービルド機能は、コードファイルを保存する VCS に TeamCity ビルド結果を公開し、調査の自動割り当ては最新の変更によってビルドを破損させたユーザーを特定して、これらの課題の解決を自動的にタスクとして割り当てます。構成されたビルド機能は、削除することなくいつでも一時的に無効にできます。

TeamCity のビルド機能

TeamCity には、構成に追加できる次のビルド機能が付属しています：

AssemblyInfo パッチャー

アセンブリにビルド番号を自動的に設定できます。AssemblyInfo.cs ファイルを手動でパッチする必要はありません。

詳細

自動マージ

必須ブランチのビルドをトラックし、ビルドが設定された条件 (たとえば、ビルドが成功した場合) を満たす場合はターゲットブランチにマージします。

詳細

AWS 資格情報

TeamCity プロジェクトで構成された AWS 接続をビルドステップに共有します。

詳細

ビルド承認

新しいビルドを開始するために承認が必要な TeamCity ユーザーを指定できます。

詳細

ビルドファイルクリーナー (Swabra)

ビルド中に生成されたファイルをクリーンアップします。

詳細

ビルドキャッシング

ビルドが、以前に完了したビルドによって取得されたファイルを取得できるようにします (たとえば、ダウンロードされた npm パッケージ。

詳細

ビルドスコープトークン

ビルドステップ内で VCS 側のリソースにアクセスするために使用できる短期間有効な VCS アクセストークンを発行します。

詳細

コミットステータスパブリッシャー

ビルドステージと最終結果を外部システムにレポートします。

詳細

Docker レジストリ接続

ビルド開始前に、ビルド構成が DockerHub またはその他のコンテナレジストリに自動的にサインインできるようにします。

詳細

ファイル内容置換

ビルド開始前に正規表現を使用してテキストファイルの内容を置換し、ビルド完了後にすべての変更をロールバックします。

詳細

空きディスク容量

ビルドを実行する前にビルドエージェントに十分な空きディスク容量があるかを確認し、不足している場合は古いビルドデータをクリーンアップします。

詳細

Go 言語

TeamCity で Go テスト結果のリアルタイムレポートと履歴を有効化します。

詳細

調査の自動割り当て

ビルドの問題とテストの失敗を分析し、これらの問題につながった可能性のあるコミットを行ったユーザーを特定します。

詳細

Jira Cloud 連携

ビルドステータスをリアルタイムで Jira Cloud に直接レポートできるようにします。

詳細

マトリックスビルド

複数のパラメーターがそれぞれ複数の候補値を持つマトリックスをセットアップできます。このようなビルド構成を実行すると、個々のパラメーター/値の組み合わせをテストする N 個の個別のビルドが生成されます。

詳細

通知

必要なユーザーにビルドステータスとイベントをメールまたは Slack メッセージで通知します。

詳細

NuGet フィード資格情報

認証が必要な NuGet フィードをビルドが操作できるようにします。

詳細

NuGet パッケージインデクサー

NuGet パッケージのインデックスを作成し、追加の認可なしで TeamCity のリモートプライベートフィードに追加します。

詳細

パフォーマンスモニター (既存)

ビルド中にエージェントハードウェアの使用箇所に関する統計を収集するよう設計された既存のビルド機能です。この機能は現在、すべてのビルド構成で自動的に有効化されています。

詳細

プルリクエスト

ターゲットリポジトリブランチにまだマージされていない変更をビルドできるようにします。

詳細

Ruby 環境コンフィギュレーター

選択した Ruby インタープリターと gem の bin ディレクトリをシステムの パス 環境変数に追加し、RVM インタープリターの場合はその他の必要な環境変数を構成します。

詳細

Docker で実行

ビルド構成のすべてのステップを Docker/Podman コンテナー内で実行できるようにします。コンテナをサポートしていないステップは、コンテナ外で実行されます。

詳細

並列テスト

大量のテストを小さなバッチに分割し、複数の TeamCity エージェントを使用して各バッチを実行します。

詳細

共有リソース

共有リソース (CI サーバーの外部) を使用して、同時に実行されるビルドを制限できるようにします (たとえば、テストデータベースや接続数が制限されたサーバー)。

詳細

SSH エージェント

ビルド中に、選択したアップロード済み SSH 鍵で SSH エージェントを実行します。

詳細

VCS ラベル付け

バージョン管理システム内のビルドソースに対する自動および手動のラベル付け (タグ付け) を有効化します。

詳細

XML レポート処理

外部ツールが生成した XML レポートを構文解析し、ビルドページに結果を表示します。

詳細

ビルド機能を追加、除去、無効化する方法

TeamCity UI で

「管理 | <プロジェクト> | <ビルド構成> 」に移動し、「ビルド機能」タブに切り替えます。
ビルド機能を追加をクリックし、リストから必要な機能を選択します。
必要な機能設定を指定し、保存をクリックします。

ビルド機能ページでは、構成されたビルド機能を一時的に無効にしたり、永続的に削除したりすることもできます。

Kotlin DSL で

対応する機能を承認ブロック (Kotlin DSL 内) に追加します。例: 次のサンプルでは、1 人のユーザーが新しい構成ビルドを承認することを必要とするビルド承認機能を追加します。

object MyBuildConfig : BuildType({
    // ...
   features {
       approval {
           approvalRules = "user:Valravn"
       }
   }
})

   

機能を構築する | Kotlin DSL ドキュメントも参照してください。

REST API の使用

GET、POST、DELETE リクエストを /app/rest/buildTypes/<ビルドタイプロケーター>/features エンドポイントに送信して、既存のビルド機能を取得および削除し、新しいビルド機能を追加します。

例: 次の本文を使用した POST リクエストは、プルリクエスト機能を構成に追加します。

{
    "type": "pullRequests",
    "properties": {
        "property": [
            { 
                "name": "providerType",
                "value": "github"
            },
                        { 
                "name": "ignoreDrafts",
                "value": "true"
            }
        ]
    }
}

     

<feature type="pullRequests">
    <properties count="2">
        <property name="ignoreDrafts" value="true"/>
        <property name="providerType" value="github"/>
    </properties>
</feature>

     

既存の機能を無効にするには、 真 テキスト本文を含む PUT リクエストを /アプリ/rest/ビルドタイプ/<ビルドタイプロケーター>/機能/<ID>/無効 に送信します。

2026 年 9 月 11 日