本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
DLT CLI
DLT CLI 允许您直接从终端与 AWS REST API 上的分布式负载测试进行交互。它支持负载测试的脚本自动化,允许您列出、检查和启动测试场景,并作为可重复工作流程的一部分查询运行结果。
CLI 的目标是与 DLT Web 控制台相同的 IAM-authorized API Gateway,因此基于浏览器的界面中可用的任何操作也可以使用相同的底层 API 和权限模型从命令行执行。
CLI 源代码和完整文档位于解决方案 GitHub 存储库的source/cli目录下。要找到它,请导航到 AWS 存储库上的分布式负载测试source/cli。该目录README.md中的是安装、配置、身份验证和完整命令参考的权威参考。
关键功能
| 命令组 | 说明 |
|---|---|
|
|
使用您的 DLT 堆栈设置以交互方式或通过导入文件来配置 CLI |
|
|
使用 DLT 服务进行身份验证并获取调用 API 所需的凭据。 |
|
|
从本地计算机中移除存储的凭据。 |
|
|
检查并输出身份验证令牌和凭证到期状态。 |
|
|
列出、查看详细信息并启动(重新运行)现有的测试场景。 |
|
|
查询测试运行结果、查看运行详细信息、与基准进行比较以及下载运行构件。 |
CLI 支持三种身份验证模式:基于浏览器的登录(通过 Cognito 托管用户界面的 PKCE 流程)、无头 SRP(安全远程密码)身份验证和直接 IAM 凭证身份验证。有关每种模式的完整设置详细信息,README.md请参阅GitHub 存储库source/cli
安装和详细参考
CLI 以可移植 Node.js 包的形式分发,可以直接运行,也可以使用存储库从源代码构建。要开始使用,请导航到 AWS 存储库上的分布式负载测试source/cli目录。该目录中的README.md文件包含:
-
安装说明(便携式捆绑包和源代码构建)
-
所有三种身份验证模式的配置和身份验证设置
-
包含用法示例的完整命令参考
快速入门
注意
本快速入门假设 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