Tålig dag tough-day
Vad är Tom Dag 2? what-is-tough-day
Tough Day 2 är ett program som gör att du kan stresstesta gränserna för din AEM. Den kan köras direkt med testsviten eller konfigureras för att passa dina testbehov. Du kan titta den här inspelningen för en presentation av ansökan.
Köra Tough Day 2 how-to-run-tough-day
Ladda ned den senaste versionen av Tough Day 2 från Adobe-databas. När du har laddat ned programmet kan du köra det direkt genom att ange host
parameter. I följande exempel körs den AEM instansen lokalt så att localhost
värde används:
java -jar toughday2.jar --host=localhost
Standardsviten som körs när du lägger till parametrar får namnet toughday
. Det innehåller följande användningsfall:
- Skapa sidor och live-kopior för dem (inklusive rollouts)
- Hämta hemsida
- Köra frågor i Query Builder
- Skapa resurshierarkier
- Ta bort resurser
Programsviten innehåller 15 % skrivåtgärder och 85 % läsåtgärder.
För att köra testerna av sviten installerar Tough Day 2 standardinnehållspaketet. Detta kan undvikas genom att ställa in installsamplecontent
parameter till false
men kom ihåg att du också bör ändra standardsökvägarna för de tester som du tänker köra. Om burken körs utan parametrar visar Tough Day 2 hjälpinformation.
Som regel kan du använda programmet genom att följa det här mönstret:
java -jar toughday2.jar [--help | --help_full | --help_tests | --help_publish] [<global arguments> | <actions> | --runmode | --publishmode]
Få hjälp getting-help
Dag 2 erbjuder en mängd hjälpalternativ som du kan komma åt från kommandoraden. Till exempel:
java -jar toughday2.jar --help_full
I tabellen nedan hittar du relevanta hjälpparametrar.
Globala parametrar global-parameters
Tough Day 2 erbjuder globala parametrar som ställer in eller ändrar miljön för testerna. Bland dessa finns målvärden, portnummer, protokoll, användare och lösenord för instansen och många andra. Till exempel:
java -jar toughday2.jar --host=host --protocol=https --port=4502 --duration=30m --dryrun=true
Du hittar de relevanta parametrarna i listan nedan:
--installsamplecontent=<Val>
--protocol=<Val>
--host=<Val>
--port=<Val>
--user=<Val>
--password=<Val>
--duration=<Val>
--timeout=<Val>
--suite=<Val>
--configfile=<Val>
--contextpath=<Val>
--loglevel=<Val>
--dryrun=<Val>
Anpassa customizing
Anpassning kan göras på två sätt: kommandoradsparametrar eller dynamiska konfigurationsfiler. Konfigurationsfiler används vanligtvis för stora anpassade programsviter och de åsidosätter standardparametrarna för Tough Day 2. Kommandoradsparametrar åsidosätter både konfigurationsfiler och standardparametrar.
Det enda sättet att spara en testkonfiguration är att kopiera den i yaml-format. Mer information finns i toughday.yaml konfiguration och yaml-konfigurationsexempel i avsnitten nedan.
Lägga till ett nytt test adding-a-new-test
Om du inte vill använda standardinställningen toughday
du kan lägga till ett test med add
parameter. Exemplen nedan visar hur du lägger till CreateAssetTreeTest
testa antingen med kommandoradsparametrar eller en gul konfigurationsfil.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
tests:
- add : CreateAssetTreeTest
Lägga till flera instanser av samma test adding-multiple-instances-of-the-same-test
Du kan också lägga till och köra flera instanser av samma test, men varje instans måste ha ett unikt namn. I exemplen nedan visas hur du lägger till två instanser av samma test antingen med kommandoradsparametrar eller en gul konfigurationsfil.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest name=FirstAssetTree --add CreateAssetTreeTest name=SecondAssetTree
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
tests:
- add : CreateAssetTreeTest
properties:
name : FirstAssetTree
- add : CreateAssetTreeTest
properties:
name : SecondAssetTree
Ändra testegenskaper changing-the-test-properties
Om du behöver ändra en eller flera av testegenskaperna kan du lägga till den egenskapen på kommandoraden eller i yaml-konfigurationsfilen. Om du vill visa alla tillgängliga testegenskaper lägger du till --help <TestClass/PublisherClass>
parameter till kommandoraden, till exempel:
java -jar toughday2.jar --help CreatePageTreeTest
Tänk på att standardparametrarna Tough Day 2 skrivs över av standardkonfigurationsfilerna för Yaml och kommandoradsparametrarna åsidosätter både konfigurationsfilerna och standardvärdena.
Exemplen nedan visar hur du ändrar template
-egenskapen för CreatePageTreeTest
testa antingen med kommandoradsparametrar eller en gul konfigurationsfil.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --add CreatePageTreeTest template=/conf/toughday-templates/settings/wcm/templates/toughday-template
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
tests:
- add : CreatePageTreeTest
properties:
template : /conf/toughday-templates/settings/wcm/templates/toughday-template
Arbeta med fördefinierade testsviter working-with-predefined-test-suites
I exemplen nedan visas hur du lägger till ett test i en fördefinierad svit och hur du konfigurerar om och exkluderar ett befintligt test från en fördefinierad svit.
Du kan lägga till ett nytt test i en fördefinierad svit med add
och ange den fördefinierade målsviten.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --suite=toughday --add CreatePageTreeTest
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
suite : toughday
tests:
- add : CreatePageTreeTest
Befintliga tester i en viss programsvit kan även konfigureras om med config
* *parameter. Observera att du också måste ange namnet på programsviten och testets faktiska namn (inte testklassens namn). Testnamnet finns i name
egenskapen för klassen Test. Mer information om hur du söker efter testegenskaper finns i Ändra testegenskaper -avsnitt.
I exemplet nedan visas standardresursens namn för CreatePageTreeTest
(namngiven UploadAsset
) ändras till"NewAsset".
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --suite=toughday --config UploadAsset title=NewAsset
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
suite : toughday
tests:
- config : UploadAsset
properties :
title : NewAsset
Du kan även ta bort tester från fördefinierade sviter eller utgivare från standardkonfigurationen med hjälp av exclude
parameter. Observera att du också måste ange namnet på sviten och det faktiska namnet på testet (inte test C) lass
namn). Testnamnet finns i name
egenskapen för klassen test. I exemplet nedan är CreatePageTreeTest
(namngiven UploadAsset
)-testet tas bort från den tuffa sviten.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --suite=toughday --exclude UploadAsset
Genom att använda en dynamisk konfigurationsfil:
globals:
host : localhost
suite : toughday
tests:
- exclude : UploadAsset
Körningslägen run-modes
Dag 2 kan köras i något av följande lägen: normal och konstant belastning.
The normal körningsläget har två parametrar:
-
concurrency
- samtidig representerar antalet trådar som Tough Day 2 skapar för testkörning. På dessa trådar kommer tester att utföras tills antingen varaktigheten är slut eller tills det inte finns fler tester att köra. -
waittime
- väntetiden mellan två på varandra följande testkörningar i samma tråd. Värdet måste anges i millisekunder.
I exemplet nedan visas hur du lägger till parametrar med kommandoraden:
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest --runmode=normal concurrency=20
eller genom att använda en dynamisk konfigurationsfil:
runmode:
type : normal
waittime : 300
concurrency : 200
The konstant belastning körningsläget skiljer sig från det normala körningsläget genom att generera ett konstant antal startade testkörningar i stället för ett konstant antal trådar. Du kan ställa in inläsningen med parametern för körningsläge med samma namn.
Testa markering test-selection
Testmarkeringsprocessen är densamma för båda körningslägena och följande fungerar: alla tester har weight
som avgör sannolikheten för körning i en tråd. Om vi till exempel har två tester, ett med en vikt på 5 och det andra med en vikt på 10, är det två gånger mer troligt att det senare utförs än det första.
Dessutom kan tester ha en count
-egenskap, som begränsar antalet körningar till ett givet tal. När detta antal har passerats kommer inga fler testkörningar att utföras. Alla testinstanser som redan körs kommer att slutföra körningen enligt konfigurationen. I följande exempel visas hur du lägger till de här parametrarna antingen på kommandoraden eller med hjälp av en dynamisk konfigurationsfil.
java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest weight=5 --add CreatePageTreeTest weight=10 count=100 --runmode=normal concurrency=20
eller
- add : CreateAssetTreeTest
properties :
name : UploadAsset
weight : 5
base : 3
foldertitle : IAmAFolder
assettitle : IAmAnAsset
count : 100
count
parameter. Förväntade en avvikelse som är proportionerlig till antalet pågående trådar (styrs av concurrency parameter
).Torr körning dry-run
En torr körning tolkar alla angivna indata (kommandoradsparametrar eller konfigurationsfiler), sammanfogar dem med standardvärdena och returnerar sedan resultatet. Den utför inte något av testerna.
java -jar toughday2.jar --host=localhost --suite=toughday --add CreatePageTreeTest --dryrun=true
Utdata output
Dag 2 ger både testvärden och loggar. Mer information finns i följande avsnitt.
Testmått test-metrics
Tuff dag 2 rapporterar för närvarande 9 testvärden som du kan utvärdera. Mätvärden med * symbolen rapporteras endast efter lyckade körningar:
Dessa mätvärden skrivs med hjälp av utgivare som kan läggas till med add
parameter (på samma sätt som när du lägger till tester). Det finns för närvarande två alternativ:
- CSVPublisher - utdata är en CSV-fil.
- ConsolePublisher - utdata visas i konsolen.
Som standard är båda utgivare aktiverade.
Det finns dessutom två lägen där mätvärdena rapporteras:
- The enkel publiceringsläge - Rapporterar resultaten från körningens början till publiceringspunkten.
- The intervall publiceringsläge - Rapporterar resultaten i en given tidsram. Du kan ställa in tidsramen med intervall parameter för publiceringsläge.
I följande exempel visas hur du konfigurerar intervals
parametern antingen på kommandoraden eller med hjälp av en dynamisk konfigurationsfil.
Genom att använda kommandoradsparametrar:
java -jar toughday2.jar --host=localhost --add CreatePageTreeTest --publishmode type=intervals interval=10s
Genom att använda en dynamisk konfigurationsfil:
publishmode:
type : intervals
interval : 10s
tests:
-add : CreatePageTreeTest
Loggning logging
Tough Day 2 skapar en loggmapp i samma katalog som du körde Tough Day 2. Den här mappen innehåller två typer av loggar:
- toughday.log: innehåller meddelanden som rör programtillståndet, felsökningsinformation och globala meddelanden.
- toughday_<testname>.log: meddelanden relaterade till det angivna testet.
Loggarna skrivs inte över, efterföljande körningar lägger till meddelanden i befintliga loggar. Loggarna har flera nivåer. Mer information finns i [loglevel parameter](/docs/experience-manager-64/developing/testing/tough-day.md#global-parameters)
.