View a markdown version of this page

CLI DLT - Test di carico distribuito su AWS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

CLI DLT

La CLI DLT ti consente di interagire con l'API REST di Distributed Load Testing on AWS direttamente dal tuo terminale. Consente l'automazione tramite script dei test di carico, consentendoti di elencare, ispezionare e avviare scenari di test e interrogare i risultati delle esecuzioni come parte di flussi di lavoro ripetibili.

La CLI si rivolge allo stesso IAM-authorized API Gateway della console web DLT, quindi qualsiasi operazione disponibile nell'interfaccia basata su browser può essere eseguita anche dalla riga di comando utilizzando la stessa API e lo stesso modello di autorizzazioni sottostanti.

Il codice sorgente della CLI e la documentazione completa si trovano nel GitHub repository della soluzione all'interno della directory. source/cli Per trovarlo, vai al repository Distributed Load Testing on AWS e aprisource/cli. README.mdIn quella directory si trova il riferimento autorevole per l'installazione, la configurazione, l'autenticazione e il riferimento completo ai comandi.

Funzionalità chiave

Gruppo di comandi Description

configure

Configura la CLI con le impostazioni dello stack DLT, in modo interattivo o importando un file. aws-exports.json

login

Effettua l'autenticazione con il servizio DLT e ottieni le credenziali necessarie per chiamare l'API.

logout

Rimuovi le credenziali archiviate dal computer locale.

token

Ispeziona e mostra i token di autenticazione e lo stato di scadenza delle credenziali.

scenarios

Elenca, visualizza i dettagli e avvia (riesegui) gli scenari di test esistenti.

runs

Interroga i risultati dell'esecuzione dei test, visualizza i dettagli dell'esecuzione, confrontali con le linee di base e scarica gli elementi di esecuzione.

La CLI supporta tre modalità di autenticazione: accesso basato su browser (flusso PKCE tramite l'interfaccia utente ospitata di Cognito), autenticazione SRP (Secure Remote Password) headless e autenticazione diretta delle credenziali IAM. Per i dettagli completi sulla configurazione di ciascuna modalità, consulta la cartella nella directory del repository. README.mdsource/cli GitHub

Installazione e riferimento dettagliato

La CLI è distribuita come Node.js pacchetto portatile che può essere eseguito direttamente oppure è possibile crearla dal codice sorgente utilizzando il repository. Per iniziare, vai al repository Distributed Load Testing on AWS GitHub e apri la source/cli directory. Il README.md file in quella directory contiene:

  • Istruzioni di installazione (pacchetto portatile e build-from-source)

  • Configurazione e configurazione dell'autenticazione per tutte e tre le modalità di autenticazione

  • Riferimento completo ai comandi con esempi di utilizzo

Avvio rapido

Nota

Questo avvio rapido presuppone che lo stack DLT sia già distribuito.

Il modo più veloce per iniziare è il pacchetto portatile. Ciò non richiede la clonazione del repository o alcuna procedura di compilazione:

# 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

Opzione 2: crea dal codice sorgente

Se preferisci creare dal codice sorgente, clona prima il repository. Il progetto utilizza npm workspaces, quindi esegui i seguenti comandi dalla radice del repository:

# 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