View a markdown version of this page

Tests de lancement - AWS DevOps Agent

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Tests de lancement

Les tests de version génèrent et exécutent des plans de test pour valider les modifications de code dans des environnements réalistes. L'agent de test de version exécute des tests exploratoires UAT et de régression (régression fonctionnelle, validation du parcours utilisateur, tests d'intégration et exploration de cas extrêmes) sur vos applications Web et API REST déployées.

Comment fonctionnent les tests de version

Important

Les tests de version exécutent des requêtes réelles sur votre application cible, y compris des opérations d'écriture (POST, PUT, DELETE). L'agent explore les terminaux, soumet des formulaires et teste la gestion des erreurs. Ces actions peuvent créer, modifier ou supprimer des données dans l'application cible. À utiliser uniquement lorsque votre profil de risque peut accepter des actions mutantes dans le cadre des tests exploratoires. Assurez-vous que vos applications peuvent tolérer les opérations d'écriture exploratoire sans conséquences imprévues, telles que l'envoi de notifications aux clients, le traitement des paiements ou la suppression définitive d'enregistrements. Nous vous recommandons de procéder à des déploiements intermédiaires ; les applications de production ne doivent être ciblées que lorsque les opérations d'écriture de votre application sont sécurisées pour les tests automatisés.

Lorsqu'il est déclenché, l'agent de test de version :

  1. Génère un plan de test  : crée un plan de test en fonction des modifications de code ou d'une intention de test fournie par l'utilisateur. Lorsqu'il est déclenché à partir d'une pull request ou d'une branche, le plan cible les fonctionnalités concernées. En cas de déclenchement manuel ou depuis le chat, vous pouvez fournir une intention de test décrivant les éléments à valider. Le plan couvre l'exactitude fonctionnelle, le comportement d'intégration et les scénarios destinés à l'utilisateur.

  2. Exécute des tests sur une application en cours d'exécution  : à partir d'une URL cible (application Web ou point de terminaison d'API), l'agent explore l'application et exécute les tests générés. Pour les applications Web, cela inclut l'interaction avec l'interface utilisateur via le navigateur et l'inspection visuelle. Pour les API, cela inclut le test direct des points de terminaison HTTP, la validation des schémas et la vérification de la gestion des erreurs.

  3. Résultats des rapports  : les résultats sont renvoyés avec les défaillances spécifiques, les fonctionnalités affectées, les étapes de reproduction et les correctifs recommandés.

Les tests de version prennent en charge les applications Web (React, Angular, Vue, rendu par le serveur) et les API REST.

Types de tests pris en charge

  • Tests d'interface utilisateur  : Browser-based tests avec interactions visuelles pour les applications Web

  • Tests d'API — Tests directs des points de terminaison HTTP pour les API REST

Définition de profils de test

Les profils de test définissent les applications Web et API que vous souhaitez tester ainsi que les configurations nécessaires. Chaque profil de test spécifie une application cible et son type de test.

Pour créer un profil de test :

  1. Dans l'application Web DevOps Agent, accédez à Release Manager dans la barre de navigation de gauche.

  2. Sélectionnez le bouton Profils de test.

  3. Choisissez Ajouter un profil de test.

  4. Remplissez le formulaire avec les informations suivantes :

    • Nom  : nom descriptif du profil de test (par exemple, « MyApp  Staging »)

    • URL cible  : URL d'un déploiement intermédiaire ou de test de votre application. L'agent envoie un trafic HTTP réel, y compris des opérations d'écriture (POST, PUT, DELETE). N'utilisez pas d'URL de production à moins de comprendre et d'accepter le risque de modification des données.

    • Type de test  : sélectionnez soit un test d'interface utilisateur (test basé sur un navigateur avec interactions visuelles) soit un test d'API (test direct des points de terminaison HTTP)

  5. Choisissez Ajouter un profil de test pour enregistrer.

Exécution de tests à partir d'un profil de test

Sur la page Profils de test, vous pouvez déclencher manuellement un test :

  1. Localisez votre profil de test dans la liste.

  2. Choisissez Commencer les tests.

  3. (Facultatif) Spécifiez des instructions spécifiques et les éléments à tester dans l'intention du test. Par exemple, « Vérifiez que le flux de paiement gère correctement les coupons expirés » ou « Testez le formulaire d'inscription de l'utilisateur avec des entrées non valides ».

L'agent générera un plan de test en fonction de votre intention (ou explorera de manière générale si aucune intention n'est fournie), exécutera des tests et rapportera les résultats dans la section Release Manager sous les modifications proposées.

Exécution de tests depuis le chat de DevOps l'agent

