Tough Day tough-day

Was ist Tough Day 2? what-is-tough-day

Tough Day 2 ist eine Anwendung, mit der Sie die Grenzen Ihrer AEM testen können. Sie kann mit der standardmäßigen Test-Suite vorkonfiguriert oder entsprechend Ihren Testanforderungen konfiguriert werden. Du kannst zusehen diese Aufzeichnung für eine Darstellung des Antrags.

Ausführen von Tough Day 2 how-to-run-tough-day

Laden Sie die aktuelle Version von Tough Day 2 aus dem Adobe-Repository herunter. Nach dem Download können Sie die Anwendung direkt ausführen. Sie müssen lediglich den Parameter host angeben. Beim folgenden Beispiel wird die AEM-Instanz lokal ausgeführt. Daher wird der Wert localhost verwendet:

java -jar toughday2.jar --host=localhost

Die Standard-Suite, die nach dem Hinzufügen des Parameters ausgeführt wird, heißt toughday. Es enthält die folgenden Anwendungsfälle:

Die Suite enthält 15 % Schreibaktionen und 85 % Leseaktionen.

Um die Suite-Tests auszuführen, installiert Tough Day 2 das Standard-Inhaltspaket. Um dies zu vermeiden, können Sie den Parameter installsamplecontent auf false festlegen. Denken Sie aber daran, auch die Standardpfade für die Tests zu ändern, die Sie ausführen möchten. Wenn die JAR ohne Parameter ausgeführt wird, zeigt Tough Day 2 die Hilfe-Informationen an.

Als allgemeine Regel können Sie die Anwendung verwenden, indem Sie diesem Muster folgen:

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

Hilfe erhalten getting-help

Tough Day 2 bietet eine breite Palette von Hilfeoptionen, auf die über die Befehlszeile zugegriffen werden kann. Beispiel:

java -jar toughday2.jar --help_full

In der folgenden Tabelle finden Sie die relevanten Hilfsparameter.

Globale Parameter global-parameters

Tough Day 2 bietet globale Parameter, die die Umgebung für die Tests festlegen oder ändern. Dazu gehören der Host, der als Ziel ausgewählt wird, die Portnummer, das verwendete Protokoll, der Benutzer und das Kennwort für die Instanz und vieles mehr. Beispiel:

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

Die relevanten Parameter finden Sie in der folgenden Liste:

Anpassen customizing

Die Anpassung kann auf zwei Arten erreicht werden: Befehlszeilenparameter oder YAML-Konfigurationsdateien. Konfigurationsdateien werden im Allgemeinen für große benutzerdefinierte Suites verwendet und überschreiben die Standardparameter von Tough Day 2. Befehlszeilenparameter überschreiben sowohl Konfigurationsdateien als auch die Standardparameter.

Die einzige Möglichkeit, eine Testkonfiguration zu speichern, besteht darin, sie in das YAML-Format zu kopieren. Weitere Informationen finden Sie in diesem toughday.yaml Konfiguration und Beispiele für die YAML-Konfiguration in den folgenden Abschnitten.

Hinzufügen eines neuen Tests adding-a-new-test

Wenn Sie die standardmäßige toughday-Suite nicht verwenden möchten, können Sie mit dem Parameter add einen Test Ihrer Wahl hinzufügen. Die folgenden Beispiele zeigen, wie Sie den Test CreateAssetTreeTest mit Befehlszeilenparametern oder mit einer YAML-Konfigurationsdatei hinzufügen.

Mithilfe von Befehlszeilenparametern:

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

Verwenden Sie eine YAML-Konfigurationsdatei:

globals:
  host : localhost
tests:
  - add : CreateAssetTreeTest

Hinzufügen mehrerer Instanzen desselben Tests adding-multiple-instances-of-the-same-test

Sie können auch mehrere Instanzen desselben Tests hinzufügen und ausführen. Dabei muss jedoch jede Instanz einen eindeutigen Namen aufweisen. Die folgenden Beispiele zeigen, wie Sie zwei Instanzen desselben Tests mit Befehlszeilenparametern oder mit einer YAML-Konfigurationsdatei hinzufügen.

Mithilfe von Befehlszeilenparametern:

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

Verwenden Sie eine YAML-Konfigurationsdatei:

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

Ändern der Testeigenschaften changing-the-test-properties

Falls Sie eine oder mehrere der Testeigenschaften ändern müssen, können Sie diese Eigenschaft der Befehlszeile oder der YAML-Konfigurationsdatei hinzufügen. Um alle verfügbaren Testeigenschaften anzuzeigen, fügen Sie den Parameter --help <TestClass/PublisherClass> zur Befehlszeile hinzu, z. B.:

java -jar toughday2.jar --help CreatePageTreeTest

Beachten Sie, dass die YAML-Konfigurationsdateien die Standardparameter von Tough Day 2 überschreiben und Befehlszeilenparameter sowohl die Konfigurationsdateien als auch die Standardparameter überschreiben.

Die folgenden Beispiele zeigen, wie Sie die Eigenschaft template für den Test CreatePageTreeTest mit Befehlszeilenparametern oder einer YAML-Konfigurationsdatei ändern.

Mithilfe von Befehlszeilenparametern:

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

Verwenden Sie eine YAML-Konfigurationsdatei:

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

Arbeiten mit vordefinierten Test-Suites working-with-predefined-test-suites

Die folgenden Beispiele zeigen, wie Sie einen Test zu einer vordefinierten Suite hinzufügen und einen vorhandenen Test neu konfigurieren und aus einer vordefinierten Suite ausschließen.

