Tough Day tough-day

Tough Day 2 とは what-is-tough-day

Tough Day 2 は、AEMインスタンスの制限をストレステストできるアプリケーションです。 デフォルトのテストスイートですぐに使用できる状態にすることも、テストのニーズに合わせて設定することもできます。 ご覧いただけます この録画 アプリのプレゼンテーション用。

Tough Day 2 の実行方法 how-to-run-tough-day

アドビのリポジトリから最新バージョンの Tough Day 2 をダウンロードします。アプリケーションをダウンロードしたら、host パラメーターを指定することでアプリケーションをそのまま実行できます。次の例では、AEM インスタンスがローカルで実行されているので、値 localhost が使用されています。

java -jar toughday2.jar --host=localhost

パラメーターを追加した後に実行されるデフォルトスイートの名前は toughday です。次の使用例が含まれます。

このスイートには 15 %の書き込みアクションと 85 %の読み取りアクションが含まれます。

スイートのテストを実行するために、Tough Day 2 によってデフォルトのコンテンツパッケージがインストールされます。この動作はinstallsamplecontentパラメーターをfalseに設定することで回避できます。ただし、実行するテストのデフォルトパスを変更することも必要になります。パラメーターを指定せずに jar を実行した場合は、Tough Day 2 でヘルプ情報が表示されます。

原則として、アプリケーションを使用するには、次のパターンに従います。

java -jar toughday2.jar [--help | --help_full | --help_tests | --help_publish]  [<global arguments> | <actions> | --runmode | --publishmode]

ヘルプの表示 getting-help

Tough Day 2 には、コマンドラインからアクセスできる様々なヘルプオプションが用意されています。 次に例を示します。

java -jar toughday2.jar --help_full

次の表に、関連するヘルプパラメーターを示します。

グローバルパラメーター global-parameters

Tough Day 2 では、テストの環境を設定または変更するグローバルパラメーターを提供します。 これには、ターゲットとなるホスト、ポート番号、使用するプロトコル、インスタンスのユーザーとパスワードなどが含まれます。 次に例を示します。

java -jar toughday2.jar --host=host --protocol=https --port=4502 --duration=30m --dryrun=true

次のリストに、関連するパラメーターが表示されます。

カスタマイズ customizing

カスタマイズは、次の 2 つの方法で実行できます。コマンドラインパラメータまたは yaml 設定ファイル。 設定ファイルは、通常、大規模なカスタムスイートで使用され、Tough Day 2 のデフォルトパラメーターを上書きします。 コマンドラインパラメータは、設定ファイルとデフォルトパラメータの両方を上書きします。

テスト設定を保存するには、yaml 形式でコピーする方法しかありません。詳しくは、この toughday.yaml 設定と、以降のセクションの yaml 設定の例を参照してください。

新規テストの追加 adding-a-new-test

デフォルトの toughday スイートを使用しない場合は、add パラメーターを使用して任意のテストを追加できます。コマンドラインパラメーターまたは yaml 設定ファイルを使用して CreateAssetTreeTest テストを追加する方法を以下の例に示します。

コマンドラインパラメータを使用する：

java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest

yaml 設定ファイルを使用すると、次のことができます。

globals:
  host : localhost
tests:
  - add : CreateAssetTreeTest

同じテストの複数のインスタンスの追加 adding-multiple-instances-of-the-same-test

同じテストの複数のインスタンスを追加して実行することもできますが、そのためにはそれぞれのインスタンスに一意の名前を付ける必要があります。コマンドラインパラメーターまたは yaml 設定ファイルを使用して同じテストの 2 つのインスタンスを追加する方法を以下の例に示します。

コマンドラインパラメータを使用する：

java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest name=FirstAssetTree --add CreateAssetTreeTest name=SecondAssetTree

yaml 設定ファイルを使用すると、次のことができます。

globals:
  host : localhost
tests:
  - add : CreateAssetTreeTest
    properties:
      name : FirstAssetTree
  - add : CreateAssetTreeTest
    properties:
      name : SecondAssetTree

テストプロパティの変更 changing-the-test-properties

1 つ以上のテストプロパティを変更する必要がある場合は、そのプロパティをコマンドラインまたは yaml 設定ファイルに追加できます。 使用可能なすべてのテストプロパティを表示するには、コマンドラインに --help <TestClass/PublisherClass> パラメーターを追加してください。次に例を示します。

java -jar toughday2.jar --help CreatePageTreeTest

yaml 設定ファイルによって Tough Day 2 のデフォルトのパラメーターが上書きされるので、コマンドラインパラメーターは設定ファイルとデフォルトの両方よりも優先されることに注意してください。

コマンドラインパラメーターまたは yaml 設定ファイルを使用して CreatePageTreeTest テストの template プロパティを変更する方法を以下の例に示します。

コマンドラインパラメータを使用する：

java -jar toughday2.jar --host=localhost --add CreatePageTreeTest template=/conf/toughday-templates/settings/wcm/templates/toughday-template

yaml 設定ファイルを使用すると、次のことができます。

globals:
  host : localhost
tests:
  - add : CreatePageTreeTest
    properties:
      template : /conf/toughday-templates/settings/wcm/templates/toughday-template

定義済みのテストスイートの操作 working-with-predefined-test-suites

事前定義済みのスイートにテストを追加する方法、事前定義済みのスイートの既存のテストを再設定および除外する方法を以下の例に示します。

