Tests de pull request
Exécutez Autonomy sur les déploiements de prévisualisation et publiez un commentaire de preuves avec check run dans GitHub.
Les tests de pull request exécutent Autonomy avant la fusion du code. Lorsqu'un déploiement de prévisualisation est prêt, Autonomy exécute le cas de test sélectionné sur cette URL de prévisualisation et écrit le résultat dans GitHub sous forme d'un seul commentaire avec des liens de preuves, accompagné d'un check run.
L'objectif n'est pas de remplacer chaque vérification CI. Utilisez les exécutions de pull request pour les parcours produit que les relecteurs veulent valider mais ne peuvent pas vérifier à partir des seuls journaux de build : inscription, paiement, onboarding, changements de paramètres, autorisations, reçus et transferts d'intégration.
Deux modes de déclenchement
| Déclenchement | Quand l'utiliser |
|---|---|
Un commentaire — @autonomy test the checkout flow against the preview | Un relecteur souhaite une exécution à la demande, ou veut varier la cible ou les cas de test. Voir Application GitHub. |
| Votre pipeline — une étape de workflow appelant l'API Autonomy après la découverte de l'URL de prévisualisation | L'exécution doit se produire à chaque push sans intervention humaine. Voir GitHub Actions. |
Les deux produisent les mêmes preuves et rendent compte via le même commentaire et check run.
Prérequis
Avant d'activer les exécutions de PR
- Installez l'application GitHub Autonomy pour le dépôt.
- Choisissez le cas de test ou le plan de test à exécuter sur les pull requests.
- Rendez l'URL du déploiement de prévisualisation disponible pour Autonomy.
- Exécutez le cas de test une fois manuellement avant de traiter le résultat comme bloquant pour la fusion.
Configuration
- Connectez le dépôt dans Autonomy.
- Installez ou confirmez l'installation de l'application GitHub.
- Connectez le fournisseur de déploiement ou exposez l'URL de prévisualisation depuis la CI.
- Définissez la cible par défaut du dépôt — un cas de test ou un plan de test — sous Settings → Integrations → GitHub Auto-Trigger Defaults, afin qu'une commande simple ait quelque chose à exécuter.
- Ouvrez une pull request, commentez
@autonomy test this PR against the previewet vérifiez qu'un seul commentaire Autonomy apparaît avec le statut de l'exécution et le lien des preuves.
Fonctionnement
- Une pull request est ouverte ou mise à jour.
- Votre fournisseur de déploiement crée un environnement de prévisualisation.
- Autonomy reçoit ou se voit fournir l'URL de prévisualisation, ou la résout depuis la pull request.
- Le cas de test ou le plan de test sélectionné s'exécute sur cette URL.
- Autonomy publie un seul commentaire GitHub avec le statut, les preuves et les détails d'échec les plus significatifs, ainsi qu'un check run nommé
Autonomy QA: …. - Lors des pushes suivants, le commentaire existant est mis à jour au lieu de créer un nouveau fil.
L'ouverture d'une pull request ne déclenche pas d'exécution en soi. Une exécution commence lorsqu'un commentaire est posté ou lorsque votre pipeline appelle l'API.
Prévisualisations protégées
Si les déploiements de prévisualisation sont protégés, stockez le jeton de contournement ou le mot de passe de prévisualisation dans le coffre de secrets du fournisseur. Ne placez pas de valeurs de contournement dans les cas de test, les docs MDX ou les commentaires de pull request.
Dépannage
Aucun commentaire n'apparaît
Vérifiez que l'application GitHub est installée pour le dépôt, que l'auteur du commentaire est propriétaire, membre ou collaborateur, que l'URL de prévisualisation était disponible, que le secret de clé API est présent et que le cas de test peut s'exécuter manuellement sur la même URL.
L'exécution cible la production
Déplacez l'étape Autonomy après la découverte de l'URL de prévisualisation et confirmez que l'URL transmise à Autonomy est l'URL de déploiement de la pull request, et non le domaine de production par défaut. Dans un commentaire, un url: ou env: explicite l'emporte toujours sur tout réglage inférieur.
La prévisualisation affiche un mur d'authentification
Ajoutez le jeton de contournement spécifique au fournisseur ou le mot de passe de prévisualisation à l'environnement utilisé par l'exécution, puis réessayez la même pull request.
Le check est rouge mais le produit fonctionne
Une conclusion neutral signifie que la commande a été rejetée — non analysable, ambiguë ou non autorisée — et non que l'exécution a échoué. Seuls failure et timed_out reflètent un vrai résultat d'exécution.