View a markdown version of this page

DLT CLI - AWS 上的分布式负载测试

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

DLT CLI

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

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

CLI 源代码和完整文档位于解决方案 GitHub 存储库的source/cli目录下。要找到它,请导航到 AWS 存储库上的分布式负载测试并打开source/cli。该目录README.md中的是安装、配置、身份验证和完整命令参考的权威参考。

关键功能

命令组 说明

configure

使用您的 DLT 堆栈设置以交互方式或通过导入文件来配置 CLI aws-exports.json

login

使用 DLT 服务进行身份验证并获取调用 API 所需的凭据。

logout

从本地计算机中移除存储的凭据。

token

检查并输出身份验证令牌和凭证到期状态。

scenarios

列出、查看详细信息并启动(重新运行)现有的测试场景。

runs

查询测试运行结果、查看运行详细信息、与基准进行比较以及下载运行构件。

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

安装和详细参考

CLI 以可移植 Node.js 包的形式分发,可以直接运行,也可以使用存储库从源代码构建。要开始使用,请导航到 AWS 存储库上的分布式负载测试 GitHub 并打开该source/cli目录。该目录中的README.md文件包含:

  • 安装说明(便携式捆绑包和源代码构建)

  • 所有三种身份验证模式的配置和身份验证设置

  • 包含用法示例的完整命令参考

快速入门

注意

本快速入门假设 DLT 堆栈已部署。

最快的入门方法是便携式捆绑包。这不需要克隆存储库或任何构建步骤:

# 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:从源代码构建

如果您更喜欢从源代码构建,请先克隆存储库。该项目使用 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