Skip to main content
프라이빗 리포지토리에 접근할 수 있는 것은 해당 리포지토리를 대상에 포함한 Seyval GitHub App 설치(installation) 뿐입니다. GitHub 계정 연결은 이와 별개로, 볼 수 있는 리포지토리를 나열하기 위한 것입니다. 연결만으로는 App이 설치되지 않은 프라이빗 리포지토리에 접근할 수 없습니다.

​
무엇이 필요한가요?

둘 다 Dashboard의 Settings → GitHub Integration(GitHub連携)에서 설정합니다. GitHub 연동 설정

​
Seyval App 설치하기

모든 프라이빗 리포지토리와 push / pull request 웹훅에 필요합니다.
  1. Settings → GitHub Integration에서 Install Seyval App을 클릭합니다.
  2. 리포지토리를 소유한 계정 또는 조직을 선택합니다.
  3. 설치가 대상으로 삼을 리포지토리를 선택합니다. 여기서 제외된 리포지토리는 계정에 App이 설치되어 있어도 Seyval에서 보이지 않습니다.
대상 계정에 App을 설치할 권한이 필요합니다. 본인이 소유하지 않은 조직의 경우 GitHub가 조직 소유자에게 설치 요청을 남기며, 승인된 후에 접근이 시작됩니다. 하나의 설치는 하나의 워크스페이스에만 연결됩니다. 해당 계정의 App이 이미 다른 워크스페이스에 연결되어 있다면 먼저 그쪽에서 연결을 해제하세요. Seyval은 조용히 옮기지 않습니다.

​
GitHub 계정 연결하기

  1. Settings → GitHub Integration에서 Connect GitHub(GitHub連携をする)를 클릭합니다.
  2. GitHub 인증 페이지에서 권한을 확인하고 Authorize를 클릭합니다.
이 연결은 볼 수 있는 리포지토리를 선택 목록에 채우기 위한 것입니다. 토큰은 Seyval GitHub App의 사용자 인증으로 발급되므로 그 범위가 App의 설치 범위를 넘지 않습니다. 연결만으로 프라이빗 리포지토리에 접근할 수 있게 되지는 않습니다.

​
프라이빗 리포지토리 등록 시 “리포지토리를 찾을 수 없습니다”가 나오는 경우

GitHub는 “존재하지 않음”과 “볼 권한이 없음”을 모두 404로 응답하므로 Seyval에서는 구분할 수 없습니다. URL이 올바르다면 원인은 다음 중 하나입니다.
  • 리포지토리를 소유한 계정에 Seyval App이 설치되어 있지 않음
  • 그 설치의 대상 리포지토리에 해당 리포지토리가 포함되어 있지 않음
App을 설치하거나 설치 대상에 리포지토리를 추가한 뒤 다시 등록하세요. GitHub 계정을 연결하거나 다시 연결해도 이 경우는 해결되지 않습니다.

​
다시 연결하기

계정 연결로 발급된 GitHub 액세스 토큰에는 만료가 있습니다. Seyval이 백그라운드에서 자동으로 갱신하므로 평소에는 신경 쓸 필요가 없습니다. 갱신 자체가 불가능해진 경우(GitHub에서 인증을 취소했거나, 갱신 기간이 지나도록 사용되지 않은 경우 등)에는 GitHub Integration 섹션에 要再連携(Re-authentication required)이 표시됩니다. 거기서 재연동하기(Re-connect)를 클릭하면 복구됩니다. 먼저 연결을 해제할 필요는 없습니다. Seyval GitHub App을 통해 접근하는 리포지토리는 영향을 받지 않습니다.