Comment Revendiquer les Résultats des Benchmarks avec Bencher
La plupart des résultats de benchmark sont éphémères. Ils disparaissent dès que votre terminal atteint sa limite de défilement en arrière. Certains outils de benchmark vous permettent de mettre en cache les résultats, mais la plupart ne le font que localement. Bencher vous permet de suivre vos benchmarks à la fois depuis les exécutions locales et celles sur CI, et de comparer les résultats, tout en utilisant votre outil de benchmark préféré. Bencher possède quelques fonctionnalités qui facilitent le suivi de vos résultats de benchmark locaux, ce qui doit être pris en compte lors de la transition pour suivre les benchmarks dans CI.
Projets unclaimed
Bencher vous permet de suivre les résultats des benchmarks sans créer de compte. Lorsque vous invoquez la sous-commande CLI bencher run sans définir l’option --token, Bencher créera un projet unclaimed à la volée pour vos résultats de benchmark. Si vous avez suivi les tutoriels Démarrage rapide ou Démarrage rapide auto-hébergé, vous avez profité de cette fonctionnalité.
Tout le monde peut voir et publier des résultats de benchmarks dans un projet unclaimed. Pour réclamer un projet unclaimed, vous devrez créer un compte. Si vous suivez le lien d’inscription Claim this project à la fin de votre sortie bencher run, vous réclamerez automatiquement le projet lorsque votre compte sera créé.
Si vous avez déjà un compte Bencher, vous pouvez naviguer vers la page Perf publique du projet et cliquer sur le bouton Claim this project en haut de la page. De même, si vous avez déjà un jeton API, vous pouvez utiliser le jeton API avec l’option --token la prochaine fois que vous invoquez bencher run pour réclamer le projet.
🐰 IMPORTANT : Une fois qu’un projet est
claimed, il ne peut pas être posté anonymement. > Vous devez utiliser un jeton API avec l’option--token.
Projets à la Volée
Bencher vous permet de créer des Projets claimed et unclaimed à la volée. Lorsque vous invoquez la sous-commande CLI bencher run sans définir l’option --project ou si le slug spécifié ne correspond pas à un Projet existant, Bencher créera un nouveau Projet à la volée pour vos résultats de benchmark. Si vous avez suivi les tutoriels Démarrage Rapide ou Démarrage Rapide en Auto-Hébergement, vous avez profité de cette fonctionnalité.
Si l’option --project n’est pas spécifiée, alors un slug de Projet à la volée sera généré pour vous basé sur :
- Le nom du répertoire parent pour le dépôt
git, s’il est disponible. - Le hash court hexadécimal de 7 chiffres pour le commit initial du dépôt
git, s’il est disponible. - Une empreinte alphanumérique de 13 chiffres de la machine locale, pour les systèmes d’exploitation pris en charge.
Par exemple, un slug de Projet généré à la volée pourrait ressembler à : project-abc4567-wxyz123456789
🐰 IMPORTANT : Si vous vous appuyez sur un slug de Projet à la volée et que vous souhaitez suivre les résultats de benchmark sur différentes machines, vous devez utiliser l’option
--projectpour spécifier le slug du Projet. Sinon, un nouveau Projet à la volée peut être créé pour chaque machine différente.
🐰 Félicitations ! Vous avez appris comment revendiquer vos résultats de benchmark ! 🎉