셀프 호스팅 GitHub 앱 생성 방법
Bencher Cloud를 사용하고 있다면, 단순히 GitHub 버튼을 통해 가입 또는 로그인하면 됩니다.
Bencher Self-Hosted를 사용하려면 Bencher Plus Enterprise 요금제가 필요하고, 자체 GitHub 앱을 생성하고 콘솔 구성과 API 서버 구성을 업데이트해야 합니다.
GitHub 앱 생성
- GitHub 앱 생성
- GitHub 앱 이름
- 고유한 이름 선택 (예:
My Enterprise용 Bencher)
- 고유한 이름 선택 (예:
- 홈페이지 URL
- 이를 Bencher Self-Hosted 콘솔 URL로 설정 (예:
https://bencher.example.com)
- 이를 Bencher Self-Hosted 콘솔 URL로 설정 (예:
- 사용자 식별 및 인증
- 콜백 URL
- 콜백 URL을
/auth/github경로를 가진 Bencher Self-Hosted 콘솔 URL로 설정 (예:https://bencher.example.com/auth/github)
- 콜백 URL을
- ✅ 사용자 인증 토큰 만료
- ✅ 설치 도중 사용자 인증 (OAuth) 요청
- ✅ 디바이스 흐름 활성화
- 콜백 URL
- 웹훅
- ❌ 활성화 - 이 상자의 체크를 해제
- 권한
- 계정 권한
- 이메일 주소:
읽기 전용
- 이메일 주소:
- 계정 권한
- 이 GitHub 앱을 어디에 설치할 수 있는가?
- 🔘 모든 계정
GitHub 앱 생성클릭- 이제 새로 생성된 앱의
일반으로 가기 Client ID를 기재해 두세요 (예:Iv1.12864abcd1232048)- 클라이언트 비밀 유지
새 클라이언트 비밀 생성클릭- 이 비밀을 기재해 두세요 (예:
00000abcd12345wxyz123456789abcdefgh0000)
- Bencher 로고 PNG를 디스플레이 정보 아래에 추가
- 비공개 키
비공개 키 생성클릭
GitHub 앱 구성
콘솔 UI
bencher-console Docker 이미지를 실행할 때 GITHUB_CLIENT_ID 환경 변수를 설정합니다. (예: GITHUB_CLIENT_ID=Iv1.12864abcd1232048) 만약 클라이언트 ID가 누락되면, UI에 GitHub 버튼이 표시되지 않습니다.
API 서버
client_id와 client_secret를 서버 구성의 plus.github 섹션에 추가합니다. 만약 GitHub 섹션이 누락되면, 서버는 GitHub 인증 요청을 실패시킵니다.
연결된 저장소
이 설정을 변경하기 전에 Bencher Self-Hosted API 서버와 콘솔을 v0.6.16 이상으로 업그레이드하세요.
프로젝트가 분리된 실행을 위해 GitHub 저장소를 연결할 수 있게 하려면 GitHub 앱에 다음도 설정합니다.
- 사용자 식별 및 인증
- 콜백 URL
- 첫 번째 콜백 URL을
/console/github경로를 가진 Bencher Self-Hosted 콘솔 URL로 설정 (예:https://bencher.example.com/console/github). GitHub는 앱을 설치한 사용자를 첫 번째 콜백 URL로 보냅니다. - 그 뒤에 로그인을 위한
/auth/github경로의 콜백 URL을 유지 (예:https://bencher.example.com/auth/github). GitHub는 콜백 URL이 목록에 없는 로그인을 거부합니다.
- 첫 번째 콜백 URL을
- ✅ 설치 도중 사용자 인증 (OAuth) 요청
- 콜백 URL
- 웹훅
- ✅ 활성화 - 이 상자를 체크
- 웹훅 URL
/v0/github/webhook경로를 가진 Bencher Self-Hosted API 서버 URL로 설정 (예:https://api.bencher.example.com/v0/github/webhook)
- 웹훅 시크릿
- 임의의 시크릿을 입력하고 기재해 두세요 (예:
0123456789abcdef0123456789abcdef)
- 임의의 시크릿을 입력하고 기재해 두세요 (예:
- 권한
- 저장소 권한
- 콘텐츠:
읽기 및 쓰기
- 콘텐츠:
- 이벤트 구독
- 모든 이벤트를 체크하지 않은 상태로 두기
- 저장소 권한
- 앱의 슬러그, 즉 공개 페이지 URL의 마지막 부분을 기재해 두세요 (예:
https://github.com/apps/my-bencher-app의my-bencher-app)
슬러그, 비공개 키, 웹훅 시크릿을 서버 구성의 plus.github 섹션에 app으로 추가합니다.
🐰 축하합니다! GitHub 앱을 설정하는 방법을 배웠습니다! 🎉
Bencher를 GitHub Actions에 추가하기 ➡
🤖 이 문서는 AI에 의해 자동으로 번역되었습니다. 정확하지 않을 수도 있고 오류가 있을 수도 있습니다. 오류를 발견하면 GitHub에서 문제를 열어주세요.