フリースタイル・プロジェクトの構成
フリースタイル・プロジェクトを構成してビルド・ステップを追加し、Jenkins からテスト資産を実行する必要があります。
以下のタスクを完了しておく必要があります。
-
Jenkins プライマリー・サーバーに Rational® Performance Tester Jenkins プラグイン をインストールしている。 Jenkins プライマリー・サーバーにプラグインをインストールを参照してください。
-
Jenkins でエージェントを作成しました。 Agent の作成方法については、Jenkins 資料を参照してください。
-
Agent の作成時に「ラベル」フィールドに指定したラベルの名前をコピーしている。
-
Jenkins のフリースタイル・プロジェクトを作成します。
Jenkins からテストを実行 するには、Jenkins UI で特定のフィールドに値を指定する必要があります。 「名前」フィールドとともに最低限構成する必要のあるフィールドは、 「ワークスペース」、「プロジェクト」、「テスト・スイート名」、「構成ファイル」です。 それ以外のフィールドはオプションです。
例えば、test または schedule の実行のためのパラメーターが入っている構成ファイルの完全パスを「構成ファイル (Config File)」フィールドに指定する場合、「ワークスペース (Workspace)」フィールド、「プロジェクト (Project)」フィールド、および「テスト・スイート名 (Test Suite Name)」フィールドに値を指定する必要はありません。
- Jenkins の「フリースタイル」プロジェクトを開き、「構成」をクリックします。
- 「一般」タブで「このプロジェクトを実行できる場所の制限 (Restrict where this project can be run)」チェック・ボックスを選択して、「ラベル式 (Label Expression)」フィールドに Agent の作成時に提供したラベルの名前を入力する必要があります。
- ビルドタブをクリックして、それから「ビルド・ステップを追加」をクリックします。
- 「IBM Rational Performance Tester テストの実行」オプションをドロップダウン・リストから選択します。
-
以下の表を参照して、フィールドのテスト実行に関する詳細を指定してください。
以下の表に、Jenkins からテストを実行するために指定できる必須フィールドを示します。
フィールド 説明 構成ファイル testまたはscheduleの実行のパラメーターを含むファイルの完全パスを入力します。
例: C:¥Users¥IBM¥rationalsdp¥workspace¥Project1¥config.txt
Rational Performance Testerからの コマンド・ライン構成ファイルの作成方法について詳しくは、「関連情報」 セクションを参照してください。
Remember: 「構成ファイル」フィールドに構成ファイルの完全パスを指定すると、「ワークスペース」フィールド、「プロジェクト」フィールド、「テスト・スイート名」フィールドに 値を指定する必要はありません。名前 Jenkins ビルド・ステップの名前を入力します。
例: testrun1
「プロジェクト」 パフォーマンス・テスト資産を含むプロジェクトの名前を入力します。
例: testproj1
テスト・スイート名 プロジェクトに関連するパフォーマンス・テスト資産のファイル名を入力します。
例: test1.testsuite
ワークスペース Eclipse ワークスペースの完全パスを入力します。
例: C:/Users/IBM/rationalsdp/workspace1
以下の表に、Jenkins からテストを実行するために指定できるオプション・フィールドを示します。
フィールド 説明 カスタム・レポート形式ファイル デフォルトのレポートの代わりにエクスポートするレポートの ID を指定するには、 このフィールドを使用します。
複数のレポート ID はコンマで区切って指定できます。 Rational Performance Tester (「ウィンドウ」 > 「設定」 > 「テスト」 > 「パフォーマンス・テスト・レポート」 > 「レポートのエクスポート」) の 「設定」 に移動して、「レポート ID の表示」チェック・ボックスを選択して、 レポート ID を表示します。
「カスタム・レポート・フォーマット・ファイル (Custom Report Format Files)」フィールドを「エクスポートする統計レポート・データ・ファイル (Exported Statistical Report Data File)」フィールドまたは「html でエクスポートする統計レポート (Exported Statistical Report in html)」フィールドと一緒に使用する必要があります。
例えば http を「カスタム・レポート 形式ファイル」 フィールドに値として指定すると、「パフォーマンス・レポート」を エクスポートできます。
データ・セット・オーバーライド このフィールドを使用して、testまたはscheduleの実行中にデータ・セット値を置き換えます。
元のデータ・セットおよび新規のデータ・セットが同じ ワークスペース内に存在し、列名が同じであることを確認する必要があります。 「データ・セット・オーバーライド」フィールドに値を入力する場合、 データ・セットへのパスも含めてください。 「データ・セット・オーバーライド」 の値は、以下のフォーマットで指定してください。
/project_name/ds_path/original_ds.csv:/project_name/ds_path/new_ds.csv
例: /proj1/Datasets/ds1.csv:/proj1023/Datasets/new_ds1.csv
データ・セットの複数のパスをセミコロンで区切って追加することによって、異なるプロジェクトに保管されている複数のデータ・セットをオーバーライドできます。 testまたはscheduleの場合、デフォルト値は、テスト・エディターまたはスケジュール・エディターで指定されたデータ・セットです。
期間 レート・スケジュールのステージの期間を変更するには、このフィールドを使用します。
例: Stage1=10s, Stage2=3m
レート・スケジュールに存在するステージ番号を指定する必要があります。
Note: 「期間」 フィールドは、 レート・スケジュールの新規コピーを作成します。このコピーには、指定された 数の期間が含まれています。エクスポートされた HTTP テスト・ログ・ファイル (Exported HTTP Test log File) このフィールドを使用して、エクスポートされた HTTP テスト・ログを保管するための ファイル・ディレクトリー・パスを.txt フォーマットで指定できます。
例: C:/Users/Documents/Jenkins/logexp.txt
Note: 「エクスポートする HTTP テスト・ログ・ファイル (Exported HTTP Test log File)」に値を指定しないと、テスト実行のログは Jenkins の workspace/temp ディレクトリーに保管されません。エクスポートされた統計レポート・データ・ファイル コンマ区切り値 (CSV) フォーマットでエクスポートされたレポートを保管するために 使用できるディレクトリーへの完全パスを指定するには、このフィールドを使用します。
例: C:/Users/Documents/tests
Note: 「カスタム・レポート形式ファイル」 フィールドに値を指定しない場合、 Rational Performance Tester (「ウィンドウ」 > 「設定」 > 「テスト」 > 「パフォーマンス・テスト・レポート」 > 「レポートのエクスポート」) の 「設定」 で選択したレポートがエクスポートされます。エクスポートされた統計レポート形式 (Exported Statistical Report Format) このフィールドを使用して、エクスポートするレポートの形式を指定できます。
「エクスポートされた統計レポート・データ・ファイル」 フィールドとともに、以下のオプションを 1 つ以上使用する必要があります。-
simple.csv
-
full.csv
-
simple.json
-
full.json
-
csv
-
json
例: json。
コンマで区切って複数のレポート形式を追加 することができます。 json または csv フォーマットでレポートの シンプル・タイプとフル・タイプの両方をエクスポートする場合、フィールドには フォーマットとして json または csv を 指定できます。
レポートは、「エクスポートされた統計レポート・データ・ファイル」フィールドで指定された場所に保存されます。
Note: 「エクスポートされた統計レポートの形式」フィールドに指定された値は常に、製品に設定された「レポートのエクスポート」 オプション(「ウィンドウ」 > 「設定」 > 「テスト」 > 「パフォーマンス・テスト・レポート」 > 「レポートのエクスポート」)より優先されます。HTML のエクスポートされた統計レポート Web 分析結果のエクスポート先として使用できるディレクトリーへの完全パスを 指定するには、このフィールドを使用します。
結果は指定したディレクトリーにエクスポートされます。 Rational Performance Tester を使用せずに、Web ブラウザーで結果を分析できます。
例: C:/Users/Documents/Reports
Note: 「html でエクスポートする統計レポート (Exported Statistical Report in html)」フィールドを使用しないと、パフォーマンス・レポートは workspace/temp ディレクトリーに保管されます。履歴 テストまたはスケジュールの実行中に発生したすべてのイベントの記録を表示する場合、 このフィールドを使用します。
以下のいずれかのオプションを使用できます。-
jaeger: testまたはscheduleの実行中に、Jaeger UIにテスト・ログを送信します。Note: jaeger オプションを使用してテスト・ログを Jaeger UI に送信する前に、 コマンド・ラインを使用して環境変数として JAEGER_AGENT_HOST プロパティーを設定する必要があります。
-
testlog: testまたはscheduleの実行中に、テスト・ログを従来のテスト・ログとして Rational Performance Testerで送信します。
-
null: testまたはscheduleの実行中にテスト・ログをJaeger UIにも Rational Performance Testerにも送信しません。
例: jaeger
testまたはscheduleの実行中にテスト・ログを Rational Performance TesterおよびJaeger UIに送信するには、複数のオプションをコンマで区切って追加できます。
例: jaeger,testlog
Jaeger UI および Rational Performance Tester での テスト・ログの表示方法について詳しくは、関連情報セクションを参照してください。
IMSharedロケーション IMShared ディレクトリーへの完全パス (これがデフォルトの場所にない場合)。
例: D:¥Testtool¥IBM¥IBMIMShared
IMShared ディレクトリーのデフォルトの場所は、以下のとおりです。オペレーティング・システム ディレクトリーのデフォルト・パス Windows® C:\Program Files\IBM\IBMIMShared Linux™ /opt/IBM/IBMIMShared Mac /Application/IBM/IBMIMShared ラベル このフィールドを使用して、テスト実行の完了時にラベルをテスト結果に追加します。
例えば、label1、 label2 などです
複数のラベルをコンマで区切ってテスト結果に追加することができます。 テスト資産を実行すると、追加したラベルが Rational Performance Tester のパフォーマンス・レポートに表示されます。
Rational Test Automation Server の「結果 (Results)」ページに、特定のテスト資産の「Labels」フィールドに追加したラベルが以下の条件で表示されます。-
「実行後に結果を公開」を「常時」または 「プロンプト」と Rational Performance Tester (「ウィンドウ」 > 「設定」 > 「テスト」 > Rational Test Automation Server) の「設定」で設定した場合。
-
「Labels」フィールドを「Publish」フィールドと一緒に使用する場合。
Note: 「Labels」フィールドで二重引用符 ("") を使用してテストを実行しても、テスト結果のラベルには二重引用符が入りません。例えば、「ラベル」 フィールドに"100" usersという値を指定すると、テスト結果のラベルは100 usersと表示されます。
この問題を回避するには、 コマンド・ライン構成ファイルを作成して「構成ファイル」 フィールドを使用してテストを実行してください。
仮想ユーザーの数 test または schedule の 実行でのデフォルトの仮想ユーザー数をオーバーライドするには、 このフィールドを使用します。
schedule のデフォルトはスケジュール・エディターで指定されたユーザーの数で、test のデフォルトは 1 ユーザーです。
Note: 「仮想ユーザーの数」フィールドは、指定された数のユーザーを含む schedule の新規コピーを作成します。結果ファイルの上書き 同じ名前の結果ファイルを上書きするかどうかを決定するには、 このフィールドを選択またはクリアします。
このフィールドはデフォルトで選択されています。 そのためファイルは 上書きされ、同じファイル名が維持されます。
公開 このフィールドは、Jenins からRational Test Automation Server にテスト結果を公開するために使用します。
Remember: 「公開」フィールドを使用する前に、以下のいずれかの方法で Rational Test Automation Server のオフライン・ ユーザー・トークンを指定してください。-
コマンド・ライン・インターフェースを使用して、RTCP_OFFLINE_TOKEN 環境変数の 値を Rational Test Automation Server のオフライン ユーザー・トークンに指定する。
-
Rational Test Automation Server のオフライン・ ユーザー・トークンを Rational Performance Tester (「ウィンドウ」 > 「設定」 > 「テスト」 > 「Rational Test Automation Server」) の設定に指定する。
以下のいずれかの値を、 「公開」フィールドに使用してください。-
serverURL#project.name=name_of_the_project&teamspace.name=name_of_the _teamspace
-
serverURL#project.name=name_of_the_project&teamspace.alias=name_of_the _teamspace_alias
- no
no オプションは、結果を公開するように製品設定で指定されているが、公開したくない場合に役立ちます。
例: URL_OF_RationalTest_Server#project.name=test&teamspace.name=ts1
各項目の意味は次のとおりです。-
URL_OF_RationalTest_Serverは、Rational Test Automation ServerのURLです。
-
test は Rational Test Automation Server にプロジェクトの名前です。
-
ts1 はチーム・スペースの名前です。
ノート:-
異なるチーム・スペースに同じ名前のプロジェクトがある場合は、&teamspace.name=name_of_the _teamspaceオプションまたは&teamspace.alias=name_of_the_teamspace_aliasオプションのどちらかを追加する必要があります。
-
プロジェクトまたはチーム・スペースの名前に特殊文字が含まれている場合は、それを%<Hexvalue_of_special_character>で置き換える必要があります。
例えば、チーム・スペースの名前が Initial Team Space のときは、Intial%20Team%20Space と指定します。
ここで、%20はSpace文字の16進値です。
-
「公開」フィールドに指定された値は常に、製品設定の「結果」オプション(「ウィンドウ」 > 「設定」 > 「テスト」 > 「Rational Test Automation Server > 「結果」)よりも優先されます。
「コンソール出力 (Console Output)」ページの「レポート情報 (Reports information)」セクションには、レポートの名前と、その対応する URL が以下の条件で表示されます。- Rational Performance Testerの「設定」(「ウィンドウ」 > 「設定」 > 「テスト」 > 「Rational Test Automation Server)でRational Test Automation ServerのURLを構成した場合。
- Rational Performance Testerの「設定」(「ウィンドウ」 > 「設定」 > 「テスト」 > 「Rational Test Automation Server > 「結果」)で、「実行後に結果を公開」を「常時」または「プロンプト」に設定した場合。
- 「Publish」フィールドまたは「Publish」フィールドを「Publishreports」フィールドと一緒に使用した場合。
Publish_for このフィールドを使用して、テストの完了状況に基づいてテスト結果を Jenkins から Rational Test Automation Server に公開することができます。
「Publish_for」 フィールドは、 「公開」フィールドと併用してください。 複数のオプションは コンマで区切って追加できます。 「Publish_for」フィールドに 使用できるオプションは以下の通りです。-
ALL: このオプションは、テストの状況に関係なく使用することができます。
-
PASS: このオプションを使用して、合格したテストのテスト結果を公開することができます。
-
FAIL: このオプションを使用して、不合格になったテストのテスト結果を公開することができます。
-
ERROR: このオプションを使用して、エラーを含んでいたテストのテスト結果を公開することができます。
-
INCONCLUSIVE: このオプションを使用して、解決不能のテストのテスト結果を公開することができます。
サンプル: FAIL,ERROR
Publishreports このフィールドを使用して、Rational Test Automation Server> に特定の テスト結果を公開することができます。
「Publishreports」で使用できるオプションは、以下のとおりです。-
STATS
-
TESTLOG
例: STATS
「Publishreports」フィールドは、「公開」フィールドと一緒に使用する必要があります。 Publishreports値の先頭に!を付けると、 指定されたものを除くレポートを公開できます。
例: !STATS
レート このフィールドを使用して、レート・ランナー・グループのレートを変更します。
例: Rate Runner Group1=1/s, 3/m
ここで Rate Runner Group1 は、2 つのステージを持つレート・ランナー・グループの名前です。 最初のステージで必要なレートは 毎秒 1 回の反復で、2 番目のステージのレートは毎秒 3 回の反復です。ノート:- レート・ランナー・グループの名前は、レート・スケジュールでの名前に一致している必要があります。
- 「レート」フィールドでは、指定した数のレートを含むレート・スケジュールの新しいコピーが作成されます。
リソース・モニター・ラベルのオーバーライド 以下のいずれかのアクションを実行するには、このフィールドを使用します。-
Rational Performance Testerのスケジュール・エディターで 「サービスからのリソース・モニター」オプションが有効になっていない場合は、パフォーマンスscheduleの「サービスからのリソース・モニター」オプションを有効にします。
-
パフォーマンス・スケジュールで設定されたリソース・モニター・ソースを無視し、ラベル・マッチング・モード用に変更します。
-
パフォーマンス・スケジュールで設定された既存のリソース・モニター・ラベル・セットを置き換え、新しいリソース・モニター・ラベル・セットを使用してスケジュールを実行します。
Rational Test Automation Server でリソース・モニター・ソースを示す rm1 というラベルを追加した場合、次の例に示されているように値を指定し、データをソースから収集できます。
rm1
リソース・モニターのラベルにコンマ (,) が含まれている場合、値を指定するときに、1 つのコンマを 2 つのコンマで置き換える必要があります。 例えば、リソース・モニター・ソースに rm1,test というラベルを追加した場合、次の例に示されているように値を指定し、データをソースから収集する必要があります。
rm1,,test
ノート:-
このフィールドはレートまたは VU スケジュールを実行する場合にだけ使用してください。
-
コンマで区切って複数のリソース・モニター・ラベルを追加できます。
-
Rational Test Automation Server プロジェクトの「リソース・モニター」ページで、リソース・モニター・ラベルをリソース・モニター・ソースに追加する必要があります。
結果ファイル 結果ファイルに別の名前を指定するには、このフィールドを使用します。
結果ファイルは結果ディレクトリーに保管されます。 結果ファイルのデフォルト名は、タイム・スタンプが付加されたtestまたはschedule の名前です。
ユーザー・コメント レポートのユーザー・コメント行に表示するテキストを追加するには、このフィールドを使用します。
例: test run with dataset
Note: 「ユーザー・コメント」フィールドに 二重引用符 ("") を使用してテストを実行する場合、レポートのユーザー・コメント行には 二重引用符は含まれません。例えば、「ユーザー・コメント」フィールドに test run with "dataset"という値を指定すると、 レポートのユーザー・コメント行には test run with datasetと 表示されます。
この問題を回避するには、 コマンド・ライン構成ファイルを作成して「構成ファイル」 フィールドを使用してテストを実行してください。
Var ファイル 変数の名前と値のペアが含まれている XML ファイルの絶対パスを指定するには、このフィールドを使用します。
VM引数 このフィールドを使用して、Java プロセスの最大ヒープ・サイズを指定します。
複数の VM 引数はコンマで区切って追加できます。
-
- Optional: 「ビルド・ステップの追加 (Add build step)」を再度クリックし、同じジョブで複数のテストを実行するために次のテストの詳細を入力します。
- 「保存」をクリックします。