Bencher로 벤치마크 결과를 클레임하는 방법
대부분의 벤치마크 결과는 일시적입니다. 터미널의 스크롤백 한도에 도달하면 사라집니다. 일부 벤치마크 하네스는 결과를 캐시할 수 있게 해주지만, 대부분은 로컬에만 저장합니다. 벤처는 로컬 및 CI 실행에서 벤치마크를 추적하고 결과를 비교할 수 있게 해줍니다, 동시에 선호하는 벤치마크 하네스를 사용할 수 있습니다. 벤처에는 로컬 벤치마크 결과를 쉽게 추적할 수 있는 몇 가지 기능이 있으며, 이는 CI에서 벤치마크 추적으로 전환할 때 고려되어야 합니다.
unclaimed 프로젝트
벤처는 계정을 생성하지 않고도 벤치마크 결과를 추적할 수 있게 합니다.
--token 옵션을 설정하지 않고 bencher run CLI 하위 명령어를 호출하면
벤처는 벤치마크 결과를 위한 새로운 unclaimed 즉석 프로젝트를 생성합니다.
빠른 시작 또는 자체 호스팅 빠른 시작 튜토리얼을 따랐다면,
이 기능을 사용한 것입니다.
누구나 unclaimed 프로젝트에 벤치마크 결과를 보고하고 볼 수 있습니다.
unclaimed 프로젝트를 소유하려면 계정을 생성해야 합니다.
bencher run 출력의 끝에 있는 Claim this project 가입 링크를 따라가면 계정이 생성될 때 자동으로 프로젝트를 소유하게 됩니다.
이미 벤처 계정이 있는 경우,
프로젝트의 공개 성능 페이지로 이동하여 페이지 상단의 Claim this project 버튼을 클릭할 수 있습니다.
비슷하게 이미 API 토큰이 있는 경우,
다음번에 bencher run을 호출할 때 the --token 옵션과 함께 API 토큰을 사용하여 프로젝트를 소유할 수 있습니다.
🐰 중요: 프로젝트가
claimed상태가 되면 익명으로 게시할 수 없습니다. API 토큰을 the--token옵션과 함께 반드시 사용해야 합니다.
API 토큰 생성하기
bencher run CLI 하위 명령어를 the --token 옵션과 함께 사용하려면, API 토큰을 생성해야 합니다.
API 토큰 추가를 위해 클릭하세요
단계:
- Bencher 콘솔로 이동하세요.
- 오른쪽 상단에 있는 자신의 이름을 마우스로 가리키세요.
- 드롭다운 메뉴가 나타납니다.
토큰을 선택하세요. - API 토큰 페이지에 도착하면,
➕ Add버튼을 클릭하세요.
온더플라이 프로젝트
Bencher는 claimed와 unclaimed 프로젝트를 온더플라이로 생성할 수 있습니다.
bencher run CLI 서브커맨드를 호출할 때
the --project option을 설정하지 않았거나 지정한 슬러그가 기존 프로젝트와 일치하지 않으면,
Bencher는 벤치마크 결과를 위한 새로운 온더플라이 프로젝트를 생성합니다.
Quick Start 또는 Self-Hosted Quick Start 튜토리얼을 따라했다면,
이 기능을 이용한 것입니다.
the --project option이 지정되지 않은 경우, 온더플라이 프로젝트 슬러그는 다음을 기반으로 생성됩니다:
- 가능하면
git저장소의 상위 디렉터리 이름. - 가능하면
git저장소의 초기 커밋에 대한 7자리 16진수 단축 해시. - 지원되는 운영체제에서 로컬 머신의 13자리 영숫자 지문.
예를 들어, 생성된 온더플라이 프로젝트 슬러그는 다음과 같을 수 있습니다: project-abc4567-wxyz123456789
온더플라이 프로젝트 슬러그에 의존하고 있고 서로 다른 머신에서 벤치마크 결과를 추적하려는 경우,
프로젝트를 지정하기 위해 반드시 **the --project option**을 사용해야 합니다.
그렇지 않으면 머신마다 새로운 온더플라이 프로젝트가 생성될 수 있습니다.
🐰 중요:
CI환경 변수가true로 설정된 경우, [--project옵션][project 옵션]을 사용하여 프로젝트를 지정하거나--ci-on-the-fly플래그를 설정해야 합니다.
🐰 축하합니다! 벤치마크 결과를 클레임하는 방법을 배웠습니다! 🎉