셀프 호스팅 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)
  • 사용자 식별 및 인증
    • 콜백 URL
      • 콜백 URL을 /auth/github 경로를 가진 Bencher Self-Hosted 콘솔 URL로 설정 (예: https://bencher.example.com/auth/github)
    • ✅ 사용자 인증 토큰 만료
    • ✅ 설치 도중 사용자 인증 (OAuth) 요청
    • ✅ 디바이스 흐름 활성화
  • 웹훅
    • ❌ 활성화 - 이 상자의 체크를 해제
  • 권한
    • 계정 권한
      • 이메일 주소: 읽기 전용
  • 이 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이 목록에 없는 로그인을 거부합니다.
    • ✅ 설치 도중 사용자 인증 (OAuth) 요청
  • 웹훅
    • ✅ 활성화 - 이 상자를 체크
    • 웹훅 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에서 문제를 열어주세요.


Published: Fri, October 27, 2023 at 8:40:00 AM UTC | Last Updated: Wed, October 28, 2026 at 5:53:42 AM UTC