Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# DLT-CLI
<a name="dlt-cli"></a>

Mit der DLT-CLI können Sie direkt von Ihrem Terminal aus mit der Distributed Load Testing on AWS-REST-API interagieren. Sie ermöglicht die skriptgesteuerte Automatisierung von Lasttests, sodass Sie Testszenarien auflisten, überprüfen und starten sowie Ausführungsergebnisse als Teil wiederholbarer Workflows abfragen können.

Die CLI zielt auf dasselbe IAM-authorized API Gateway ab wie die DLT-Webkonsole, sodass alle in der browserbasierten Oberfläche verfügbaren Operationen auch von der Befehlszeile aus mit derselben zugrunde liegenden API und demselben Berechtigungsmodell ausgeführt werden können.

Der CLI-Quellcode und die vollständige Dokumentation befinden sich im GitHub Repository der Lösung unter dem `source/cli` Verzeichnis. Um es zu finden, navigieren Sie zum [Repository Distributed Load Testing on AWS](https://github.com/aws-solutions/distributed-load-testing-on-aws) und öffnen Sie es`source/cli`. `README.md`In diesem Verzeichnis befindet sich die maßgebliche Referenz für Installation, Konfiguration, Authentifizierung und die vollständige Befehlsreferenz.

## Die wichtigsten Funktionen
<a name="dlt-cli-capabilities"></a>


| Befehls-Gruppe | Description | 
| --- | --- | 
|  `configure`  | Konfigurieren Sie die CLI mit Ihren DLT-Stack-Einstellungen, entweder interaktiv oder durch Importieren einer `aws-exports.json` Datei. | 
|  `login`  | Authentifizieren Sie sich beim DLT-Dienst und holen Sie sich die Anmeldeinformationen, die zum Aufrufen der API erforderlich sind. | 
|  `logout`  | Entfernen Sie die gespeicherten Anmeldeinformationen vom lokalen Computer. | 
|  `token`  | Überprüfen Sie die Authentifizierungstoken und den Ablaufstatus der Anmeldeinformationen und geben Sie sie aus. | 
|  `scenarios`  | Bestehende Testszenarien auflisten, Details anzeigen und bestehende Testszenarien starten (erneut ausführen). | 
|  `runs`  | Fragen Sie Testlaufergebnisse ab, zeigen Sie Ausführungsdetails an, vergleichen Sie sie mit Baselines und laden Sie Ausführungsartefakte herunter. | 

Die CLI unterstützt drei Authentifizierungsmodi: browserbasierte Anmeldung (PKCE-Flow über die Cognito Hosted UI), Headless-SRP-Authentifizierung (Secure Remote Password) und direkte Authentifizierung mit IAM-Anmeldeinformationen. [Vollständige Einrichtungsdetails zu den einzelnen Modi finden Sie im Verzeichnis des `README.md` Repositorys. `source/cli` GitHub ](https://github.com/aws-solutions/distributed-load-testing-on-aws)

## Installation und ausführliche Referenz
<a name="dlt-cli-reference"></a>

Die CLI wird als portables Node.js Paket vertrieben, das direkt ausgeführt werden kann, oder Sie können sie mithilfe des Repositorys aus dem Quellcode erstellen. Rufen Sie zunächst das [Repository Distributed Load Testing on AWS](https://github.com/aws-solutions/distributed-load-testing-on-aws) auf GitHub und öffnen Sie das `source/cli` Verzeichnis. Die `README.md` Datei in diesem Verzeichnis enthält:
+ Installationsanweisungen (portables Paket und Build-from-source)
+ Konfiguration und Authentifizierungseinrichtung für alle drei Authentifizierungsmodi
+ Vollständige Befehlsreferenz mit Anwendungsbeispielen

## Schnellstart
<a name="dlt-cli-quick-start"></a>

**Anmerkung**  
Bei diesem Schnellstart wird davon ausgegangen, dass der DLT-Stack bereits bereitgestellt ist.

### Option 1: Tragbares Paket (empfohlen)
<a name="option-1-portable-bundle-recommended"></a>

Der schnellste Weg, um loszulegen, ist das portable Bundle. Dies erfordert weder das Klonen des Repositorys noch irgendwelche Build-Schritte:

```
# 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
```

### Option 2: Aus dem Quellcode erstellen
<a name="option-2-build-from-source"></a>

Wenn Sie es vorziehen, aus dem Quellcode zu bauen, klonen Sie zuerst das [Repository](https://github.com/aws-solutions/distributed-load-testing-on-aws). Das Projekt verwendet NPM-Workspaces. Führen Sie daher die folgenden Befehle im Stammverzeichnis des Repositorys aus:

```
# 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
```