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á.
DLT CLI
A DLT CLI permite que você interaja com o teste de carga distribuída na API REST da AWS diretamente do seu terminal. Ele permite a automação por script de 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 reproduzí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 source/cli diretório. O DLT CLI README
Capacidades gerais
| Grupo de comandos | Description |
|---|---|
|
|
Configure a CLI com suas configurações de pilha DLT, de forma interativa ou importando um arquivo. |
|
|
Faça a autenticação com o serviço DLT e obtenha as credenciais necessárias para chamar a API. |
|
|
Remova as credenciais armazenadas da máquina local. |
|
|
Inspecione e emita os tokens de autenticação e o status de expiração da credencial. |
|
|
Crie, atualize, liste, visualize detalhes, inicie (execute novamente), cancele e exclua cenários de teste. A criação suporta testes HTTP simples, uploads de arquivos de script (JMeter, k6, Locust) e agendamentos recorrentes. O |
|
|
Consulte os resultados da execução do teste, visualize os detalhes da execução, exclua o histórico de execuções, gerencie as execuções da linha de base (defina, obtenha e limpe), compare as execuções com uma linha de base e baixe artefatos de execução. |
A CLI oferece suporte a três modos de autenticação: login baseado em navegador usando o fluxo de Proof Key for Code Exchange (PKCE) por meio da interface de usuário hospedada do Cognito; autenticação por senha remota segura (SRP) sem controle e autenticação direta por credencial do IAM. Para obter detalhes completos da configuração de cada modo, consulte o DLT CLI README
Os scenarios results comandos scenarios start --wait and também suportam sinalizadores de limite (por exemplo, taxa de erro, p95/p99 latência, taxa de transferência e regressão de linha de base). Essas bandeiras transformam os resultados do teste de carga em portas de pass/fail CI/CD tubulação e usam códigos de saída distintos para sinalizar uma violação. Os comandos de dados também suportam table formatos csv de saída e. json Para obter a referência completa do sinalizador e do código de saída, consulte o DLT CLI README no site.
Instalação e referência detalhada
A CLI é distribuída como um Node.js pacote portátil que pode ser executado diretamente, ou você pode criá-lo a partir do código-fonte usando o repositório. Para começar, consulte o DLT CLI README
-
Instruções de instalação (pacote portátil e compilado a partir do código-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
nota
Esse início rápido pressupõe que a pilha DLT já esteja implantada.
Opção 1: pacote portátil (recomendado)
A maneira mais rápida de começar é o pacote portátil. Isso não exige a clonagem do repositório nem nenhuma etapa de compilaçã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: compilar a partir do código-fonte
Se você preferir criar a partir do código-fonte, clone primeiro o 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
