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 l'API REST Distributed Load Testing on AWS directement depuis votre terminal. Il permet d'automatiser les tests de charge par script, ce qui vous permet de répertorier, d'inspecter et de démarrer des scénarios de test et d'interroger les résultats des exécutions dans le cadre de flux de travail répétables.
La CLI cible la même passerelle IAM-authorized API que la console Web DLT, de sorte que toute opération disponible dans l'interface basée sur un 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'autorisations.
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. Le fichier README DLT CLI
Principales fonctionnalités
| Groupe de commandes | Description |
|---|---|
|
|
Configurez la CLI avec les paramètres de votre pile DLT, soit de manière interactive, soit en important un |
|
|
Authentifiez-vous auprès du service DLT et obtenez les informations d'identification nécessaires pour appeler l'API. |
|
|
Supprimez les informations d'identification stockées de la machine locale. |
|
|
Inspectez et générez les jetons d'authentification et l'état d'expiration des informations d'identification. |
|
|
Créez, mettez à jour, répertoriez, affichez les détails, démarrez (réexécutez), annulez et supprimez des scénarios de test. Creation prend en charge les tests HTTP simples, les téléchargements de fichiers de script (JMeter, k6, Locust) et les planifications récurrentes. La |
|
|
Interrogez les résultats des tests, affichez les détails des exécutions, supprimez l'historique des exécutions, gérez les exécutions de référence (définir, obtenir et effacer), comparez les séries par rapport à une référence et téléchargez des artefacts d'exécution. |
La CLI prend en charge trois modes d'authentification : la connexion par navigateur à l'aide du flux PKCE (Proof Key for Code Exchange) via l'interface utilisateur hébergée de Cognito ; l'authentification par mot de passe distant sécurisé (SRP) sans tête ; et l'authentification directe par identification IAM. Pour plus de détails sur la configuration de chaque mode, consultez le fichier README de la CLI DLT
Les scenarios results commandes scenarios start --wait et prennent également en charge les indicateurs de seuil (par exemple, taux d'erreur, p95/p99 latence, débit et régression de référence). Ces indicateurs transforment les résultats des tests de charge en vannes de pass/fail CI/CD pipeline et utilisent des codes de sortie distincts pour signaler une brèche. Les commandes de données prennent également en charge les formats tablejson,, et csv de sortie. Pour la référence complète de l'indicateur et du code de sortie, consultez le fichier README de la CLI
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 la créer à partir des sources à l'aide du référentiel. Pour commencer, consultez le fichier README de la CLI DLT
-
Instructions d'installation (ensemble portable et assemblage à partir de la source)
-
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.
Option 1 : forfait portable (recommandé)
Le moyen le plus rapide de démarrer est le forfait portable. Cela ne nécessite pas le clonage du référentiel ni aucune étape de génération :
# 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 : compiler à partir des sources
Si vous préférez compiler à partir des sources, clonez d'abord le
# 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
