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á. # Teste de lançamento O teste de versão gera e executa planos de teste para validar alterações de código em ambientes realistas. O agente de teste de lançamento executa testes exploratórios de UAT e regressão — regressão funcional, validação da jornada do usuário, teste de integração e exploração de casos extremos — em seus aplicativos web implantados e APIs REST. ## Como funciona o teste de lançamento **Importante** **O teste de lançamento executa solicitações reais em seu aplicativo de destino, incluindo operações de gravação (POST, PUT, DELETE). O agente explora endpoints, envia formulários e testa o tratamento de erros — essas ações podem criar, modificar ou excluir dados no aplicativo de destino. Use somente quando seu perfil de risco puder aceitar ações mutantes como parte do teste exploratório. Garanta que seus aplicativos possam tolerar operações exploratórias de gravação sem consequências indesejadas, como enviar notificações ao cliente, processar pagamentos ou excluir registros permanentemente. Recomendamos executar implementações temporárias; os aplicativos de produção só devem ser direcionados quando as operações de gravação do seu aplicativo estiverem seguras para testes automatizados. Quando acionado, o agente de teste de liberação: 1. **Gera um plano de teste ** — Cria um plano de teste com base em alterações de código ou em uma intenção de teste fornecida pelo usuário. Quando acionado a partir de uma pull request ou ramificação, o plano visa a funcionalidade afetada. Quando acionado manualmente ou a partir do chat, você pode fornecer uma intenção de teste descrevendo o que validar. O plano abrange a correção funcional, o comportamento de integração e os cenários voltados para o usuário. 1. **Executa testes em um aplicativo em execução ** — Com uma URL de destino (aplicativo web ou endpoint da API), o agente explora o aplicativo e executa os testes gerados. Para aplicativos da web, isso inclui interação com a interface do usuário baseada em navegador e inspeção visual. Para APIs, isso inclui teste direto de endpoint HTTP, validação de esquema e verificação de tratamento de erros. 1. **Resultados dos relatórios ** — Os resultados são retornados com falhas específicas, funcionalidade afetada, etapas de reprodução e correções recomendadas. O teste de versão oferece suporte a aplicativos web (React, Angular, Vue, renderizados pelo servidor) e APIs REST. ## Tipos de teste compatíveis + **Teste de interface do usuário ** — Browser-based teste com interações visuais para aplicativos da web + **Teste de API ** — Teste direto de endpoint HTTP para APIs REST ## Definindo perfis de teste Os perfis de teste definem os aplicativos web e de API que você deseja testar e as configurações necessárias. Cada perfil de teste especifica um aplicativo de destino e seu tipo de teste. Para criar um perfil de teste: 1. No aplicativo web DevOps Agent, navegue até ** Release Manager ** na navegação à esquerda. 1. Selecione o ** botão ** Testar perfis. 1. Escolha ** Adicionar perfil de teste**. 1. Preencha o formulário com os seguintes detalhes: + **Nome ** — Um nome descritivo para o perfil de teste (por exemplo, "MyApp Preparação”) + **URL de destino ** — A URL de uma implantação de teste ou teste do seu aplicativo. O agente envia tráfego HTTP real, incluindo operações de gravação (POST, PUT, DELETE). Não use URLs de produção, a menos que você entenda e aceite o risco de modificação de dados. + **Tipo de teste ** — Selecione teste de ** interface do usuário ** (teste baseado em navegador com interações visuais) ou teste de ** API ** (teste direto de endpoint HTTP) 1. Escolha ** Adicionar perfil de teste ** para salvar. **Observação: ** o aplicativo deve estar acessível pela Internet pública. No momento, não há suporte para endpoints de rede privada. ## Executando testes a partir de um perfil de teste Na ** página Perfis de ** teste, você pode acionar manualmente uma execução de teste: 1. Localize seu perfil de teste na lista. 1. Escolha ** Começar a testar**. 1. (Opcional) Especifique instruções específicas e o que testar em Intenção ** ** do teste. Por exemplo, “Verifique se o fluxo de checkout processa cupons expirados corretamente” ou “Teste o formulário de registro do usuário com entradas inválidas”. O agente gerará um plano de teste com base em sua intenção (ou explorará amplamente se nenhuma intenção for fornecida), executará testes e relatará os resultados na ** seção ** Release Manager, sob as alterações propostas. ## Executando testes a partir do bate-papo do DevOps agente No bate-papo do DevOps agente, você pode solicitar o teste de lançamento. Peça ao agente que liste seus perfis de teste ou especifique qual deles executar. O agente solicitará todas as informações de acompanhamento necessárias, como o que testar ou em quais áreas focar. Exemplos: + “Listar meus perfis de teste” + “Executar perfil de teste my-test-profile” + “Execute o teste de lançamento em meu aplicativo em https://staging.myapp.com e verifique o fluxo de pagamento” O agente relata o progresso à medida que explora o aplicativo e retorna resultados com descobertas específicas, capturas de tela (para testes de interface do usuário) e etapas de reprodução. ## Executando testes a partir do seu IDE No Kiro IDE ou no Claude Code, o agente de codificação pode invocar o teste de versão: Primeiro, instale o plugin [ Kiro power ]() ou [ Claude Code. ]() + Especifique um requisito ou intenção de teste descrevendo o que validar (por exemplo, “verificar se o fluxo de login funciona após a refatoração de autenticação”) + O agente de codificação passa a intenção do teste e um perfil de teste alvo para o agente de teste de liberação + O agente de teste de lançamento gera e executa testes e, em seguida, reporta as descobertas + Se os problemas forem descobertos, o agente de codificação se oferece para corrigi-los no local **Observação: No momento, não há suporte para ** testes com base em uma pull request diretamente do IDE. Use um perfil de teste com um URL de aplicativo implantado e forneça um requisito de teste para focar o teste. ## Teste de lançamento em CI/CD tubulações ### GitHub Ações A `aws-actions/devops-agent-release-testing@v1` GitHub Ação aciona o agente de teste de lançamento após a implantação e relata os resultados como um GitHub Check Run em seu commit ou pull request. #### Pré-requisitos + Um perfil [ de teste ](#defining-test-profiles) configurado no seu Agent Space + Um [Invocando o DevOps agente por meio do Webhook](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.md) configurado em seu Agent Space #### Etapa 1: configurar os segredos GitHub do repositório No seu GitHub repositório, vá para ** Configurações → Segredos e variáveis → Ações → Segredos do repositório ** e adicione: | Secret | Description | | --- | --- | | DEVOPS\_AGENT\_WEBHOOK\_URL | O URL do webhook do seu Agent Space | | DEVOPS\_AGENT\_WEBHOOK\_SECRET | O segredo de assinatura do webhook do seu Agent Space | Para obter informações sobre como criar um endpoint de webhook, consulte. [Invocando o DevOps agente por meio do Webhook](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.md) #### Etapa 2: adicione a ação ao seu fluxo de trabalho Adicione a etapa de teste de versão ao seu fluxo de trabalho (por exemplo,`.github/workflows/release-tests.yml`): ``` name: Release Tests on: push: branches: [main] pull_request: branches: [main] permissions: checks: write contents: read pull-requests: read jobs: test: runs-on: ubuntu-latest steps: - name: Trigger Release Tests uses: aws-actions/devops-agent-qa@v1 with: webhook-url: ${{ secrets.DEVOPS_AGENT_WEBHOOK_URL }} webhook-secret: ${{ secrets.DEVOPS_AGENT_WEBHOOK_SECRET }} test-profile-id: test-requirement: # optional env: GITHUB_TOKEN: ${{ github.token }} ``` ``Substitua pelo ID do perfil de teste do seu Agent Space (começa com`ki-`). A `test-requirement` entrada é opcional — use-a para focar o agente em áreas específicas (por exemplo, “verificar o fluxo de login após a refatoração da autenticação”). #### Entradas de ação | Input | Obrigatório | Description | | --- | --- | --- | | URL do webhook | Sim | O URL do webhook do seu Agent Space | | segredo do webhook | Sim | O segredo de assinatura do webhook para HMAC-SHA256 autenticação | | ID do perfil de teste | Sim | O ID do perfil de teste a ser acionado (começa comki-) | | requisito de teste | Não | Área de foco opcional para testes | #### Permissões de fluxo de trabalho necessárias | Permissão | Motivo | | --- | --- | | conteúdo: leia | Obrigatório para actions/checkout repositórios privados | | solicitações pull: leia | Resolver o número PR do SHA de confirmação de mesclagem | #### Como funciona 1. Seu fluxo de trabalho é acionado (por exemplo, após a implantação em um ambiente de teste). 1. A ação cria um Check Run (`in_progress`) no commit ou PR, que aparece como uma verificação pendente. 1. A ação assina e envia um webhook para o seu Agent Space. 1. O agente de teste de versão pega a tarefa e executa testes em seu aplicativo. 1. Os resultados são reportados como um GitHub Check Run (pass/fail com um resumo detalhado). Você pode ver os detalhes completos da execução (cronograma, casos de teste, capturas de tela para testes de interface do usuário) no aplicativo web DevOps Agent vinculado ao seu Agent Space. ## Analisando os resultados do teste Os resultados do teste aparecem na ** seção ** Lançamentos do aplicativo web DevOps Agent sob as alterações propostas. Cada teste executado mostra: + **Status ** — Concluído, com falha ou em andamento + **Categoria ** — Teste de lançamento + **Duração ** — Quanto tempo durou o teste + **Fonte ** — Se foi acionado manualmente, a partir de um chat ou de um CI/CD funil Selecione uma execução de teste para ver resultados detalhados, incluindo falhas de teste específicas, capturas de tela (para testes de interface do usuário), etapas de reprodução e correções recomendadas.