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](https://github.com/aws-solutions/distributed-load-testing-on-aws) e apri`source/cli`. `README.md`In 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.md``source/cli` GitHub ](https://github.com/aws-solutions/distributed-load-testing-on-aws)
## 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](https://github.com/aws-solutions/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.
### Opzione 1: pacchetto portatile (consigliato)
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](https://github.com/aws-solutions/distributed-load-testing-on-aws). 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
```