Depuis le chat de DevOps l'agent, vous pouvez demander des tests de version. Demandez à l'agent de répertorier vos profils de test ou de spécifier lequel exécuter. L'agent vous demandera toutes les informations de suivi nécessaires, telles que les tests à effectuer ou les domaines sur lesquels vous concentrer.

Exemples :

  • « Répertorier mes profils de test »

  • « Exécuter le profil de test my-test-profile »

  • « Effectuez des tests de version sur mon application à l'https://staging.myapp.comadresse et vérifiez le flux de paiement »

L'agent rend compte des progrès réalisés lors de l'exploration de l'application et renvoie les résultats avec des résultats spécifiques, des captures d'écran (pour les tests de l'interface utilisateur) et des étapes de reproduction.

Exécution de tests depuis votre IDE

Depuis Kiro IDE ou Claude Code, l'agent de codage peut invoquer des tests de version :

Tout d'abord, installez le plugin Kiro power ou Claude Code.

  • Spécifiez une exigence ou une intention de test décrivant les éléments à valider (par exemple, « vérifiez que le flux de connexion fonctionne après le refactor d'authentification »)

  • L'agent de codage transmet l'intention du test et un profil de test cible à l'agent de test de libération

  • L'agent de test des versions génère et exécute des tests, puis rapporte les résultats

  • Si des problèmes sont découverts, l'agent de codage propose de les résoudre sur place

Tests de rejet dans les CI/CD pipelines

GitHub Actions

L'aws-actions/devops-agent-release-testing@v1 GitHub action déclenche l'agent de test de version après le déploiement et rapporte les résultats sous forme de GitHub Check Run sur votre demande de validation ou d'extraction.

Conditions préalables

Étape 1 : Configuration des secrets GitHub du référentiel

Dans votre GitHub dépôt, allez dans Paramètres → Secrets et variables → Actions → Secrets du référentiel et ajoutez :

Secret Description
URL_WEBHOOK_AGENT_DEVOPS_AGENT_WEBHOOK L'URL du webhook depuis votre espace agent
DEVOPS_AGENT_WEBHOOK_SECRET Le secret de signature du webhook depuis votre espace agent

Pour plus d'informations sur la création d'un point de terminaison Webhook, consultezInvoquer un DevOps agent via Webhook.

Étape 2 : ajoutez l'action à votre flux de travail

Ajoutez l'étape de test de version à votre flux de travail (par exemple,.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: <YOUR_TEST_PROFILE_ID> test-requirement: <WHAT_TO_TEST> # optional env: GITHUB_TOKEN: ${{ github.token }}

<YOUR_TEST_PROFILE_ID>Remplacez-le par l'identifiant du profil de test de votre espace agent (commence parki-). La test-requirement saisie est facultative. Utilisez-la pour concentrer l'agent sur des domaines spécifiques (par exemple, « vérifier le flux de connexion après le refactor d'authentification »).

Entrées d'action

Input Obligatoire Description
URL du webhook Oui L'URL du webhook depuis votre espace agent
secret du webhook Oui Le secret de signature du webhook pour l'authentification HMAC-SHA256
identifiant du profil de test Oui L'identifiant du profil de test à déclencher (commence parki-)
exigence de test Non Domaine d'intervention optionnel pour les tests

Autorisations de flux de travail requises

Autorisation Raison
contenu : lire Obligatoire pour actions/checkout les dépôts privés
pull-requests : lire Résoudre le numéro PR à partir du commit de fusion SHA

Comment ça marche

  1. Vos déclencheurs de flux de travail (par exemple, après le déploiement dans un environnement de test).

  2. L'action crée un Check Run (in_progress) sur le commit ou le PR, qui apparaît comme une vérification en attente.

  3. L'action signe et envoie un webhook à votre espace agent.

  4. L'agent de test des versions prend en charge la tâche et exécute des tests sur votre application.

  5. Les résultats sont reportés sous la forme d'un GitHub Check Run (pass/fail avec un résumé détaillé).

Vous pouvez consulter tous les détails d'exécution (chronologie, scénarios de test, captures d'écran des tests d'interface utilisateur) dans l'application Web DevOps Agent liée à votre espace agent.

Révision des résultats des tests

Les résultats des tests apparaissent dans la section Versions de l'application Web DevOps Agent sous les modifications proposées. Chaque essai montre :

  • État  : terminé, en échec ou en cours

  • Catégorie — Tests de publication

  • Durée — Combien de temps a duré le test

  • Source  : s'il a été déclenché manuellement, depuis le chat ou depuis un CI/CD pipeline

Sélectionnez un test pour afficher les résultats détaillés, y compris les échecs de tests spécifiques, les captures d'écran (pour les tests d'interface utilisateur), les étapes de reproduction et les correctifs recommandés.