기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# DLT CLI
<a name="dlt-cli"></a>

DLT CLI를 사용하면 터미널에서 직접 AWS REST API의 분산 로드 테스트와 상호 작용할 수 있습니다. 이를 통해 로드 테스트를 스크립트로 자동화할 수 있으므로 반복 가능한 워크플로의 일부로 테스트 시나리오 및 쿼리 실행 결과를 나열, 검사 및 시작할 수 있습니다.

CLI는 DLT 웹 콘솔과 동일한 IAM 인증 API Gateway를 대상으로 하므로 브라우저 기반 인터페이스에서 사용할 수 있는 모든 작업은 동일한 기본 API 및 권한 모델을 사용하여 명령줄에서 수행할 수도 있습니다.

CLI 소스 코드와 전체 설명서는 `source/cli` 디렉터리 아래의 솔루션 GitHub 리포지토리에 있습니다. 이를 찾으려면 [AWS의 분산 로드 테스트 리포지토리](https://github.com/aws-solutions/distributed-load-testing-on-aws)로 이동하여를 엽니다`source/cli`. 해당 디렉터리`README.md`의는 설치, 구성, 인증 및 전체 명령 참조에 대한 신뢰할 수 있는 참조입니다.

## 주요 기능
<a name="dlt-cli-capabilities"></a>


| 명령 그룹 | 설명 | 
| --- | --- | 
|  `configure`  | 대화형으로 또는 `aws-exports.json` 파일을 가져와서 DLT 스택 설정으로 CLI를 구성합니다. | 
|  `login`  | DLT 서비스로 인증하고 API를 호출하는 데 필요한 자격 증명을 얻습니다. | 
|  `logout`  | 로컬 시스템에서 저장된 자격 증명을 제거합니다. | 
|  `token`  | 인증 토큰 및 자격 증명 만료 상태를 검사하고 출력합니다. | 
|  `scenarios`  | 기존 테스트 시나리오를 나열, 세부 정보 보기 및 시작(다시 실행)합니다. | 
|  `runs`  | 테스트 실행 결과를 쿼리하고, 실행 세부 정보를 보고, 기준과 비교하고, 실행 아티팩트를 다운로드합니다. | 

CLI는 브라우저 기반 로그인(Cognito 호스팅 UI를 통한 PKCE 흐름), 헤드리스 SRP(보안 원격 암호) 인증, 직접 IAM 자격 증명 인증의 세 가지 인증 모드를 지원합니다. 각 모드에 대한 전체 설정 세부 정보는 [GitHub 리포지토리](https://github.com/aws-solutions/distributed-load-testing-on-aws)의 `source/cli` 디렉터리`README.md`에 있는를 참조하세요.

## 설치 및 세부 참조
<a name="dlt-cli-reference"></a>

CLI는 직접 실행할 수 있는 이동식 Node.js 번들로 배포되거나 리포지토리를 사용하여 소스에서 빌드할 수 있습니다. 시작하려면 GitHub의 [AWS에서 분산 로드 테스트 리포지토리](https://github.com/aws-solutions/distributed-load-testing-on-aws)로 이동하여 `source/cli` 디렉터리를 엽니다. 해당 디렉터리의 `README.md` 파일에는 다음이 포함됩니다.
+ 설치 지침(휴대용 번들 및 build-from-source)
+ 세 가지 인증 모드 모두에 대한 구성 및 인증 설정
+ 사용 예제가 포함된 전체 명령 참조

## 빠른 시작
<a name="dlt-cli-quick-start"></a>

**참고**  
이 빠른 시작은 DLT 스택이 이미 배포되었다고 가정합니다.

### 옵션 1: 휴대용 번들(권장)
<a name="option-1-portable-bundle-recommended"></a>

가장 빠른 시작 방법은 휴대용 번들입니다. 이렇게 하면 리포지토리 또는 빌드 단계를 복제할 필요가 없습니다.

```
# 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: 소스에서 빌드
<a name="option-2-build-from-source"></a>

소스에서 빌드하려면 먼저 [리포지토리](https://github.com/aws-solutions/distributed-load-testing-on-aws)를 복제합니다. 프로젝트는 npm 워크스페이스를 사용하므로 리포지토리 루트에서 다음 명령을 실행합니다.

```
# 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
```