Um einen neuen Test zu einer vordefinierten Suite hinzuzufügen, verwenden Sie den Parameter add und geben die gewünschte Suite an.

Mithilfe von Befehlszeilenparametern:

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

Verwenden Sie eine YAML-Konfigurationsdatei:

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

Sie können vorhandene Tests in einer bestimmten Suite mit dem Parameter* *config auch neu konfigurieren. Beachten Sie, dass Sie auch den Namen der Suite und den tatsächlichen Namen des Tests (also nicht den Namen der Testklasse) angeben müssen. Den Testnamen finden Sie in der Eigenschaft name der Testklasse. Weitere Informationen zum Finden von Testeigenschaften finden Sie im Abschnitt Ändern von Testeigenschaften.

Im nachfolgenden Beispiel wird der Standardtitel des Assets für den Test CreatePageTreeTest (namens UploadAsset) in „NewAsset“ geändert.

Mithilfe von Befehlszeilenparametern:

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

Verwenden Sie eine YAML-Konfigurationsdatei:

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

Außerdem können Sie auch Tests aus vordefinierten Suites oder Herausgebern von der Standardkonfiguration entfernen. Dazu dient der Parameter exclude. Beachten Sie, dass Sie auch den Namen der Suite und den tatsächlichen Namen des Tests (also nicht den Namen der Testklasse) lass angeben müssen. Den Testnamen finden Sie in der Eigenschaft name der Testklasse. Im nachfolgenden Beispiel wird der Test CreatePageTreeTest (namens UploadAsset) von der Tough Day-Suite entfernt.

Mithilfe von Befehlszeilenparametern:

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

Verwenden Sie eine YAML-Konfigurationsdatei:

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

Ausführungsmodi run-modes

Bei Tough Day 2 stehen zwei Ausführungsmodi zur Verfügung: normal und constant load.

Für den Ausführungsmodus normal gibt es zwei Parameter:

Das folgende Beispiel zeigt, wie Sie die Parameter über die Befehlszeile hinzufügen:

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

oder mithilfe einer YAML-Konfigurationsdatei:

runmode:
  type : normal
  waittime : 300
  concurrency : 200

Der Ausführungsmodus constant load unterscheidet sich vom normalen Ausführungsmodus dadurch, dass er eine konstante Anzahl an gestarteten Testausführungen erzeugt statt einer konstanten Zahl an Threads. Sie können die Last über den Ausführungsmodus-Parameter „load“ festlegen.

Testauswahl test-selection

Der Testauswahlvorgang ist bei beiden Ausführungsmodi gleich und läuft wie folgt ab: Alle Tests verfügen über die Eigenschaft weight, die die Wahrscheinlichkeit der Ausführung in einem Thread bestimmt. Wenn es z. B. zwei Tests gibt, einen mit dem „weight“-Wert 5 und einen mit dem „weight“-Wert 10, ist die Wahrscheinlichkeit der Ausführung bei dem Test mit dem Wert 10 doppelt so hoch wie bei dem anderen Test.

Außerdem können Tests die Eigenschaft count aufweisen, die die Anzahl an Ausführungen auf eine bestimmte Zahl einschränkt. Nachdem diese Zahl erreicht wurde, werden keine weiteren Ausführungen des Tests durchgeführt. Alle Testinstanzen, die bereits ausgeführt werden, beenden die Ausführung wie konfiguriert. Das folgende Beispiel zeigt, wie Sie diese Parameter entweder in der Befehlszeile oder mithilfe einer YAML-Konfigurationsdatei hinzufügen.

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

oder

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

Probelauf dry-run

Ein Trockenlauf analysiert alle angegebenen Eingaben (Befehlszeilenparameter oder Konfigurationsdateien), führt sie mit den Standardwerten zusammen und gibt dann die Ergebnisse aus. Es werden keine der Tests ausgeführt.

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

Ausgabe output

Tough Day 2 gibt sowohl Testmetriken als auch Protokolle aus. Weitere Informationen finden Sie in den folgenden Abschnitten.

Testmetriken test-metrics

Tough Day 2 meldet derzeit 9 Testmetriken, die Sie auswerten können. Metriken mit der * -Symbol wird erst nach erfolgreichen Ausführungen gemeldet:

Diese Metriken werden mithilfe von Publishern geschrieben, die mit dem Parameter add hinzugefügt werden können (ähnlich wie beim Hinzufügen von Tests). Aktuell gibt es zwei Optionen:

Standardmäßig werden beide Herausgeber aktiviert.

Zusätzlich gibt es zwei Modi, bei denen die Metriken gemeldet werden:

Das folgende Beispiel zeigt, wie Sie den Parameter intervals mit der Befehlszeile oder mit einer YAML-Konfigurationsdatei konfigurieren.

Mithilfe von Befehlszeilenparametern:

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

Verwenden Sie eine YAML-Konfigurationsdatei:

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

Protokollierung logging

Tough Day 2 erstellt einen Protokollordner im selben Verzeichnis, in dem Sie Tough Day 2 ausgeführt haben. Dieser Ordner enthält zwei Typen von Protokollen:

Die Protokolle werden nicht überschrieben, nachfolgende Ausführungen hängen Meldungen an die vorhandenen Protokolle an. Für die Protokolle gibt es mehrere Ebenen. Weitere Informationen hierzu finden Sie unter [loglevel parameter](/docs/experience-manager-64/developing/testing/tough-day.md#global-parameters).