As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# CLI DE PONTOS
<a name="dlt-cli"></a>

A CLI da DLT permite que você interaja com o teste de carga distribuído na API REST da AWS diretamente do seu terminal. Ele permite a automação com script dos testes de carga, permitindo que você liste, inspecione e inicie cenários de teste e consulte os resultados da execução como parte de fluxos de trabalho repetíveis.

A CLI tem como alvo o mesmo IAM-authorized API Gateway do console web DLT, portanto, qualquer operação disponível na interface baseada em navegador também pode ser executada na linha de comando usando a mesma API subjacente e o mesmo modelo de permissões.

O código-fonte da CLI e a documentação completa estão no GitHub repositório da solução sob o diretório. `source/cli` Para encontrá-la, navegue até o [repositório Distributed Load Testing on AWS](https://github.com/aws-solutions/distributed-load-testing-on-aws) e abra`source/cli`. `README.md`Nesse diretório está a referência oficial para instalação, configuração, autenticação e a referência completa do comando.

## Capacidades gerais
<a name="dlt-cli-capabilities"></a>


| Grupo de comandos | Description | 
| --- | --- | 
|  `configure`  | Configure a CLI com as configurações da pilha DLT, de forma interativa ou importando um arquivo. `aws-exports.json` | 
|  `login`  | Autentique-se com o serviço DLT e obtenha as credenciais necessárias para chamar a API. | 
|  `logout`  | Remova as credenciais armazenadas da máquina local. | 
|  `token`  | Inspecione e produza tokens de autenticação e status de expiração da credencial. | 
|  `scenarios`  | Liste, visualize detalhes e inicie (execute novamente) os cenários de teste existentes. | 
|  `runs`  | Consulte os resultados da execução do teste, visualize os detalhes da execução, compare com as linhas de base e baixe os artefatos da execução. | 

A CLI oferece suporte a três modos de autenticação: login baseado em navegador (fluxo PKCE por meio da interface do usuário hospedada do Cognito), autenticação SRP (senha remota segura) sem cabeçalho e autenticação direta por credencial do IAM. Para obter detalhes completos da configuração de cada modo, consulte o `README.md` no `source/cli` diretório do [GitHub repositório](https://github.com/aws-solutions/distributed-load-testing-on-aws).

## Instalação e referência detalhada
<a name="dlt-cli-reference"></a>

A CLI é distribuída como um Node.js pacote portátil que pode ser executado diretamente, ou você pode criá-la a partir da fonte usando o repositório. Para começar, navegue até o [repositório Distributed Load Testing on AWS](https://github.com/aws-solutions/distributed-load-testing-on-aws) GitHub e abra o `source/cli` diretório. O `README.md` arquivo nesse diretório contém:
+ Instruções de instalação (pacote portátil e compilado a partir da fonte)
+ Configuração e configuração de autenticação para todos os três modos de autenticação
+ Referência completa de comandos com exemplos de uso

## Início rápido
<a name="dlt-cli-quick-start"></a>

**nota**  
Esse início rápido pressupõe que a pilha DLT já esteja implantada.

### Opção 1: pacote portátil (recomendado)
<a name="option-1-portable-bundle-recommended"></a>

A maneira mais rápida de começar é o pacote portátil. Isso não requer a clonagem do repositório ou nenhuma etapa de criação:

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

### Opção 2: criar a partir do código-fonte
<a name="option-2-build-from-source"></a>

Se você preferir criar a partir do código-fonte, clone primeiro o [repositório.](https://github.com/aws-solutions/distributed-load-testing-on-aws) O projeto usa espaços de trabalho npm, então execute os seguintes comandos a partir da raiz do repositório:

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