Windows以外のオペレーティングシステム向けにリモートテスト実行用の Tosca CI Client を設定する

このトピックは、Tricentisが近い将来に廃止する予定の従来の機能について説明します。廃止計画およびタイムラインに関する詳細情報については、この Tricentisナレッジベースの記事をご覧ください。

代替案については、トピックをチェックしてください。

Windows以外のオペレーティングシステムからテストを起動する場合は、 config.properties ファイルで Tosca Continuous Integration Client（Tosca CI Client）の動作を設定してください。

このファイルは /ToscaCI/Client にあります。%COMMANDER_HOME%ToscaCIJavaClient.jar ファイルと同じディレクトリに配置されていることを確認してください。

config.properties ファイルの形式は以下の通りです。

address=
username=
password=
considerexecutionresult=
resulttype=
reportintermediateresults=
pathtoresultfile=
pollinginterval=
ciclienttimeout=
                                                    

Tosca CI Client の動作をカスタマイズするには、 = の後に新しい値を入力します（下の例を参照してください）。

「 dexpollinginterval 」プロパティおよび「 ciclienttimeout 」プロパティは無視してください。これらのプロパティは、Windows以外のオペレーティングシステムから Tosca Distributed Execution を使用してテストを実行する場合にのみ適用されます。

Remote Service 経由でテストを実行する場合は、以下の項目が設定できます。

設定	説明	オプション
address	Remote Service のエンドポイントを定義します。 appsettings.file ファイルの「 system.serviceModel 」セクションで指定したものと同じエンドポイントアドレスを入力します。ホスト名は、 Remote Execution Service をホストするマシンのIPアドレスに置き換えてください。
username	テストの実行のために Tosca CI Client を認証します。クライアント認証用に Remote Execution Service を設定している場合、この設定は必須です。 appsettings.file ファイルで指定した値と同じ値を入力します。
password	AuthenticationUsername のパスワードです。クライアント認証用に Remote Execution Service を設定している場合、この設定は必須です。 appsettings.file ファイルで指定した値と同じ値を入力します。
reportintermediateresults	テストラン実行終了時の要約結果に加えて、各ExecutionEntryの実行後に結果を受け取るかどうかを指定します。デフォルトではこの設定はオフになっています。つまり、False に設定されています。オフの場合、 Tosca CI Client はテストラン実行終了時に要約結果のみを返します。
pollinginterval	この設定は、「 ReportIntermediateResults 」が True に設定されている場合にのみ適用されます。 Tosca CI Client が Tosca Distribution Server から結果を要求する間隔をミリ秒単位で指定します。
ciclienttimeout	この設定は、「 ReportIntermediateResults 」が True に設定されている場合にのみ適用されます。 Tosca CI Client が Tosca Distribution Server からの応答を待機する時間をミリ秒単位で指定します。 Tosca CI Client がこの時間内に Tosca Distribution Server から応答を受け取らなかった場合、実行を中止し、キューからリクエストを削除します。「 CiClientTimeout 」で定義した時間は、「 PollingInterval 」の値以上の長さである必要があります。もし短い場合、システムは自動的に「 PollingInterval 」の値を使用します。デフォルト値は 36000000 です。
considerexecutionresult	ビルドサーバがテストの成否を示す終了コードが必要とする場合、この設定の値を True に設定します。終了コードは、テストが成功したか失敗したか、あるいは1つ以上のExecutionEntriesに対して結果がなかったかをビルドサーバーに通知します。成功: 終了コード 0 失敗: 終了コード -1 ExecutionEntriesの結果なし: 終了コード -2このコードは、「 ReportIntermediateResults 」が True に設定されている場合に適用されます。	X
resulttype	テスト結果の構造を定義します。「 ReportIntermediateResults 」が True の場合、 Junit のみが可能な結果タイプになります。	X
pathtoresultfile	Tosca CI Client 上の result.xml ファイルへのパスを定義します。ビルドサーバはこのファイルをインポートしてテスト結果を表示します。特定のテストの実行時に指定されたパスを使用したくない場合、呼び出しパラメータ -r を使用してこの設定を上書きできます。	X

例

以下の例では、次の動作をするよう設定しています。

Remote Service のエンドポイントは http://100.100.100.100:8732/TOSCARemoteExecutionService です。
Remote Execution Service は、ユーザー名 SampleAuthenticationUsername 、パスワード SamplePassword12345 で Tosca CI Client を実行するよう認証されています。
ビルドサーバは Tosca CI Client からの終了コードを期待します。
テスト結果の構造は Junit です。
Tosca CI Client は中間結果を出力します。
Tosca CI Client は、結果ファイルをパス SampleDirectory\\Result.xml に保存します。
Tosca CI Client は、350,000ミリ秒ごとに Tosca Distribution Server に結果を要求します。
Tosca CI Client は Tosca Distribution Server からの応答を36,000,000ミリ秒間待機します。その後、実行を中止します。

address=http://100.100.100.100:8732/TOSCARemoteExecutionService
username=SampleAuthenticationUsername
password=SamplePassword12345
considerexecutionresult=true
resulttype=Junit
reportintermediateresults=true
pathtoresultfile=SampleDirectory\\Result.xml
pollinginterval=350000
ciclienttimeout=36000000
                                                    