GitHub

GitHub 연결

GitHub 계정을 DisHost에 연결하는 방법을 단계별로 설명합니다

GitHub를 연결하면 두 가지 기능을 사용할 수 있습니다:

  1. 레포지토리 목록에서 선택 배포 — URL을 복사할 필요 없이 내 레포 목록에서 클릭 한 번
  2. Push 자동 배포 — 코드 Push만 하면 DisHost가 알아서 재시작

사전 준비

  • DisHost 계정 (Discord 로그인)
  • GitHub 계정
  • 배포할 코드가 있는 GitHub 레포지토리

Step 1 — GitHub 계정 연결

왜 필요한가요? DisHost가 내 GitHub 프로필을 확인하고, 개발자 인증 배지를 표시합니다.

  1. 대시보드 → 왼쪽 사이드바 → "설정"
  2. 상단 "Connect GitHub" 버튼 클릭
  3. GitHub 팝업 창이 열리면 → "Authorize" 클릭
  4. 자동으로 창이 닫히고, 설정 페이지에 내 GitHub 계정이 표시됩니다

연결 성공하면:

@내아이디
✓ Verified

연결 해제: 언제든지 "연결 해제" 버튼으로 GitHub 연결을 끊을 수 있습니다.


Step 2 — GitHub App 설치

왜 필요한가요? DisHost가 내 레포지토리를 읽고, Push 이벤트를 감지할 수 있게 합니다.

  1. 같은 설정 페이지 아래쪽 → "Install GitHub App" 버튼 클릭
  2. GitHub 페이지가 열리면 접근을 허용할 레포지토리 선택
    • 전체 레포: "All repositories"
    • 특정 레포만: "Only select repositories" → 내 봇 레포만 선택
  3. "Install" 클릭

이제 DisHost가 선택한 레포지토리에 접근할 수 있습니다.

보안: GitHub App은 레포지토리 읽기 권한만 요청합니다. 코드를 수정하거나 다른 정보에 접근하지 않습니다.


Step 3 — 레포지토리에서 배포

  1. 대시보드 → "Create Bot"
  2. "Git으로 불러오기" 선택
  3. 레포지토리 목록에서 내 레포 선택
    • 검색창으로 빠르게 찾을 수 있습니다
    • 공개/비공개 레포 모두 표시됩니다
  4. "Push 시 자동 재배포" 체크 (선택)
  5. 언어 선택 → 생성 완료

Step 4 — 자동 배포 설정 (선택)

봇 생성 시 "Push 시 자동 재배포" 체크하면:

내 컴퓨터에서:
git add .
git commit -m "버그 수정"
git push origin main

→ 30초 후 DisHost가 자동으로 새 코드를 배포합니다

동작 방식:

  1. GitHub에 Push
  2. GitHub → DisHost로 Webhook 알림
  3. DisHost 서버에서 git pull로 최신 코드 가져오기
  4. npm install (필요한 경우에만)
  5. 봇 재시작

문제 해결

"redirect_uri is not associated with this application"

GitHub App의 Callback URL이 잘못 설정된 경우입니다. 이 오류는 DisHost 설정 문제이므로 관리자에게 문의하세요.

레포지토리 목록이 안 보여요

  1. GitHub App이 올바르게 설치되었는지 확인: GitHub Applications
  2. 대시보드에서 로그아웃 후 다시 로그인
  3. 그래도 안 되면 설정 페이지에서 GitHub 연결을 해제했다가 다시 연결

비공개 레포는 어떻게 하나요?

GitHub App 설치 시 해당 비공개 레포를 선택하면 됩니다. DisHost는 Installation Token을 통해 안전하게 접근합니다.