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](https://github.com/aws-solutions/distributed-load-testing-on-aws) y ábralo`source/cli`. `README.md`En 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.md``source/cli` GitHub ](https://github.com/aws-solutions/distributed-load-testing-on-aws)
## 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](https://github.com/aws-solutions/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.
### Opción 1: paquete portátil (recomendado)
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](https://github.com/aws-solutions/distributed-load-testing-on-aws). 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
```