Ant
Ant ビルドランナーは Ant build.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 ツールを指定できます(以下を参照)。 |
ant-net-tasks ツール
Ant ビルドランナーには、FTP、sshexec、scp、メールなどのネットワークタスクに必要な jar ファイルを含むバンドルツール ant-net-tasks が付属しています。
また、REST リクエストに使用できる欠落リンク Ant タスク(英語)も含まれています。
ツールを使用するには、ランナー設定の追加の Ant コマンドラインパラメーターで -lib "%teamcity.tool.ant-net-tasks%" を指定します。
Java パラメーター
- JDK
JDK を選択してください。このセクションは利用可能なオプションを詳しく述べています。デフォルトは
JAVA_HOME環境変数またはエージェント自身の Java です。- JDK ホームパス
このオプションは、上で <カスタム> を選択した場合に使用できます。このフィールドを使用して、ビルドの実行に使用するカスタム JDK へのパスを指定します。このフィールドを空白のままにすると、JDK ホームへのパスは、エージェントマシンの
JAVA_HOME環境変数から、またはビルドエージェント構成ファイル (buildAgent.properties) で指定されたenv.JAVA_HOMEプロパティから読み取られます。これらの値が指定されていない場合、TeamCity はビルドエージェントプロセス自体の Java ホームを使用します。- JVM コマンドラインパラメーター
追加の JVM コマンドラインパラメーターを使用すると、初期および最大ヒープサイズの設定、追加のログの有効化、必要なバイトコード検証モードの選択などを行うことができます。
標準 (
-で始まる、たとえば-verbose:[class|module|gc|jni]または--dry-run) と非標準 (-Xで始まる、たとえば-Xmx<size>または-XstartOnFirstThread) の両方の JVM オプションを指定できます。複数のコマンドラインパラメーターを指定するには、区切り文字としてスペースを使用します。例:
-verbose:gc -Xdiag -Xcomp -Xmx512m -Xms256m
テストパラメーター
テストの並べ替えは次のように機能します。TeamCity は、最初に実行するテスト(テストクラス)を提供し、その後、JUnit タスクが開始されると、これらのテストが含まれているかどうかを確認します。少なくとも 1 つのテストが含まれている場合、TeamCity は含まれているテストのみを含む新しいファイルセットを生成し、他のすべてのファイルセットの前に処理します。また、他のファイルセットにパッチを適用して、自動生成されたファイルセットに追加されたテストを除外します。その後、通常どおり JUnit が起動して実行されます。
オプション | 説明 |
|---|---|
テスト失敗のフィードバック時間を短縮します。 | 次の 2 つのオプションを使用して、TeamCity にいくつかのテストを実行するように指示します。
|
Docker の設定
このセクションでは、ビルドステップの実行に使用される Docker イメージを指定できます。
コードカバレッジ
コードカバレッジオプションの設定については、Java コードカバレッジの設定ページを参照してください。
JUnit 5 のサポート
TeamCity Ant ランナーでは、現在、これらのテストが <junitlauncher> タスクで宣言されている場合、テストビルド結果タブにテストが表示されません。代わりに <junit> タスクを使用するか、プロジェクトを Gradle に移行してください (TeamCity Gradle ランナーは JUnit 5 を完全にサポートしています)。
関連ページ:
ビルドパラメーターの設定
パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型:TeamCity は次の 3 種類のパラメーターをサポートします。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...
作業ディレクトリを構築する
ビルド作業ディレクトリは、ビルドプロセスの現在のディレクトリとして設定されるディレクトリです。デフォルトでは、これはビルドチェックアウトディレクトリと同じディレクトリです。ビルドスクリプトをチェックアウトディレクトリ以外の場所から実行する必要がある場合は、ビルドステップ設定の拡張オプションの作業ディレクトリフィールドを使用して場所を明示的に指定できます。作業ディレクトリフィールドに入力されるパスは、絶対パスまたはビルドチェックアウトディレクトリからの相対パスのいずれかです。このオプションを使用す...
Gradle
このビルドステップは、Gradle プロジェクトのビルドに合わせて調整されており、およびを含むすべての Gradle ビルド構成をサポートします。前提条件:Gradle でビルドを実行するには、Gradle 0.9-rc-1 以降がすべてのエージェントマシンにインストールされている必要があります。あるいは、Gradle ラッパーを使用する場合は、バージョン管理にチェックインされた Gradle ラッパースクリプトを適切に構成する必要があります。ステップ設定:Gradle ステップ設定のリストと...
レシピ YAML 構文
このドキュメントでは、YAML レシピの一般的な構文について説明します。カスタム YAML レシピを作成するには、.yml 定義ファイルを作成し、TeamCity (プロジェクト設定 | レシピ | プライベートレシピをアップロード) にアップロードしてください。共通レシピ構造:TeamCity YAML レシピの構造は次のとおりです。name: myorg/recipe-name title: The recipe title version: 1.2.3 description: The reci...