View a markdown version of this page

CLI DLT - Pruebas de carga distribuidas en AWS

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CLI DLT

La CLI de DLT le permite interactuar con la API REST de pruebas de carga distribuidas en AWS directamente desde su terminal. Permite la automatización mediante scripts de las pruebas de carga, lo que le permite enumerar, inspeccionar e iniciar los escenarios de prueba y consultar los resultados de las ejecuciones como parte de flujos de trabajo repetibles.

La CLI se dirige a la misma IAM-authorized API Gateway que la consola web DLT, por lo que cualquier operación disponible en la interfaz basada en el navegador también se puede realizar desde la línea de comandos con la misma API subyacente y el mismo modelo de permisos.

El código fuente de la CLI y la documentación completa se encuentran en el GitHub repositorio de la solución, en el source/cli directorio. Para encontrarlo, navegue hasta el repositorio Distributed Load Testing on AWS y ábralosource/cli. README.mdEn ese directorio se encuentra la referencia autorizada para la instalación, la configuración, la autenticación y la referencia completa de los comandos.

Capacidades clave

Grupo de comandos Description (Descripción)

configure

Configure la CLI con los ajustes de su pila de DLT, ya sea de forma interactiva o importando un aws-exports.json archivo.

login

Autentícate con el servicio DLT y obtén las credenciales necesarias para llamar a la API.

logout

Elimine las credenciales almacenadas de la máquina local.

token

Inspeccione y muestre los tokens de autenticación y el estado de caducidad de las credenciales.

scenarios

Enumere, vea los detalles e inicie (vuelva a ejecutar) los escenarios de prueba existentes.

runs

Consulta los resultados de las pruebas, consulta los detalles de las ejecuciones, compáralos con las bases de referencia y descarga los artefactos de ejecución.

La CLI admite tres modos de autenticación: inicio de sesión basado en navegador (flujo PKCE a través de la interfaz de usuario alojada de Cognito), autenticación SRP (contraseña remota segura) inalámbrica y autenticación directa con credenciales de IAM. Para obtener detalles completos de la configuración de cada modo, consulte en el directorio del repositorio. README.mdsource/cli GitHub

Instalación y referencia detallada

La CLI se distribuye como un Node.js paquete portátil que se puede ejecutar directamente o se puede compilar desde el código fuente mediante el repositorio. Para empezar, vaya al repositorio Distributed Load Testing on AWS GitHub y abra el source/cli directorio. El README.md archivo de ese directorio contiene:

  • Instrucciones de instalación (paquete portátil y compilación a partir del código fuente)

  • Configuración y autenticación para los tres modos de autenticación

  • Referencia completa de comandos con ejemplos de uso

Inicio rápido

nota

Este inicio rápido supone que la pila de DLT ya está desplegada.

La forma más rápida de empezar es con el paquete portátil. Esto no requiere clonar el repositorio ni realizar ningún paso de compilación:

# 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

Opción 2: compilar desde el código fuente

Si prefiere compilar desde el código fuente, primero clone el repositorio. El proyecto usa espacios de trabajo npm, así que ejecuta los siguientes comandos desde la raíz del repositorio:

# 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