事前定義済みのスイートに新しいテストを追加するには、add パラメーターを使用して、ターゲットとなる事前定義済みのスイートを指定します。

コマンドラインパラメータを使用する：

java -jar toughday2.jar --host=localhost --suite=toughday --add CreatePageTreeTest

yaml 設定ファイルを使用すると、次のことができます。

globals:
  host : localhost
  suite : toughday
tests:
  - add : CreatePageTreeTest

また、特定のスイート内の既存のテストは、config* *パラメーターを使用して再設定することもできます。スイート名とテストの実際の名前（テストクラス名ではありません）も指定する必要があることに注意してください。テスト名は、テストクラスの name プロパティで確認できます。テストプロパティの確認方法について詳しくは、テストプロパティの変更を参照してください。

以下の例では0、CreatePageTreeTest のデフォルトのアセットタイトル（名前は UploadAsset）を「NewAsset」に変更しています。

コマンドラインパラメータを使用する：

java -jar toughday2.jar --host=localhost --suite=toughday --config UploadAsset title=NewAsset

yaml 設定ファイルを使用すると、次のことができます。

globals:
  host : localhost
  suite : toughday
tests:
  - config : UploadAsset
    properties :
      title : NewAsset

さらに、exclude パラメーターを使用して、事前定義済みのスイートからテストを削除したり、デフォルトの設定から公開者を削除したりできます。スイート名とテストの実際の名前（テスト C lass 名ではありません）も指定する必要があることに注意してください。テスト名は、テストクラスの name プロパティで確認できます。以下の例では、（UploadAsset という名前の）CreatePageTreeTest テストを toughday スイートから削除しています。

コマンドラインパラメータを使用する：

java -jar toughday2.jar --host=localhost --suite=toughday --exclude UploadAsset

yaml 設定ファイルを使用すると、次のことができます。

globals:
  host : localhost
  suite : toughday
tests:
  - exclude : UploadAsset

実行モード run-modes

Tough Day 2 は、標準 ​モードと​ 定負荷 ​モードのいずれかで実行できます。

標準 ​実行モードには、次の 2 つのパラメーターがあります。

次の例は、コマンドラインを使用してパラメータを追加する方法を示しています。

java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest --runmode=normal concurrency=20

または、yaml 設定ファイルを使用します。

runmode:
  type : normal
  waittime : 300
  concurrency : 200

定負荷 ​実行モードは、通常実行モードとは異なり、一定数のスレッドではなく一定数の開始されたテスト実行を生成します。同じ名前の実行モードパラメーターを使用して負荷を設定できます。

テストの選択 test-selection

テストの選択プロセスはどちらの実行モードでも同じで、次のように進みます。すべてのテストには weight プロパティがあり、これによって、スレッドでの実行の可能性が決定します。例えば、テストが 2 つあり、一方の重みを 5、もう一方の重みを 10 とした場合、後者が実行される可能性は前者の 2 倍になります。

さらに、テストには count プロパティを指定できます。これにより、実行回数が指定の数に制限されます。この数を超えると、テストはそれ以上実行されません。 既に実行中のすべてのテストインスタンスは、設定どおりに実行を終了します。 次の例は、これらのパラメーターをコマンドラインまたは yaml 設定ファイルを使用して追加する方法を示しています。

java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest weight=5 --add CreatePageTreeTest weight=10 count=100 --runmode=normal concurrency=20

または

- add : CreateAssetTreeTest
    properties :
      name : UploadAsset
      weight : 5
      base : 3
      foldertitle : IAmAFolder
      assettitle : IAmAnAsset
      count : 100

ドライラン dry-run

ドライランは、指定されたすべての入力（コマンドラインパラメータまたは設定ファイル）を解析し、デフォルトと結合して結果を出力します。 どのテストも実行されません。

java -jar toughday2.jar --host=localhost --suite=toughday --add CreatePageTreeTest --dryrun=true

出力 output

Tough Day 2 は、テスト指標とログの両方を出力します。 詳しくは、次の節を参照してください。

指標のテスト test-metrics

Tough Day 2 は現在、評価可能な 9 つのテスト指標をレポートします。 指標と * シンボルは、正常に実行された後にのみ報告されます。

これらの指標は、（テストの追加と同様に）add パラメーターを使用して追加できる公開者を利用して記述されています。現在、次の 2 つのオプションがあります。

デフォルトでは、両方の公開者が有効になっています。

さらに、指標の報告には次の 2 つのモードがあります。

次の例は、コマンドラインまたは yaml 設定ファイルを使用して intervals パラメーターを設定する方法を示しています。

コマンドラインパラメータを使用する：

java -jar toughday2.jar --host=localhost --add CreatePageTreeTest --publishmode type=intervals interval=10s

yaml 設定ファイルを使用すると、次のことができます。

publishmode:
     type : intervals
     interval : 10s
     tests:
        -add : CreatePageTreeTest

ログ logging

Tough Day 2 では、Tough Day 2 を実行したディレクトリにログフォルダーが作成されます。このフォルダーには、次の 2 種類のログが含まれます。

ログは上書きされません。その後の実行では、既存のログにメッセージが追加されます。ログには複数のレベルがあります。詳しくは、 [loglevel parameter](/docs/experience-manager-64/developing/testing/tough-day.md#global-parameters)を参照してください。