艱難的一天

艱難的第2天是什麼

「Tough Day 2」是一項應用程式，可讓您強調測試AEM例項的限制。 可透過預設測試套裝立即執行，或依您的測試需求設定。 您可以觀看此錄制以了解應用程式的演示。

如何執行艱難的第2天

從Adobe存放庫下載最新版的Tough Day 2。 下載應用程式後，可通過提供host參數以立即運行。 在下列範例中，AEM例項會在本機執行，因此會使用localhost值：

java -jar toughday2.jar --host=localhost

新增參數後執行的預設套裝名為toughday。 其包含下列使用案例：

• 建立頁面和其即時副本（包括轉出）
• 取得首頁
• 在querybuilder中執行查詢
• 建立資產階層
• 刪除資產

套裝包含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]

獲取幫助

艱難的第2天提供了一系列可從命令行訪問的幫助選項。 例如：

java -jar toughday2.jar --help_full

在下表中，您可以找到相關的說明參數。

全局參數

艱難的第2天提供設定或變更測試環境的全域參數。 包括目標主機、埠號、使用的通訊協定、執行個體的使用者和密碼等。 例如：

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

您可以在下列清單中找到相關參數：

自訂

定制可以通過兩種方式實現：命令行參數或yaml配置檔案。 組態檔通常用於大型自訂套裝，且會覆寫第2天的預設參數。命令行參數會覆蓋配置檔案和預設參數。

儲存測試設定的唯一方法是以yaml格式複製。 如需其他詳細資訊，請參閱以下各節中的此toughday.yaml配置和yaml配置示例。

新增測試

如果您不想使用預設的toughday套裝，可使用add參數來新增您選擇的測試。 以下示例說明如何使用命令行參數或yaml配置檔案添加CreateAssetTreeTest測試。

使用命令列參數：

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

使用yaml配置檔案：

globals:
  host : localhost
tests:
  - add : CreateAssetTreeTest

添加同一測試的多個實例

您也可以新增及執行相同測試的多個例項，但每個例項必須具有唯一的名稱。 以下範例說明如何使用命令列參數或yaml設定檔案，新增相同測試的兩個例項。

使用命令列參數：

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

更改測試屬性

如果需要更改一個或多個測試屬性，可將該屬性添加到命令行或yaml配置檔案。 要查看所有可用的測試屬性，請將--help <TestClass/PublisherClass>參數添加到命令行，例如：

java -jar toughday2.jar --help CreatePageTreeTest

請記住，yaml配置檔案將覆蓋第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

使用預先定義的測試套裝

下列範例說明如何將測試新增至預先定義的套裝，以及如何重新設定現有測試並從預先定義的套裝中排除。

您可以使用add參數並指定目標預先定義的套裝，將新測試新增至預先定義的套裝。

使用命令列參數：

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

使用yaml配置檔案：

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

也可使用config* *參數重新配置給定套件中的現有測試。 請注意，您還必須指定測試的套件名稱和實際名稱（而不是測試類名稱）。 您可以在測試類的name屬性中找到測試名稱。 有關如何查找測試屬性的詳細資訊，請參閱更改測試屬性部分。

在以下範例中，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屬性中找到測試名稱。 在以下範例中，會從toughday套裝中移除CreatePageTreeTest（名為UploadAsset）測試。

使用命令列參數：

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

使用yaml配置檔案：

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

執行模式

艱難的第2天可以以下列其中一種模式執行：normal​和​常數負載。

normal​運行模式有兩個參數：

• concurrency — 並發表示Tough Day 2為測試執行而建立的線程數。在這些執行緒上，會執行測試，直到持續時間已用完或不再執行測試為止。

• waittime — 同一線程上兩個連續測試執行之間的等待時間。值必須以毫秒錶示。

以下範例說明如何使用命令列來新增參數：

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

或使用yaml配置檔案：

runmode:
  type : normal
  waittime : 300
  concurrency : 200

常數負載​運行模式與常規運行模式不同，它通過生成常數數目的已啟動測試執行，而不是常數數目的線程。 可以使用具有相同名稱的運行模式參數來設定負載。

測試選擇

對於兩種運行模式，測試選擇過程都相同，其步驟如下：所有測試都有weight屬性，它決定執行緒的可能性。 例如，如果我們有兩項測試，一項的權重為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

排練

乾式執行會剖析所有指定的輸入（命令列參數或設定檔案），並將其與預設值合併，然後輸出結果。 它不執行任何測試。

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

輸出

艱難的第2天會輸出測試量度和記錄。 如需詳細資訊，請閱讀下列章節。

測試量度

艱難的第2天目前報告9個您可評估的測試量度。 具有​​*​符號的量度只有在成功執行後才會回報：

這些量度是在發佈者的協助下撰寫，可與add參數一併新增（類似於新增測試）。 目前有兩個選項：

• CSVPublisher — 輸出為CSV檔案。
• ConsolePublisher — 輸出會顯示在主控台中。

依預設，會啟用兩個發佈者。

此外，報告量度的模式有兩種：

• simple​發佈模式 — 報告從執行開始到發佈點的結果。
• intervals​發佈模式 — 報告指定時間範圍內的結果。 您可以使用​interval​發佈模式參數設定時間範圍。

以下示例說明如何在命令行或使用yaml配置檔案配置intervals參數。

使用命令列參數：

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

使用yaml配置檔案：

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

記錄

Tough Day 2會在您執行Tough Day 2的相同目錄中建立記錄檔資料夾。 此資料夾包含兩種記錄檔：

• toughday.log:包含與應用程式狀態、調試資訊和全局消息相關的消息。
• toughday_<testname>.log:與指定測試相關的訊息。

不會覆寫記錄檔，後續執行會將訊息附加至現有記錄檔。 記錄有數個層級，如需詳細資訊，請參閱 [loglevel parameter](/docs/experience-manager-65/sites-developing/tough-day.md#global-parameters)。

使用範例

已知問題

取得檔案