艱難的第2天是一項應用程式,可讓您強制測試AEM執行個體的限制。 可透過預設測試套裝立即執行,或依您的測試需求設定。 您可以觀看此錄制以了解應用程式的演示。
從Adobe存放庫下載最新版的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]
艱難的第2天沒有清理步驟。 因此,建議在複製的測試執行個體上執行Tough Day 2 ,而非在主要生產執行個體上。 測試後應捨棄測試執行個體。
艱難的第2天提供了一系列可從命令行訪問的幫助選項。 例如:
java -jar toughday2.jar --help_full
在下表中,您可以找到相關的說明參數。
參數 | 說明 | 範例 |
--說明 | 打印全局資訊,例如:可用的動作、預先定義的套裝、執行模式和全域參數。 | |
—help_publish | 打印所有可用的發佈器。 | |
—help_tests | 打印測試類及其說明。 | |
—help_full | 列印上述所有項目,以及測試、發佈商和套裝元件。 | |
—help —runmode/publishmode type=<mode> | 列出有關指定運行模式或發佈模式的資訊。 | java -jar toughday2.jar —help —runmode type=constantload java -jar toughday2.jar —help —publishmode type=intervals |
—help —suite=<SuiteName> | 列出指定套裝的所有測試及其各自的可設定屬性。 | java -jar toughday2.jar —help —suite=get_tests |
—help —tag=<Tag> | 列出具有指定標籤的所有項目。 |
java -jar toughday2.jar —help —tag=publish |
—help <TestClass/PublisherClass> | 列出給定測試或發佈器的所有可配置屬性。 |
java -jar toughday2.jar — 幫助上傳PDFTest java -jar toughday2.jar — 幫助CSVPublisher |
艱難的第2天提供設定或變更測試環境的全域參數。 包括目標主機、埠號、使用的通訊協定、執行個體的使用者和密碼等。 例如:
java -jar toughday2.jar --host=host --protocol=https --port=4502 --duration=30m --dryrun=true
您可以在下列清單中找到相關參數:
參數 | 說明 | 預設值 | 可能的值 |
---|---|---|---|
--installsamplecontent=<Val> |
安裝或略過預設的Tough Day 2內容套件。 | true | true或false |
--protocol=<Val> |
用於主機的協定。 | http | http或https |
--host=<Val> |
要定位的主機名或IP。 | ||
--port=<Val> |
主機的埠。 | 4502 | |
--user=<Val> |
例項的使用者名稱。 | 管理員 | |
--password=<Val> |
給定用戶的密碼。 | 管理員 | |
--duration=<Val> |
測試的持續時間。 可以以(s)秒、(m)nites、(h)ours和(d)ays表示。 | 1d | |
--timeout=<Val> |
測試在中斷並標示為失敗之前的執行時間。 以秒為單位表示。 | 180 | |
--suite=<Val> |
值可以是預先定義之測試套裝的一或清單(以逗號區隔)。 | 強度 | |
--configfile=<Val> |
目標yaml配置檔案。 | ||
--contextpath=<Val> |
例項的內容路徑。 | ||
--loglevel=<Val> |
Tough Day 2引擎的日誌級別。 | 資訊 | 全部,調試,資訊,警告,錯誤,致命,關閉 |
--dryrun=<Val> |
如果為true,則列印產生的設定,且不會執行任何測試。 | false | true或false |
定制可以通過兩種方式實現:命令行參數或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
由於並行執行,實際的測試運行數將不完全等於count
參數中配置的量。 期望與運行線程數成比例的偏差(由concurrency parameter
控制)。
乾式執行會剖析所有指定的輸入(命令列參數或設定檔案),並將其與預設值合併,然後輸出結果。 它不執行任何測試。
java -jar toughday2.jar --host=localhost --suite=toughday --add CreatePageTreeTest --dryrun=true
艱難的第2天會輸出測試量度和記錄。 如需詳細資訊,請閱讀下列章節。
艱難的第2天目前報告9個您可評估的測試量度。 具有*符號的量度只會在成功執行後回報:
名稱 | 說明 |
---|---|
時間戳記 | 上次完成測試運行的時間戳。 |
已通過 | 成功執行的次數。 |
已失敗 | 失敗的運行數。 |
最小值(&A);ast; | 測試執行的最短持續時間。 |
Max* | 測試執行的最長持續時間。 |
中位數(&A);ast; | 所有測試執行的計算中位數持續時間。 |
平均* | 所有測試執行的計算平均持續時間。 |
StdDev* | 標準差。 |
90p* | 第90個百分位。 |
99p* | 第99個百分位。 |
99.9p* | 第99.9個百分位數。 |
實際吞吐量* | 運行數除以已用執行時間。 |
這些量度是在發佈者的協助下撰寫,可與add
參數一併新增(類似於新增測試)。 目前有兩個選項:
依預設,會啟用兩個發佈者。
此外,報告量度的模式有兩種:
以下示例說明如何在命令行或使用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的相同目錄中建立記錄檔資料夾。 此資料夾包含兩種記錄檔:
不會覆寫記錄檔,後續執行會將訊息附加至現有記錄檔。 記錄有數個層級,如需詳細資訊,請參閱 [loglevel parameter](/docs/experience-manager-64/developing/testing/tough-day.md#global-parameters)
。