View a markdown version of this page

CLI DE PONTOS - Teste de carga distribuído na AWS

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 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 e abrasource/cli. README.mdNesse diretório está a referência oficial para instalação, configuração, autenticação e a referência completa do comando.

Capacidades gerais

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.

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á-la a partir da fonte usando o repositório. Para começar, navegue até o repositório 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

nota

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

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

Se você preferir criar a partir do código-fonte, clone primeiro o repositório. 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