ビルド機能を追加する

ビルド機能は、追加の機能を有効にするために任意のビルド構成に追加できる機能です。例: ステータス発行者のコミットビルド機能は、コードファイルを保存する VCS に TeamCity ビルド結果を公開し、調査自動割り当ては最新の変更によってビルドが壊れたユーザーを識別し、これらの問題を解決するタスクを自動的に割り当てます。構成されたビルド機能は、削除することなくいつでも一時的に無効にできます。

TeamCity ビルドの特徴

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

AssemblyInfo パッチャー: AssemblyInfo.cs ファイルに手動でパッチを適用することなく、アセンブリにビルド番号を自動的に設定できます。詳細 ...
自動マージ: 必要なブランチのビルドを追跡し、ビルドが構成された条件を満たした場合 (たとえば、ビルドが成功した場合)、ターゲットブランチにマージします。詳細 ...
AWS 認証情報: TeamCity プロジェクトで構成された AWS 接続を共有して、ステップを構築します。詳細 ...
ビルド承認: 新しいビルドを開始するために承認が必要な TeamCity ユーザーを指定できます。詳細 ...
ビルドファイルクリーナー (Swabra): ビルド中に生成されたファイルをクリーンアップします。詳細 ...
ビルドキャッシュ: 以前に完了したビルドによって取得されたファイル (ダウンロードされた npm パッケージなど) をビルドが取得できるようにします。詳細 ...
ステータス発行者のコミット: ビルド段階と最終結果を外部システムにレポートします。詳細 ...
Docker レジストリ接続: ビルドの開始前に、ビルド構成で DockerHub またはその他のコンテナーレジストリに自動的にサインインできるようにします。詳細 ...
ファイル内容の置き換え: 正規表現を使用して、ビルドの開始前にテキストファイルの内容を置換し、ビルドの終了後にすべての変更をロールバックします。詳細 ...
空きディスク容量: ビルドを実行する前にビルドエージェントに十分な空きディスク容量があるかどうかを確認し、ない場合は古いビルドデータをクリーンアップします。詳細 ...
Golang: TeamCity での Go テスト結果のリアルタイムレポートと履歴を有効にします。詳細 ...
調査自動割り当て: ビルドの問題とテストの失敗を分析し、コミットがこれらの問題を引き起こした可能性のあるユーザーを特定します。詳細 ...
Jira クラウド統合: ビルドステータスをリアルタイムで Jira クラウドに直接レポートできます。詳細 ...
マトリックスビルド: 複数のパラメーターがそれぞれ複数の潜在的な値を持つマトリックスを設定できます。このようなビルド構成を実行すると、個々のパラメーターと値の組み合わせをテストする N 個の個別のビルドが生成されます。詳細 ...
通知: 必要なユーザーにビルドステータスとイベントをメールまたは Slack メッセージで通知します。詳細 ...
NuGet フィードクレデンシャル: ビルドが認証を必要とする NuGet フィードと対話できるようにします。詳細 ...
NuGet パッケージインデクサ: 追加の承認を必要とせずに、NuGet パッケージのインデックスを作成し、TeamCity リモートプライベートフィードに追加します。詳細 ...
パフォーマンスモニター: ビルドエージェントでのビルド実行中に、CPU、ディスク I/O、メモリ使用量に関する統計を取得できます。詳細 ...
プルリクエスト: ターゲットリポジトリブランチにまだマージされていない変更をビルドできます。詳細 ...
Ruby 環境コンフィギュレータ: 選択した Ruby インタープリターと gems bin ディレクトリをシステム PATH 環境変数に追加し、RVM インタープリターの場合は他の必要な環境変数を構成します。詳細 ...
Docker で実行: ビルド構成のすべてのステップを Docker/Podman コンテナー内で実行できます。コンテナーをサポートしないステップはコンテナー外で実行されます。詳細 ...
すべてのビルドステップをコンテナー内で実行する必要がない場合は、個々のビルドステップに対して同一の設定を構成することもできます。
並列テスト: 膨大な数のテストを小さなバッチに分割し、複数の TeamCity エージェントを使用して各バッチを実行します。詳細 ...
共有リソース: 共有外部 (CI サーバーへの) リソース (たとえば、接続数が制限されたテストデータベースやサーバー) を使用して、同時に実行されるビルドを制限できます。詳細 ...
SSH エージェント: ビルド中に、選択したアップロードされた SSH キーを使用して SSH エージェントを実行します。詳細 ...
VCS ラベリング: バージョン管理システムでビルドソースの自動および手動のラベル付け (タグ付け) を有効にします。詳細 ...
XML レポート処理: 外部ツールによって生成された XML レポートを解析し、結果をビルドページに表示します。詳細 ...

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

