スタブ、テスト、またはスイートを実行する Maven スクリプトの生成
Integration Tester テスト実行プラグインを使用して、IBM® DevOps Test Integrations and APIs (Test Integrations and APIs) から Maven スクリプトを生成できます。 生成したスクリプトを使用すると、Maven ビルドでスタブ、テスト、またはスイートを実行できます。
プロジェクトを作成しておく必要があり、作成したプロジェクトを Test Integrations and APIs で開いておきます。
-
「ツール」メニューから「外部ツール構成の生成 (Generate External Tool Configuration)」を選択します。
「外部ツール構成の生成 (Generate External Tool Configuration)」ウィザードが表示されます。
-
「外部ツール構成の生成 (Generate External Tool Configuration)」ウィザードの「構成タイプおよび環境 (Configuration type and environment)」ウィンドウで、以下の手順を実行します。
- 「スタブ、テスト、またはスイートを実行するための Maven スクリプト (Maven script for executing stubs, tests, or suites)」を選択します。
- 選択したリソースが実行されるTest Integrations and APIs環境をリストから選択します。
- 「次へ」をクリックします。
「リソースの選択」ウィンドウが表示され、プロジェクト・リソース・ツリーが示されます。
-
「外部ツール構成の生成 (Generate External Tool Configuration)」ウィザードの「リソースの選択」ウィンドウで、以下の手順を実行します。
-
プロジェクト構成に組み込むスタブ、テスト、またはスイートを選択します。
注:複数の項目を選択するには、Ctrl キーまたは Shift キーを押したまま、テストまたはスイートをクリックします。
-
「名前」または「ID」のいずれかをクリックして、リソースの参照方法を選択します。
名前を使用すると、リソースをより簡単に識別できるという利点があります。 プロジェクトからリソースを削除して、同じ名前の別のリソースを作成すると、スクリプトは引き続き動作します。
ID を使用することを選択した場合は、プロジェクト内でリソースを名前変更または移動することができ、スクリプトは引き続き機能します。
注:「テスト・ファクトリー」パースペクティブで 1 つ以上のリソースを選択した場合は、それらのリソースがプロジェクト構成に組み込む対象として自動的に選択されます。 - 「次へ」をクリックします。
-
プロジェクト構成に組み込むスタブ、テスト、またはスイートを選択します。
-
「外部ツール構成の生成 (Generate External Tool Configuration)」ウィザードの「Maven POM オプション (Maven POM options)」ウィンドウで、以下の手順を実行します。
-
スクリプトを生成するための以下のいずれかのオプションを選択します。
- 「最小POMの使用(Use the minimal POM)」オプションを選択して、Test Integrations and APIs Mavenプラグインにより、Maven事統合前テスト・フェーズにおいて選択済みのスタブを開始すること、Maven統合テスト・フェーズにおいて統合テストを実行すること、Maven統合後テスト・フェーズで、既に開始されているスタブを停止することを可能にします。
- Maven で標準の Maven Failsafe プラグインを使用できるようにするには、「標準の Maven Failsafe プラグイン・ラッパーを使用 (Use the standard Maven Failsafe plugin wrapper)」オプションを選択します。 Maven では、このプラグインを使用して、Maven 統合テスト・フェーズ中に統合テストを実行します。 ただし、Maven では、Test Integrations and APIs Maven プラグインを使用して、Maven 統合前テスト・フェーズ中にスタブを実行し、Maven 統合後テスト・フェーズでこれらのスタブを停止します。
ライフサイクル・フェーズについての詳細は、Apache Maven の資料を参照してください。
-
「次へ」をクリックする。
「要約」ウィンドウが表示され、Maven プロジェクト構成ファイルの内容のプレビューが XML 形式で表示されます。
-
スクリプトを生成するための以下のいずれかのオプションを選択します。
-
「外部ツール構成の生成 (Generate External Tool Configuration)」ウィザードの「要約」ウィンドウで、以下の手順を実行します。
- 「参照」をクリックして場所を選択します。
-
ファイルの名前を入力します。
注:デフォルトでは、プロジェクト構成ファイルは XML ファイルとして保存されます。
-
「保存」をクリックします。
指定した名前のファイルが既に存在している場合は、以下のいずれかのオプションを実行することを選択できます。
- 同じ名前の既存ファイルを上書きするには、「確認」ダイアログで「はい」をクリックします。
- 新しいファイルを作成するには、「確認」ダイアログ・ボックスで「いいえ」をクリックし、ファイルに別の名前を入力してから、「保存」をクリックします。
-
「完了」をクリックします。
Test Integrations and APIs によって生成される Maven プロジェクト構成の例を次に示します。
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.mycompany</groupId> <artifactId>it-plugin-samples</artifactId> <version>0.0.1-SNAPSHOT</version> <!-- If the plugin artifacts referenced by the below version property were already installed in the local maven repository, run the maven goal 'versions:update-property -Dproperty=it-plugin-version' to discover new version from RTCP repository and update the version value. Otherwise, manually edit the property value derived from RTCP version (v9.1.1.1 or later) eg. 1.911.1 for RTCP v9.1.1.1, 1.920.0 for RTCP v9.2.0, .. --> <properties> <it-plugin-version>1.1001.0</it-plugin-version> </properties> <dependencies> <dependency> <groupId>com.hcl.products.test.it</groupId> <artifactId>it-plugin-boot</artifactId> <version>${it-plugin-version}</version> <scope>test</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>com.hcl.products.test.it</groupId> <artifactId>it-plugin</artifactId> <version>${it-plugin-version}</version> <configuration> <forkCount>0</forkCount> <properties> <property> <name>it_config_xml</name> <value> <![CDATA[ <projects> <project file="C:\Users\<user>\git\MyProjects\calculator\calculator.ghp" environment="UATest" run="calculator/Add/Test 1 plus 1 equals 2"/> </projects> ]]> </value> </property> </properties> </configuration> <executions> <execution> <goals> <goal>start-stubs</goal> <goal>run-tests</goal> <goal>stop-stubs</goal> </goals> </execution> </executions> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-failsafe-plugin</artifactId> <version>2.20</version> <executions> <execution> <goals> <goal>verify</goal> </goals> </execution> </executions> </plugin> </plugins> </build> <repositories> <repository> <id>rtcp-site</id> <url>https://localhost:5443/maven2</url> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>rtcp-site</id> <url>https://localhost:5443/maven2</url> </pluginRepository> </pluginRepositories> </project>
生成されたスクリプトが出力ファイルに保存されます。
スクリプトは、他のビルド・スクリプトと同様に Maven で実行できます。