기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DLT CLI
DLT CLI를 사용하면 터미널에서 직접 AWS REST API의 분산 로드 테스트와 상호 작용할 수 있습니다. 이를 통해 로드 테스트를 스크립트로 자동화할 수 있으므로 반복 가능한 워크플로의 일부로 테스트 시나리오 및 쿼리 실행 결과를 나열, 검사 및 시작할 수 있습니다.
CLI는 DLT 웹 콘솔과 동일한 IAM 인증 API Gateway를 대상으로 하므로 브라우저 기반 인터페이스에서 사용할 수 있는 모든 작업은 동일한 기본 API 및 권한 모델을 사용하여 명령줄에서 수행할 수도 있습니다.
CLI 소스 코드와 전체 설명서는 source/cli 디렉터리 아래의 솔루션 GitHub 리포지토리에 있습니다. GitHub 웹 사이트의 DLT CLI README
주요 기능
| 명령 그룹 | 설명 |
|---|---|
|
|
대화형으로 또는 |
|
|
DLT 서비스로 인증하고 API를 호출하는 데 필요한 자격 증명을 얻습니다. |
|
|
로컬 시스템에서 저장된 자격 증명을 제거합니다. |
|
|
인증 토큰 및 자격 증명 만료 상태를 검사하고 출력합니다. |
|
|
테스트 시나리오를 생성, 업데이트, 나열, 세부 정보 보기, 시작(다시 실행), 취소 및 삭제합니다. 생성은 간단한 HTTP 테스트, 스크립트 파일 업로드(JMeter, k6, Locust) 및 반복 일정을 지원합니다. |
|
|
테스트 실행 결과 쿼리, 실행 세부 정보 보기, 실행 기록 삭제, 기준 실행 관리(설정, 가져오기 및 지우기), 기준과 실행 비교, 실행 아티팩트 다운로드. |
CLI는 Cognito 호스팅 UI를 통한 코드 교환용 증명 키(PKCE) 흐름을 사용한 브라우저 기반 로그인, 헤드리스 보안 원격 암호(SRP) 인증, 직접 IAM 자격 증명 인증의 세 가지 인증 모드를 지원합니다. 각 모드에 대한 전체 설정 세부 정보는 GitHub 웹 사이트의 DLT CLI README
scenarios start --wait 및 scenarios results 명령은 임계값 플래그(예: 오류율, p95/p99 지연 시간, 처리량 및 기준 회귀)도 지원합니다. 이러한 플래그는 로드 테스트 결과를 CI/CD 파이프라인 게이트 통과/실패로 변환하고 고유한 종료 코드를 사용하여 위반을 알립니다. 데이터 명령은 table, json및 csv 출력 형식을 추가로 지원합니다. 전체 플래그 및 종료 코드 참조는 GitHub 웹 사이트의 DLT CLI README
설치 및 세부 참조
CLI는 직접 실행할 수 있는 이동식 Node.js 번들로 배포되거나 리포지토리를 사용하여 소스에서 빌드할 수 있습니다. 시작하려면 GitHub 웹 사이트에서 다음을 포함하는 DLT CLI README
-
설치 지침(휴대용 번들 및 build-from-source)
-
세 가지 인증 모드 모두에 대한 구성 및 인증 설정
-
사용 예제가 포함된 전체 명령 참조
빠른 시작
참고
이 빠른 시작은 DLT 스택이 이미 배포되었다고 가정합니다.
옵션 1: 휴대용 번들(권장)
가장 빠른 시작 방법은 휴대용 번들입니다. 이렇게 하면 리포지토리 또는 빌드 단계를 복제할 필요가 없습니다.
# Download the portable bundle curl -sLo /usr/local/bin/dlt \ https://raw.githubusercontent.com/aws-solutions/distributed-load-testing-on-aws/main/deployment/cli/dlt-cli.mjs # Make it executable chmod +x /usr/local/bin/dlt # Point the CLI at your deployed DLT stack dlt configure # Authenticate with the DLT service dlt login # Run a command (for example, list test scenarios) dlt scenarios list
옵션 2: 소스에서 빌드
소스에서 빌드하려면 먼저 리포지토리
# Install all workspace dependencies npm install # Build the CLI npm run build -w source/cli # Link the dlt command into your PATH npm link -w source/cli # Point the CLI at your deployed DLT stack dlt configure # Authenticate with the DLT service dlt login # Run a command (for example, list test scenarios) dlt scenarios list
