View a markdown version of this page

DLT-CLI - Verteilte Lasttests auf AWS

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

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 und öffnen Sie essource/cli. README.mdIn diesem Verzeichnis befindet sich die maßgebliche Referenz für Installation, Konfiguration, Authentifizierung und die vollständige Befehlsreferenz.

Die wichtigsten Funktionen

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

Installation und ausführliche Referenz

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

Anmerkung

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

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

Wenn Sie es vorziehen, aus dem Quellcode zu bauen, klonen Sie zuerst das Repository. 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