本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

DLT CLI 允许您直接从终端与 AWS REST API 上的分布式负载测试进行交互。它支持负载测试的脚本自动化，允许您列出、检查和启动测试场景，并作为可重复工作流程的一部分查询运行结果。

CLI 的目标是与 DLT Web 控制台相同的 IAM-authorized API Gateway，因此基于浏览器的界面中可用的任何操作也可以使用相同的底层 API 和权限模型从命令行执行。

CLI 源代码和完整文档位于解决方案 GitHub 存储库的`source/cli`目录下。要找到它，请导航到 [AWS 存储库上的分布式负载测试](https://github.com/aws-solutions/distributed-load-testing-on-aws)并打开`source/cli`。该目录`README.md`中的是安装、配置、身份验证和完整命令参考的权威参考。

## 关键功能
<a name="dlt-cli-capabilities"></a>


| 命令组 | 说明 | 
| --- | --- | 
|  `configure`  | 使用您的 DLT 堆栈设置以交互方式或通过导入文件来配置 CLI `aws-exports.json`。 | 
|  `login`  | 使用 DLT 服务进行身份验证并获取调用 API 所需的凭据。 | 
|  `logout`  | 从本地计算机中移除存储的凭据。 | 
|  `token`  | 检查并输出身份验证令牌和凭证到期状态。 | 
|  `scenarios`  | 列出、查看详细信息并启动（重新运行）现有的测试场景。 | 
|  `runs`  | 查询测试运行结果、查看运行详细信息、与基准进行比较以及下载运行构件。 | 

CLI 支持三种身份验证模式：基于浏览器的登录（通过 Cognito 托管用户界面的 PKCE 流程）、无头 SRP（安全远程密码）身份验证和直接 IAM 凭证身份验证。有关每种模式的完整设置详细信息，`README.md`请参阅[GitHub 存储库`source/cli`](https://github.com/aws-solutions/distributed-load-testing-on-aws)目录中的。

## 安装和详细参考
<a name="dlt-cli-reference"></a>

CLI 以可移植 Node.js 包的形式分发，可以直接运行，也可以使用存储库从源代码构建。要开始使用，请导航到 [AWS 存储库上的分布式负载测试](https://github.com/aws-solutions/distributed-load-testing-on-aws) GitHub 并打开该`source/cli`目录。该目录中的`README.md`文件包含：
+ 安装说明（便携式捆绑包和源代码构建）
+ 所有三种身份验证模式的配置和身份验证设置
+ 包含用法示例的完整命令参考

## 快速入门
<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
```