View a markdown version of this page

CLI DLT - Tests de charge distribués sur AWS

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CLI DLT

La CLI DLT vous permet d'interagir avec les tests de charge distribués sur l'API REST AWS directement depuis votre terminal. Il permet l'automatisation par script des tests de charge, vous permettant de répertorier, d'inspecter et de démarrer des scénarios de test et d'interroger les résultats d'exécution dans le cadre de flux de travail répétables.

La CLI cible la même IAM-authorized API Gateway que la console Web DLT, de sorte que toute opération disponible dans l'interface basée sur le navigateur peut également être effectuée à partir de la ligne de commande en utilisant la même API sous-jacente et le même modèle d'autorisation.

Le code source de la CLI et la documentation complète se trouvent dans le GitHub référentiel de la solution, sous le source/cli répertoire. Pour le trouver, accédez au référentiel Distributed Load Testing on AWS et ouvrez-lesource/cli. Le README.md contenu de ce répertoire est la référence officielle pour l'installation, la configuration, l'authentification et la référence complète des commandes.

Capacités clés

Groupe de commandes Description

configure

Configurez la CLI avec vos paramètres de pile DLT, soit de manière interactive, soit en important un aws-exports.json fichier.

login

Authentifiez-vous auprès du service DLT et obtenez les informations d'identification nécessaires pour appeler l'API.

logout

Supprimez les informations d'identification stockées sur la machine locale.

token

Inspectez et produisez les jetons d'authentification et le statut d'expiration des informations d'identification.

scenarios

Répertoriez, affichez les détails et lancez (réexécutez) les scénarios de test existants.

runs

Consultez les résultats des tests, affichez les détails de l'exécution, comparez avec les données de référence et téléchargez des artefacts d'exécution.

La CLI prend en charge trois modes d'authentification : connexion par navigateur (flux PKCE via l'interface utilisateur hébergée de Cognito), authentification SRP (Secure Remote Password) sans en-tête et authentification directe par identification IAM. Pour obtenir des informations complètes sur la configuration de chaque mode, consultez le README.md source/cli répertoire du GitHub référentiel.

Installation et référence détaillée

La CLI est distribuée sous la forme d'un Node.js bundle portable qui peut être exécuté directement, ou vous pouvez le créer à partir du code source à l'aide du référentiel. Pour commencer, accédez au référentiel Distributed Load Testing on AWS GitHub et ouvrez le source/cli répertoire. Le README.md fichier de ce répertoire contient :

  • Instructions d'installation (bundle portable et création à partir des sources)

  • Configuration et configuration de l'authentification pour les trois modes d'authentification

  • Référence complète des commandes avec exemples d'utilisation

Démarrage rapide

Note

Ce démarrage rapide suppose que la pile DLT est déjà déployée.

Le moyen le plus rapide de démarrer est le pack portable. Cela ne nécessite pas le clonage du référentiel ni aucune étape de compilation :

# 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 : créer à partir des sources

Si vous préférez créer à partir des sources, clonez d'abord le référentiel. Le projet utilise des espaces de travail npm. Exécutez donc les commandes suivantes depuis la racine du référentiel :

# 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