TeamCity UI 内

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

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

Kotlin DSL

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

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

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

REST API の使用

GET、POST、DELETE リクエストを /app/rest/buildTypes/<build_type_locator>/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>

既存の機能を無効にするには、true テキスト本文を含む PUT リクエストを /app/rest/buildTypes/<build-type-locator>/features/<ID>/disabled に送信します。

2025 年 8 月 05 日

関連ページ：

ステータス発行者のコミット

コミットステータスパブリッシャーは、TeamCity がコミットのビルドステータスを外部システムに自動的に送信できるようにするビルド機能です。この機能は、TeamCity にバンドルされたオープンソースプラグインとして実装されています。サポートされているシステム:GitHub(プルリクエストのビルドステータスもサポートされています)、GitLab、Azure DevOps(サポートされるステータス: 保留中、成功、失敗、エラー）、Bitbucket サーバーおよび Bitbucket クラウド、J...

調査自動割り当て

TeamCity は、ビルドの問題 (コンパイルエラーなど) とテストの失敗を分析し、コミットがこれらの問題を引き起こした可能性のあるユーザーを特定しようとします。テストが失敗した場合、TeamCity はこれらの潜在的に責任のあるユーザーを調査員として提案します。提案に加えて、同じヒューリスティックを使用して失敗したテストとビルドの問題の調査を自動的に割り当てる調査自動割り当てビルド機能を追加できるようになりました。調査員として割り当てられたユーザーには、管理ボタンの横に対応する通知が表示され...

AssemblyInfo パッチャー

AssemblyInfo パッチャービルド機能を使用すると、ファイルを手動でパッチしなくても、アセンブリにビルド番号を自動的に設定できます。このビルド機能を追加するときは、バージョン形式を指定するだけで済みます。TeamCity パラメーター参照を使用できます。AssemblyInfo Patcher は自動チェックアウトでのみ使用する必要があります。このビルド機能が構成されると、最初のビルドステップの前に実行されます。TeamCity は、まずビルドチェックアウトディレクトリにあるファイルの置換...

AWS 認証情報

AWS クレデンシャルビルド機能により、エージェントのビルド内から AWS 接続クレデンシャルにアクセスできるようになります。この機能を使用するには、プロジェクトで少なくとも 1 つの AWS 接続を構成する必要があります。この機能は、AWS CLI を使用してファイルを S3 バケットにアップロードするビルドに認証情報を提供する必要がある場合、AWS ECS タスクまたは AWS SDK に基づくカスタムコードを実行する必要がある場合に役立ちます。このような場合は、一時的な認証情報を使用すること...

ビルドキャッシュ

「ビルドキャッシュ」機能を使用すると、ビルド構成で、ビルド実行中に生成された特定のファイル (ダウンロードされた npm パッケージや Maven ローカルリポジトリアーティファクトなど) を公開できます。公開されたキャッシュは、公開した同じ構成または他の構成によって、後続のビルド中に再利用できます。この手法により、ビルドルーチンが最適化され、高速化されます。共通情報：パブリッシャーとコンシューマーをキャッシュするビルドキャッシュ機能を 2 つのモードのいずれかで動作するように設定できます。初期ビル...

Docker レジストリ接続

Docker レジストリ接続ビルド機能により、TeamCity はビルドの開始前に DockerHub またはその他のコンテナーレジストリに自動的にサインインできます。この機能を次の場所に追加します。TeamCity による Docker/Podman 操作 (たとえば、および) の監視と検出を許可します。ビルド前に認証されたレジストリに自動的にログインし、ビルド後にログアウトします。ローカル (Docker と Podman の両方) イメージをクリーンアップし、レジストリにプッシュ (Doc...