View a markdown version of this page

DLT CLI - AWS 上的分散式負載測試
關鍵功能安裝和詳細參考快速入門

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

DLT CLI

DLT CLI 可讓您直接從終端機與 AWS REST API 上的分散式負載測試互動。它啟用載入測試的指令碼自動化，可讓您列出、檢查和啟動測試案例，並在可重複的工作流程中查詢執行結果。

CLI 以與 DLT Web 主控台相同的 IAM 授權 API Gateway 為目標，因此瀏覽器型界面中可用的任何操作也可以使用相同的基礎 API 和許可模型從命令列執行。

CLI 原始程式碼和完整文件會在 source/cli目錄下存在於解決方案的 GitHub 儲存庫中。若要尋找它，請導覽至 AWS 儲存庫上的分散式負載測試，然後開啟 source/cli。該目錄中README.md的 是安裝、組態、身分驗證和完整命令參考的授權參考。

關鍵功能

命令群組 說明

configure

以互動方式或匯入 aws-exports.json 檔案，使用 DLT 堆疊設定來設定 CLI。

login

使用 DLT 服務進行驗證，並取得呼叫 API 所需的登入資料。

logout

從本機電腦移除儲存的登入資料。

token

檢查和輸出身分驗證字符和憑證過期狀態。

scenarios

列出、檢視詳細資訊，並開始 （重新執行） 現有的測試案例。

runs

查詢測試執行結果、檢視執行詳細資訊、與基準進行比較，以及下載執行成品。

CLI 支援三種身分驗證模式：瀏覽器型登入 （透過 Cognito 託管 UI 的 PKCE 流程）、無周邊 SRP （安全遠端密碼） 身分驗證，以及直接 IAM 憑證身分驗證。如需每個模式的完整設定詳細資訊，請參閱 GitHub 儲存庫README.mdsource/cli目錄中的 。

安裝和詳細參考

CLI 以可攜式 Node.js 套件的形式分佈，可直接執行，或者您可以使用 儲存庫從來源建置。若要開始使用，請導覽至 GitHub 上的 AWS 儲存庫上的分散式負載測試，然後開啟 source/cli目錄。該目錄中README.md的檔案包含：

  • 安裝指示 （可攜式套件和 build-from-source)

  • 所有三種身分驗證模式的組態和身分驗證設定

  • 使用範例的完整命令參考

快速入門

注意

此快速入門假設已部署 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