GitHub App 및 권한
HeyDeer는 개인 계정이나 조직에 설치된 GitHub App을 통해 작동합니다. 설치 범위에 따라 HeyDeer가 읽고 검토할 수 있는 저장소가 정해집니다.
HeyDeer 설치하기
각 워크스페이스는 하나의 GitHub 계정에 속합니다. 워크스페이스를 설정하면 앱을 설치하도록 GitHub로 이동하며, 조직에서는 소유자만 설치할 수 있습니다.
소유자가 아니면 GitHub가 소유자에게 요청을 보냅니다. 요청이 대기 중인 동안 HeyDeer에 “GitHub 소유자의 승인을 기다리는 중”이 표시되며, 관리자는 그동안에도 워크스페이스를 구성할 수 있습니다. 소유자가 승인하면 워크스페이스가 자동으로 연결되고 HeyDeer가 알림 주소로 이메일을 보냅니다. “GitHub 조직 추가”에서 요청했다면 HeyDeer가 해당 조직의 워크스페이스를 만들고 본인을 관리자로 지정합니다.
저장소 선택
Only select repositories를 선택하고 검토할 저장소를 고르세요. All repositories를 선택하면 나중에 생성되는 저장소도 추가됩니다. 선택을 변경하려면 조직 설정 → GitHub 연결을 열고 “GitHub 접근 권한 관리”를 선택하세요. 그곳에서는 해당 계정의 GitHub 소유자만 변경 사항을 저장할 수 있습니다.
추가된 저장소는 조직의 검토 규칙을 따릅니다. 사용자와 설치 모두 GitHub에서 저장소에 접근할 수 있어야 HeyDeer에서 그 사용자에게 저장소와 검토가 표시되며, 검토를 요청하려면 쓰기 권한이 필요합니다. PR 댓글 명령을 참고하세요.
조직이 보이지 않나요? “GitHub 조직 추가”를 선택하세요. SSO를 사용하는 조직이라면 먼저 GitHub에서 SSO로 로그인한 다음 “GitHub 다시 승인”을 선택하세요.
권한
| 권한 | 액세스 수준 | HeyDeer의 사용 목적 |
|---|---|---|
| Contents | 읽기 및 쓰기 | 코드와 기록을 읽습니다. GitHub에서는 검토 스레드를 해결하려면 쓰기 권한이 필요하며, HeyDeer는 이 권한을 자신의 스레드에만 사용합니다. |
| Pull requests | 읽기 및 쓰기 | 풀 리퀘스트를 읽고 검토, 댓글, 답글을 게시합니다. |
| Checks | 읽기 및 쓰기 | HeyDeer Review 검사를 표시하고 검사 버튼 요청을 받습니다. |
| Issues | 읽기 | PR 댓글 명령을 받고 연결된 이슈를 읽습니다. |
| Metadata | 읽기 | 기본 저장소 정보와 쓰기 권한이 있는 사람을 읽습니다. |
| Members(조직) | 읽기 | 워크스페이스 멤버를 나열하고 멤버 및 팀 규칙과 대조합니다. |
| Email addresses(계정) | 읽기 | 인증된 이메일을 알림 주소로 제안합니다. |
설치에서 부여하지 않은 권한이 HeyDeer에 필요하면 조직 설정 → GitHub 연결에 “GitHub 권한 필요”가 표시됩니다. “권한 요청 검토”를 선택하면 소유자가 GitHub에서 요청을 수락할 수 있습니다.