Tough Day

Tough Day 2

Tough Day 2는 AEM 인스턴스의 한계를 테스트할 수 있는 애플리케이션입니다. 기본 테스트 세트로 즉시 실행하거나 테스트 요구 사항에 맞게 구성할 수 있습니다. 응용 프로그램 프레젠테이션을 보려면 이 녹음을 시청하십시오.

Tough Day 2를 실행하는 방법

Adobe 저장소에서 최신 버전의 Tough Day 2를 다운로드하십시오. 애플리케이션을 다운로드한 후에는 host 매개 변수를 제공하여 즉시 실행할 수 있습니다. 다음 예에서는 AEM 인스턴스가 로컬로 실행되어 localhost 값이 사용됩니다.

java -jar toughday2.jar --host=localhost

매개 변수를 추가한 후 실행되는 기본 세트의 이름은 toughday입니다. 여기에는 다음 사용 사례가 포함되어 있습니다.

  • 페이지 및 Live Copy 만들기(롤아웃 포함)
  • 홈 페이지 가져오기
  • 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]
노트

Tough Day 2 는 정리 단계를 포함하지 않습니다. 따라서 주 프로덕션 인스턴스가 아닌 복제된 스테이징 인스턴스에서 Tough Day 2를 실행하는 것이 좋습니다. 스테이징 인스턴스는 테스트 후에 삭제해야 합니다.

도움 받기

Tough Day 2는 명령줄에서 액세스할 수 있는 다양한 도움말 옵션을 제공합니다. 예:

java -jar toughday2.jar --help_full

아래 표에는 관련 도움말 매개 변수가 나와 있습니다.

매개 변수 설명
--도움말 다음과 같이 글로벌 정보를 인쇄합니다.사용 가능한 작업, 사전 정의된 세트, 실행 모드 및 글로벌 매개 변수.
—help_publish 사용 가능한 모든 게시자를 인쇄합니다.
—help_tests 테스트 클래스와 해당 설명을 인쇄합니다.
—help_full 위의 모든 것, 테스트, 게시자 및 세트 구성 요소를 인쇄합니다.
—help —runmode/publishmode type=<모드> 지정된 실행 또는 게시 모드에 대한 정보를 나열합니다.

java -jar touchday2.jar —help —runmode type=constantload

java -jar touchday2.jar —help —publishmode type=interval

—help —suite=<SuiteName> 지정된 세트의 모든 테스트 및 해당 구성 가능한 속성을 나열합니다.
java -jar touchday2.jar —help —suite=get_tests
—help —tag=<태그>
지정된 태그가 있는 모든 항목을 나열합니다.
java -jar touchday2.jar —help —tag=publish
—help <TestClass/PublisherClass>
지정된 테스트 또는 게시자에 대해 구성 가능한 모든 속성을 나열합니다.

java -jar toughday2.jar - help UploadPDFTest

java -jar toughday2.jar —help CSVPublisher

전역 매개 변수

Tough Day 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> 인스턴스에 대한 사용자 이름입니다. admin
--password=<Val> 지정된 사용자의 암호입니다. 관리
--duration=<Val> 테스트 기간입니다. 는 (s)초, (m)분, (h)시간 및 (d)일 단위로 표시할 수 있습니다. 1d
--timeout=<Val> 테스트가 중단되고 실패로 표시되기 전에 실행되는 기간입니다. 초 단위로 표시됩니다. 180
--suite=<Val> 이 값은 사전 정의된 테스트 세트의 하나 또는 목록(쉼표로 구분)일 수 있습니다. 인성
--configfile=<Val> 타깃팅된 YAML 구성 파일입니다.
--contextpath=<Val> 인스턴스의 컨텍스트 경로입니다.
--loglevel=<Val> Tough Day 2 엔진의 로그 수준입니다. 정보 모두, 디버그, 정보, 경고, 오류, 치명적, 해제
--dryrun=<Val> true이면 결과 구성을 인쇄하고 테스트를 실행하지 않습니다. false true 또는 false

사용자 지정

사용자 지정은 다음 두 가지 방법으로 수행할 수 있습니다.명령줄 매개 변수 또는 yaml 구성 파일 구성 파일은 일반적으로 큰 사용자 지정 세트에 사용되며 Tough Day 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 구성 파일은 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

사전 정의된 테스트 세트 작업

아래 예는 사전 정의된 세트에 테스트를 추가하는 방법과 사전 정의된 세트에서 기존 테스트를 다시 구성하고 제외하는 방법을 보여줍니다.

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 속성에서 테스트 이름을 찾을 수 있습니다. 아래 예에서는 CreatePageTreeTest (이름이 UploadAsset)인 테스트가 toughday suite에서 제거됩니다.

명령줄 매개 변수를 사용하여 다음을 수행합니다.

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

yaml 구성 파일을 사용하여 다음을 수행합니다.

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

실행 모드

Tough Day 2는 다음 모드 중 하나로 실행될 수 있습니다.normal상수 로드.

일반 실행 모드에는 두 개의 매개 변수가 있습니다.

  • concurrency - 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인 경우, 후자는 이전의 것보다 두 배 더 많이 실행될 가능성이 있습니다.

또한 테스트에는 지정된 수로 실행 횟수를 제한하는 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

출력

Tough Day 2는 테스트 지표와 로그를 모두 출력합니다. 자세한 내용은 다음 섹션을 참조하십시오.

테스트 지표

Tough Day 2 는 현재 사용자가 평가할 수 있는 9개의 테스트 지표를 보고합니다. &ast; 기호가 있는 지표는 성공적인 실행 후에만 보고됩니다.

이름 설명
Timestamp 마지막으로 완료된 테스트 실행의 타임스탬프입니다.
전달됨 성공한 실행 수입니다.
실패 실패한 실행 수입니다.
최소&ast; 테스트 실행 시간이 가장 짧습니다.
Max&ast; 테스트 실행 최대 기간입니다.
중간값(&M);ast; 모든 테스트 실행의 평균 기간을 계산했습니다.
Average&ast; 모든 테스트 실행의 계산된 평균 기간입니다.
StdDev&ast; 표준 편차.
90p&ast; 90번째 백분위수.
99p&ast; 99번째 백분위수.
99.9p&ast; 99.9백분위수.
실제 처리량;amp;ast; 경과된 실행 시간으로 나눈 실행 수입니다.

이러한 지표는 add 매개 변수로 추가할 수 있는 게시자의 도움을 받아 작성됩니다(테스트 추가와 유사). 현재, 다음 두 가지 옵션이 있습니다.

  • CSV 게시자 - 출력은 CSV 파일입니다.
  • ConsolePublisher - 출력이 콘솔에 표시됩니다.

기본적으로 두 게시자가 모두 활성화되어 있습니다.

또한 지표를 보고하는 두 가지 모드가 있습니다.

  • 단순 게시 모드 - 실행 시작부터 게시 지점까지의 결과를 보고합니다.
  • 간격 게시 모드 - 지정된 기간에 결과를 보고합니다. 간격 게시 모드 매개 변수를 사용하여 시간대를 설정할 수 있습니다.

다음 예에서는 명령줄에서 또는 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-64/sites-developing/tough-day.md#global-parameters) 을 참조하십시오.

이 페이지에서는