Vercel

L'intégration Vercel surveille vos déploiements Vercel. Quand un déploiement est prêt, Autonomy exécute un cas de test ou un plan de test d'un projet sur son URL et publie le résultat sous forme de check sur le déploiement. Si le dépôt est également associé, le même résultat apparaît comme check GitHub sur le commit.

Ce qu'elle fait

• Lance des exécutions quand un déploiement Vercel est prêt, filtrées par type de déploiement (prévisualisation, production, branche) et par branche.
• Teste l'URL propre au déploiement, dans un environnement du projet que vous avez choisi.
• Publie un check de déploiement Vercel nommé Autonomy QA, et peut retenir la promotion en production jusqu'à sa conclusion.
• Lance une nouvelle exécution quand quelqu'un clique sur Re-run sur le check dans Vercel.

Configuration

1. Ouvrez Organization → Integrations → Vercel et cliquez sur Connect. Vercel vous demande de choisir une équipe ou un compte et d'approuver les autorisations demandées, y compris les checks de déploiement.
2. Cliquez sur Link project et choisissez le projet Vercel à tester. Sa définition de check est créée pour vous.
3. Sous Project, choisissez le projet Autonomy dont ces déploiements exécutent les tests. Le modifier par la suite efface les valeurs par défaut ci-dessous.
4. Sous Default test case or plan, choisissez ce qui s'exécute sur chaque déploiement. Seuls les cas de test et plans de test du projet sont proposés.
5. Sous Default environment, choisissez l'environnement du projet. Les exécutions utilisent ses valeurs et ses connexions, avec l'URL du déploiement comme cible web. Sans environnement, les déploiements sont ignorés.
6. Sous Trigger on, choisissez les types de déploiement qui lancent une exécution, généralement Preview. Ajoutez des Branch filters comme main ou release/* pour les limiter à certaines branches.
7. Activez Post a Vercel deployment check. Activez Block deployment promotion until check completes si un check en échec doit retenir la promotion.
8. Poussez un commit et vérifiez qu'une exécution démarre quand la prévisualisation est prête.

Comment une exécution démarre

Quand un déploiement est prêt, Autonomy :

1. Retrouve le projet Vercel associé et son projet Autonomy. Rien ne s'exécute si ce projet est archivé.
2. Compare le type de déploiement à Trigger on et la branche aux Branch filters.
3. Lance le cas de test ou le plan de test par défaut dans l'environnement par défaut, sur l'URL du déploiement.

Chaque déploiement s'exécute une seule fois. Un webhook que Vercel envoie deux fois ne lance pas de deuxième exécution.

Le check

Le check s'appelle Autonomy QA et affiche un lien vers chaque exécution. Il se conclut ainsi :

Une exécution échouée fait échouer le check de déploiement, que son résultat attendu n'ait pas été atteint ou que l'agent n'ait pas pu montrer qu'il l'a été. Le résumé en donne la raison.

Faire échouer le check en cas de problème

Les problèmes ne modifient jamais le résultat d'une exécution : une exécution réussie fait donc passer le check même si elle a signalé un problème. Pour que les bugs fassent aussi échouer le check de déploiement, activez Fail the check on issues dans Settings → Integrations → Pull requests du projet. L'option est désactivée par défaut. Une fois activée, un Bug ouvert qu'une des exécutions du check a trouvé ou rouvert fait passer le check à failed : « Failed: a bug was found ». Les risques, ainsi que les bugs que vous avez résolus ou ignorés, ne comptent pas. Voir Tests de pull request.

Bloquer la promotion

Avec Block deployment promotion until check completes activé, Vercel ne promeut pas le déploiement en production tant que le check n'est pas conclu. Le check expire au bout de 15 minutes. Une exécution peut encore se terminer dans Autonomy après ce délai, mais le check Vercel ne change plus.

Relancer

Cliquer sur Re-run sur le check dans Vercel lance de nouvelles exécutions sur le même déploiement, avec les paramètres actuels de l'association.

Prévisualisations protégées

Si Vercel Deployment Protection est activé, le runner ne peut pas ouvrir la prévisualisation sans contournement :

1. Dans Vercel, ouvrez Settings → Deployment Protection du projet et copiez le secret Protection Bypass for Automation.
2. Dans Autonomy, ouvrez le projet Vercel associé et collez-le dans Preview access secret.

Autonomy l'envoie avec chaque requête vers les prévisualisations de ce projet. Il est stocké comme secret et n'est plus jamais affiché.

Plusieurs projets Vercel

Associez chaque projet Vercel séparément. Chaque association a son propre projet Autonomy, son plan de test, son environnement, ses types de déclenchement et ses filtres de branche : un monorepo comprenant une application web, une documentation et un panneau d'administration peut ainsi exécuter un plan différent pour chacun.

Dépannage

Aucune exécution ne démarre au déploiement d'une prévisualisation

Ouvrez le projet Vercel associé dans Autonomy et consultez les déploiements récents. Un déploiement ignoré en indique la raison :

• project disabled : l'association est désactivée.
• context <x> not enabled : le type de déploiement ne figure pas dans Trigger on.
• branch <x> filtered : la branche ne correspond pas aux Branch filters.
• no default test target : choisissez un Default test case or plan.
• « Choose an environment for this deploy link in Autonomy. » : choisissez un Default environment.
• project archived, ou une valeur par défaut archivée ou appartenant à un autre projet : restaurez le projet ou choisissez de nouvelles valeurs par défaut.
• no preview URL : Vercel n'a envoyé aucune URL pour le déploiement.

Vérifiez aussi que Vercel apparaît comme Active dans Autonomy.

L'exécution n'atteint pas la prévisualisation

Deployment Protection la bloque. Ajoutez ou renouvelez le Preview access secret.

Le check a échoué alors que toutes les exécutions ont réussi

Fail the check on issues est activé, et une exécution a trouvé un bug. Ouvrez la section Issues found de l'exécution.

Le check affiche neutral

Une exécution n'a pas pu démarrer, par exemple parce que la prévisualisation ne s'est pas ouverte ou a bloqué le navigateur de test comme un robot. Ouvrez l'exécution pour en connaître la raison, corrigez-la, puis cliquez sur Re-run dans Vercel.