Ant
Ant ビルドランナーは Ant ビルド.xml ファイルを処理できます。
テストフレームワークのサポート
TeamCity Ant ランナーは JUnit および TestNG フレームワークをサポートしています。 スクリプト内で JUnit および TestNG タスクによってテストが直接実行されると、TeamCity はテストを即時にレポートします。
Ant スクリプトで <parallel> タグを使用すると、JUnit タスクと TestNG タスクを並行して実行することができます。 TeamCity はこれをサポートしており、並列プロセスを同時に正しくログに記録します。
レポートとログ
TeamCity は、実行されたアクティビティに関する詳細なデータを Ant から収集し、構造化されたエラーレポートを提供し、テストをレポートします。 ただし、特定のレポートを行わずにビルドを開始したり、TeamCity 固有のログをオフにしたりできます:
Ant で TeamCity 固有のレポートを無効にするには、
teamcity.ant.listener.enabled=falseビルド構成パラメーターを使用しますJUnit レポートを無効にするには、
teamcity.ant.junit-support.enabled=falseシステムプロパティを使用します。TestNG レポートを無効にするには、
teamcity.ant.testng-support.enabled=falseシステムプロパティを使用します。
Ant ランナー設定
Ant パラメーター
オプション | 説明 |
|---|---|
build.xml ファイルへのパス | オプションを選択した場合、プロジェクトの Ant ビルドスクリプトファイルへのパスを入力できます。 パスはプロジェクトのルートディレクトリからの相対パスです。 または、 |
ビルドファイルのコンテンツ | このオプションを選択した場合は、 ビルドファイルの内容を入力 リンクをクリックして、テキスト領域にカスタムビルドファイルのソースコードを入力します。 テキスト領域はサイズ変更可能であることに注意してください。 非表示 リンクを使用して、テキスト領域を閉じます。 |
作業ディレクトリ | ビルド作業ディレクトリがチェックアウトディレクトリと異なる場合は、ビルド作業ディレクトリを指定します。 |
ターゲット | このテキストフィールドを使用して、スペースで区切られた文字列のリストとして有効な Ant ターゲットを指定します。 使用可能なターゲットは、フィールドの横にあるアイコンをクリックして Web UI で表示し、適切なボックスをオンにして追加できます。 このフィールドを空のままにすると、ビルドスクリプトファイルで指定されたデフォルトのターゲットが実行されます。 |
Ant ホームパス | カスタム Ant の配布へのパスを指定します。 TeamCity にバンドルされている Ant ディストリビューションを使用する場合、このパラメーターを指定する必要はありません。 |
追加の Ant コマンドラインパラメーター | オプションで、追加のコマンドラインパラメーターをスペース区切りリストとして指定します。 たとえば、 ant-net-tasks ツールを指定できます (以下を参照)。 |
をクリックして、VCS リポジトリブラウザーを使用してファイルを選択します。ant-net-tasks ツール
Ant ビルドランナーには、ネットワークタスク (FTP、sshexec、scp、mail など) に必要な jar ファイルを含むバンドルツール ant-net-tasks が付属しています。
また、REST リクエストに使用できる missing link Ant タスク も含まれています。
ツールを使用するには、ランナー設定の 追加の Ant コマンドラインパラメーターで -lib "%teamcity.tool.ant-net-tasks%" を指定します。
Java パラメーター
- JDK
JDK を選択してください。 このセクションは利用可能なオプションを詳しく述べています。 デフォルトは
JAVA_HOME環境変数またはエージェント自身の Java です。- JDK ホームパス
上で <カスタム> が選択されている場合に、このオプションを使用できます。 このフィールドを使用して、ビルドの実行に使用するカスタム JDK へのパスを指定します。 フィールドが空白の場合、JDK Home へのパスは、エージェントマシン上の
JAVA_HOME環境変数、または ビルドエージェント構成ファイル (ビルドエージェント.プロパティ) で指定されたenv.JAVA_HOME 環境変数プロパティから読み取られます。 これらの値が指定されていない場合、TeamCity はビルドエージェントプロセス自体の Java ホームを使用します。- JVM コマンドラインパラメーター
追加の JVM コマンドラインパラメーターを使用すると、初期および最大ヒープサイズの設定、追加のログの有効化、必要なバイトコード検証モードの選択などを行うことができます。
標準 (
-で始まる、たとえば-verbose:[class|module|gc|jni]または--dry-run) と非標準 (-Xで始まる、たとえば-Xmx<サイズ>または-XstartOnFirstThread) の両方の JVM オプションを指定できます。複数のコマンドラインパラメーターを指定するには、区切り文字としてスペースを使用します。 例:
-verbose:gc -Xdiag -Xcomp -Xmx512m -Xms256m
テストパラメーター
テストの並べ替えは次のように機能します: TeamCity は最初に実行するテスト (テストクラス) を提供し、その後 JUnit タスクが開始されると、それらのテストが含まれているかどうかを確認します。 少なくとも一つのテストが含まれている場合、TeamCity は含まれているテストのみを含む新しいファイルセットを生成し、他のすべてのファイルセットより先に処理します。 また、他のファイルセットにパッチを適用して、自動生成されたファイルセットに追加されたテストを除外します。 その後、通常どおり JUnit が起動して実行されます。
オプション | 説明 |
|---|---|
テスト失敗のフィードバック時間を短縮します。 | 次の 2 つのオプションを使用して、TeamCity に一部のテストを他より先に実行するよう指示します。
|
Docker 設定
このセクションでは、 ビルドステップの実行に使用されるDocker イメージを指定できます。
コードカバレッジ
コードカバレッジオプションの構成について詳しく見るには、 Java コードカバレッジの構成 ページを参照してください。
JUnit 5 のサポート
TeamCity Ant ランナーでは現在、これらのテストが <JUnit ランチャー> タスクで宣言されている場合、"Tests" ビルド結果タブにテストが表示されません。 代わりに <JUnit> タスクを使用するか、プロジェクトを Gradle に移行してください (TeamCity Gradle ランナーは JUnit 5 を完全にサポートしています)。